8.云表 MCP 配置与使用指南(以 WorkBuddy 为例)

本手册以 WorkBuddy 为例，说明如何接入 Yunbiao MCP。支持 MCP HTTP 的其他 Agent 客户端也可以使用同一套服务配置，只是入口名称和界面位置可能不同。

配置前请注意：示例中的地址、应用名、密钥和账号都需要替换。真实 appKey 只填写到受控的客户端配置中，不要发到普通对话、群聊或代码仓库。图片仅为界面示意，工具列表及错误信息以当前服务返回为准；绿色连接状态不代表云表认证成功。  

1. 配置

1.1 配置前先确认

1.1.1客户端

本手册以 WorkBuddy V5.4.7 为例。其他支持 MCP HTTP 的 Agent 客户端也可以使用相同的服务地址和 Header 配置。
1.1.2  MCP 服务地址
本文档预设为 https://mcp.iyunbiao.cn/mcp。这是工具服务入口，不是云表业务地址；实际地址不同时，请修改配置中的 url。  
1.1.3 云表业务地址
使用已分配的云表地址，例如 http://your-yunbiao.example:88/10001；末段 10001 是云表应用空间 ID，不是第三方应用的 appName。提问时通常无需重复填写。  
1.1.4 访问模式
edit-form,readonly-design：允许表单数据编辑，允许读取模板设计，不允许编辑模板设计。

1.2 在云表系统中的设置

1.2.1 新增用户

在配置MCP之前，建议在云表中单独使用一个用户进行管理，后续AI用户拥有的权限就是该用户的权限
图1：新增用户

1.2.2 新增角色

同样，也建议单独另起一个角色进行权限的管控
图2：绑定角色
说明：本文档中不说明如何设置角色权限，请自行管控该角色的权限

1.2.3 新增第三方应用授权

在云表中打开第三方应用授权，系统路径：【系统管理】->【系统服务】->【第三方应用授权】
点击【新建】，系统自动生成appName与appKey，在【默认绑定账号】中填写刚刚设置的用户
图3：第三方应用授权
注意：以上步骤为在云表系统中的设置，其中，第三方应用授权这一步，不论用哪种agent进行配置都不可缺少，用户与角色的设置是为了后续的权限管控，也可使用已有账号进行绑定

1.3 在 WorkBuddy 中配置MCP

打开 WorkBuddy 左侧的“专家·技能·连接器”，
选择“连接器”页签，点击右上角的“自定义连接器”
弹出窗口后，点击“添加MCP”
下面是配置模板，不是可直接登录的真实配置。复制后，在客户端配置界面或本地受控配置文件中替换占位符，再保存。服务名称 yunbiao 可以保留。
入口请求头统一使用小写 x-eversheet-* 名称，请直接按下面的最新配置填写。
注：如需在配置文件中进行配置，则WorkBuddy 的配置文件通常位于 C:\Users\Administrator\.workbuddy\mcp.json。实际用户名可能不同，也可以直接在“配置 MCP”窗口编辑。

1.3.1 直接复制的JSON

{ "mcpServers": { "yunbiao": { "type": "http", "url": "https://mcp.iyunbiao.cn/mcp", "headers": { "x-eversheet-url": "http://your-yunbiao.example:88/10001", "x-eversheet-application-name": "YOUR_APPLICATION_NAME", "x-eversheet-application-key": "YOUR_APPLICATION_KEY", "x-eversheet-username": "YOUR_BOUND_ACCOUNT", "x-eversheet-access-mode": "edit-form,readonly-design" }, "disabled": false } } }
以上代码块中的JSON请直接粘贴至workbuddy的配置MCP窗口中，以下为占位符说明，注意文本双引号需保留，仅替换内容即可：
  1. JSON段中的："x-eversheet-url": "http://your-yunbiao.example:88/10001"，将http://your-yunbiao.example:88/10001此占位符地址修改为云表真实的系统地址
  2. JSON段中的："x-eversheet-application-name": "YOUR_APPLICATION_NAME"，将YOUR_APPLICATION_NAME此占位符修改为在1.2.3步骤中真实的appName
  3. JSON段中的："x-eversheet-application-key": "YOUR_APPLICATION_KEY"，将YOUR_APPLICATION_KEY此占位符修改为在1.2.3步骤中真实的appKey
  4. JSON段中的："x-eversheet-username": "YOUR_BOUND_ACCOUNT"，将YOUR_BOUND_ACCOUNT此占位符替换为1.2.3步骤中所绑定的账号
图 4：在“配置 MCP”窗口粘贴 JSON。

1.3.2 直接复制的配置草案

该步骤为需要 WorkBuddy 帮忙时，只让它生成配置草案，若已完成1.3.1中的配置，则无需进行这一步
可以提供本手册和下面的示例要求，让 WorkBuddy 说明配置方法。不要把真实密钥粘贴进对话；密钥由你在客户端配置中填写。
请阅读这份云表 MCP 配置指导，生成 WorkBuddy 配置草案，不要直接覆盖已有配置。 MCP 服务地址：https://mcp.iyunbiao.cn/mcp 访问模式：edit-form,readonly-design App-Name：YOUR_APPLICATION_NAME App-Key：保留 YOUR_APPLICATION_KEY 占位符，真实密钥由我在客户端配置中填写 云表服务地址：http://your-yunbiao.example:88/10001 默认绑定账号：YOUR_BOUND_ACCOUNT 请使用 x-eversheet-* 请求头，说明需要我替换哪些占位符，不要猜测或向我索取真实密钥。填写、保存并重新连接后，再通过只读业务查询验证云表连接；生成草案不等于配置已生效。
将应用名、密钥、云表业务地址和默认绑定账号替换为同一应用空间、同一条第三方应用授权记录对应的信息。YOUR_APPLICATION_KEY 必须在本地替换，不通过普通对话收集。
保存或修改配置后，请重新连接该 MCP 服务；必要时重启客户端，确保连接和工具列表都使用新配置。

1.4 配置项说明

说明：这一步仅为配置项说明，供查看使用，无需动手进行配置

1.4.1 配置项说明

配置项示例值作用
mcpServers.yunbiaoyunbiaoWorkBuddy 中显示的服务名称。改名只影响显示，不改变服务能力。
typehttp表示通过 HTTP 连接远程 MCP 服务。
urlhttps://mcp.iyunbiao.cn/mcpMCP 服务入口。通过以 /mcp 结尾的 HTTP(S) 地址打开本页时采用该入口；从本地文件或其他页面路径打开时使用文档预设地址，不把 HTML 文件名当作接口地址。
x-eversheet-urlhttp://your-yunbiao.example:88/10001必填，目标云表业务地址。末段 10001 是应用空间 ID；第三方应用授权应来自该空间。
x-eversheet-application-nameYOUR_APPLICATION_NAME必填，在目标空间“系统服务 → 第三方应用授权”中取得的 appName，不是空间 ID。
x-eversheet-application-keyYOUR_APPLICATION_KEY必填，与 appName 来自同一条授权记录的 appKey。只在受控的客户端配置中填写，不放进普通对话。
x-eversheet-usernameYOUR_BOUND_ACCOUNT必填，必须与该授权记录的“默认绑定账号”所对应的登录账号一致，不填显示姓名。当前使用无密码绑定登录，不另填密码。
x-eversheet-access-modeedit-form,readonly-design组合访问模式：允许编辑表单数据、读取模板设计；不包含 edit-design。
disabledfalse启用该 MCP 服务。若设为 true，WorkBuddy 不会调用它。

1.4.2 获取appName 和 appKey 

登录云表后，进入系统服务 → 第三方应用授权，点击“新建”，创建一条第三方应用授权记录。保存后，从该记录中取得 appName 和 appKey，分别填写到 x-eversheet-application-name 和 x-eversheet-application-key。  
默认绑定账号说明：填写云表的系统账号
建议给第三方应用授权单独添加一个账号与角色，方便后续对MCP的权限管控，
注意：改用户的权限决定了MCP能够获得的权限
不建议直接给admin账号，如需超管可另外建立账号并赋予超管角色即可，最好为单独配置模板权限，若改账号角色为administrator，则MCP可访问整个系统。
图 5：在云表“系统服务 → 第三方应用授权”中创建并查看第三方应用。
截图中的应用名称、应用类型、默认绑定账号和应用描述属于第三方应用授权记录的字段。appKey 是敏感密钥，只填写到 MCP 客户端配置中，不要发送到普通对话、群聊或代码仓库。
请先确认授权记录中的默认绑定账号已正确设置，再将对应登录账号填写到 x-eversheet-username。登录被拒绝时要同时核对空间、应用名、密钥和绑定账号，不能仅凭“appName 不可用”就认定只需修改应用名。

1.4.3 其他 Agent 客户端怎么配置

其他支持远程 MCP 且允许设置请求 Header 的客户端，可以使用相同的服务地址和 Header 取值，但配置文件格式、密钥保存方式和交互支持可能不同。请按对应客户端的方式设置，不要将 WorkBuddy JSON 当作所有客户端通用格式；实际兼容性需单独验证。

1.4.4 访问模式怎么理解

访问模式允许的功能当前参考工具数
readonly-form查询业务表单，准备填写候选和公式计算；不提供表单保存或模板设计读取。13
edit-form包含表单读取，并允许已支持的表单保存、状态按钮和流程操作；不包含模板设计读取。16
readonly-design包含表单读取，以及模板设计读取、编辑草稿准备、检查和引用关系查询；不保存业务表单或设计。25
edit-form,readonly-design组合以上表单编辑与设计读取能力，仍不开放设计正式保存。28
默认模式：不传 x-eversheet-access-mode 时采用服务端部署默认值；程序默认是 readonly-form，但管理员可以调整。显式传入模式时不叠加部署默认能力。
预留模式：edit-design 当前不授予任何表单或设计能力。单独传入时，当前只显示 3 个公共工具，不会自动回退为 readonly-form；与其他模式组合也不会增加设计保存权限。

1.4.5 注意事项

（1）工具数为 2026-10-30 当前源码的参考值，含公共工具，升级后可能变化；实际以展开后的工具列表为准，不能用数量判断云表认证是否成功。组合值用英文逗号分隔。  
（2）工具可见不等于有业务操作权限，实际调用仍检查云表账号及模板范围。客户端在连接、获取工具列表和调用时均应发送所配置的 Header；修改任一配置后，请重新连接，必要时重启客户端并重新获取工具列表。

1.5 保存后检查是否连接成功

1.5.1 替换占位符，保存并重新连接
填写真实配置后重新连接该 MCP 服务；若仍使用旧配置，重启客户端再检查。
1.5.2 确认 MCP 服务可响应
绿色状态和可展开的工具列表，只说明客户端能够连接 MCP，不代表云表登录或业务权限已经通过验证。
图 6：连接成功后查看服务状态和已启用工具。
1.5.3 展开工具列表，核对所选访问模式
查询工具如 yunbiao_form_query、yunbiao_form_get；配置了 edit-form 才会提供 yunbiao_form_save 等编辑工具。
1.5.4 执行一次真实的只读业务查询。
例如：“查询当前云表空间可用的业务模板，再查询一个实际存在模板的表单列表；只查询，不修改。”应确认工具实际调用云表并成功返回；正常空列表不等于连接失败。
图7：进行真实的只读业务查询
注意：查询工具列表、yunbiao_service_capabilities 及应用空间信息工具不验证云表登录，不能代替第 4 步。若业务查询返回认证或权限错误，请按第八节排查；不要通过试建表单来验证连接。

1.6 简单使用示例

连接成功后，直接在 WorkBuddy 对话框用自然语言描述目标即可。建议第一次先做查询，再做测试数据修改。

1.6.1查询对话示例

下面的模板名和单号都是示例。请替换为当前云表环境中实际存在的模板名称和单据编号；如果不确定，先让 WorkBuddy 查询可用模板和表单列表。
（1）查询实际业务模板
查询当前云表空间可用的业务模板，再读取其中一个实际存在的表单模板对应的表单数据项结构；如果没有可用模板，明确说明查询是否成功及是否返回空列表。只查询，不修改数据。
（2）查询表单数据
查询一个已有业务模板（例如“测试报价单”）的表单列表，列出单号、客户名称、联系方式、审核情况和版本号
（3）查看一张具体单据
查看示例模板中一张已有单据的完整内容，包括明细表、当前状态按钮和流程进度；请先使用当前环境实际存在的模板名称和单号
查询完成后，WorkBuddy 左侧对话会返回文字结论，右侧可以生成表单清单页面。清单通常会展示总数、审核统计、金额汇总、客户数、分页状态和明细表格。
图 8：查询结果和需要用户选择后继续的操作。

1.6.2 修改测试数据

创建或修改表单时，一次提供完整业务信息；支持的新建初始化、值变化和保存前填表公式由MCP服务内部计算后统一保存，无需逐字段执行公式。例如模板配置了“总分=语文+数学+英语”，直接提供姓名和三科成绩即可。遇到缺项或公式选源时按提示回答；出现不支持的公式操作时应停止本次操作，不要拆成多次保存绕过
示例：在测试环境中，把当前环境已有模板的一张测试单据中的“数值2”修改为 222，保存后读回核对版本和字段值；模板名称和单号请替换为实际值
建议：涉及写入、状态按钮或流程操作时，明确写出“测试环境”和单号；让 WorkBuddy 返回读回结果后再确认是否成功。
新建表单时：如果字段是候选字段，WorkBuddy 会先让你选择真实候选；提交后会返回服务端自动生成的单号、初始化字段和读回核验结果。
图 9：新建表单先选择候选，提交后返回自动编号和初始化字段。

1.7 多轮选择和流程操作

当操作需要选择客户、填写意见、选择审批结果或确认抄送人时，WorkBuddy 可能弹出选项面板。候选面板会展示编号、候选名称和“其他补充”等入口；选择后工具会自动继续后续调用。
图 10：查询表单后执行流程审批，左侧返回执行结果，右侧保留表单清单。
图 11：状态按钮执行结果会返回动作、状态变化、版本变化和读回核验。
候选选择：例如新建报价单时选择客户。优先选择系统返回的真实候选，不要凭空输入不存在的候选。
审批意见：流程审批需要选择“通过”“不通过”等结果；如果需要意见，按提示填写后继续。
取消操作：点击取消或明确回复取消，当前轮次不会继续提交写入。
重复提交：如果界面长时间等待，不要连续点击提交；先查看上一轮结果，避免重复执行。

1.8 常见问题

现象处理方法
保存配置时报 JSON 错误检查是否完整复制；JSON 中只能使用英文双引号，最后一项后不要多写逗号。
服务显示红点或连接失败确认电脑能访问当前页面对应的 MCP 地址，并确认 WorkBuddy 不是在无法访问该内网地址的网络环境中运行。
提示云表接口异常查看工具返回的异常码和业务原因；没有具体原因时保留请求 ID 供管理员排查。若提示“写入结果未知”，请先查询单据核实，避免重复保存或审批。
连接成功但缺少保存或设计读取工具检查配置中的访问模式，确认客户端获取工具列表时也发送了该 Header；修改后刷新工具列表或重新连接。模板和账号权限在实际调用时检查，不决定工具列表数量。
提示只读或无权修改先确认请求的是表单数据修改而不是模板设计修改；再确认模板字段可写、账号有权限、服务端允许该模板编辑。
审批按钮不可用查询该单据的流程进度和当前用户待办；流程未到当前用户、没有待办或已处理时不能重复审批。
多轮窗口没有继续查看是否已选择选项或填写必需意见；取消后需要重新发起完整请求。
MCP 显示已连接，但业务查询失败绿点只证明 MCP 可连接。核对云表业务地址、目标空间、第三方应用授权和默认绑定账号，再查看实际业务查询的错误信息。
提示 appName 不可用核对应用名是否正确、授权是否来自当前空间，并确认 x-eversheet-username 与该记录默认绑定账号的登录账号一致；不能仅凭这一提示断定哪个字段错误。
修改配置后仍出现旧结果或旧工具列表重新连接 MCP，必要时重启客户端；确认其连接、工具发现和调用都使用新的 Header。
appKey 进入普通对话或公开渠道请管理员重置或更换云表授权密钥，更新所有相关客户端配置并重新连接；不要只删除已发送的信息。

返回码怎么排查

先区分 MCP 返回码与云表原始异常码。若工具返回 details.upstream，可查看其中的 code 和 message；数字码的含义及可用字段以当前云表版本和实际消息为准，不要只凭一个数字判断唯一原因。
返回码或提示含义与排查方向
missing_header缺少必填连接 Header。检查云表地址、应用名、应用密钥和绑定账号四项，以及客户端是否实际发送这些配置。
invalid_header_value请求头取值格式无效，例如地址格式或访问模式填写不正确。根据返回的 Header 名称检查，不要提交完整密钥用于排错。
authentication_failed云表登录失败或认证已失效。核对目标空间、同一条授权记录的 appName 与 appKey，以及默认绑定账号，并结合原始异常消息排查。
app_scope_mismatch工具参数中的 appId 或 appRegistrationId 与请求头云表 URL 末段空间 ID 不一致；例如 URL 为 /10001 时，工具不能填其他空间 ID。这不是 appName 归属错误的专用码。
access_mode_denied / access_template_denied当前模式不允许操作，或编辑目标不在服务端允许范围内。核对模式、重新连接，并联系管理员确认可编辑模板范围；不要新建模板替代。
access_mode_not_supported请求了当前未开放的能力，例如设计保存。增加 edit-design 不会解锁，不能靠更换调用方式绕过。
write_result_unknown写入已经尝试，但最终结果未确认。按原操作的恢复指引只读核实，不重复保存、审批或新建替代。
385344云表提示“appName 不可用”。先核对空间及应用授权信息，并检查默认绑定账号；该码不能单独证明就是 username 错误。
385345云表提示签名验证不匹配。检查 appName 和 appKey 是否来自同一条授权记录、密钥是否完整，以及是否已更换但客户端未更新。
385343云表提示请求时间超出服务器接受范围。请管理员核对 MCP 服务机器和云表服务器的时间；签名时间由 MCP 服务产生，不是只调整用户电脑时间。
990005（部分环境）仅当当前返回消息明确提示 OpenAPI 未开通时，联系管理员确认该应用空间的开通状态；若消息不同，应按实际响应排查，不将该码作为跨版本固定定义。
联系管理员时提供工具名称、错误码、安全错误消息和请求 ID 即可，不要发送 appKey、Token、Cookie 或包含它们的配置截图。

1.9 推荐的首次验证顺序

  1. 在本地填写真实配置，保存并重新连接 MCP；必要时重启客户端。
  2. 检查服务状态和工具列表，仅用于确认 MCP 可响应以及访问模式已加载。
  3. 查询实际业务模板目录，再查询一个已有模板的表单列表。确认云表业务调用成功；正常空结果不等于认证失败。
  4. 需要查看模板设计时，先确认已配置 readonly-design，再读取实际存在的表单模板；只读表单模式无需执行这一步。
  5. 需要编辑时，先确认已配置 edit-form 且有业务权限，再只在明确的测试单据上修改，并要求“保存后读回核对”。
  6. 需要测试流程时，先查看目标表单当前的流程按钮；仅执行用户明确要求、当前支持且有权限的操作。

2.功能与使用指南

完成配置后，了解每个工具的作用、当前支持范围，以及如何结合 Skill 按照业务要求使用云表。

2.1 支持的功能

通过自然语言提出要求，由 AI 选择工具查询或操作云表。你不需要记住工具名称。

2.1.1 支持列表

  1. 查找：查找业务模板。查找表单定义、流程定义、统计定义、报表定义，查看目录路径、类型及权限提示。
  2. 查询：查询已有数据。查询表单、统计或报表模板的总表数据，按条件筛选、排序和分页，读取业务表单详情。
  3. 填写：填写和修改表单。在已有模板下新建业务表单，修改基本数据项和明细，并在保存后确认结果。
  4. 辅助：使用填写规范与公式。查询填写候选，选择后自动填写相关数据，处理当前支持的自动填表公式及来源数据选择。
  5. 处理：执行状态与流程操作。读取当前可用按钮及流程进度，执行已支持的状态按钮、流程启动、审批、完成等操作。
  6. 查看：查看设计和引用关系。读取表单模板与数据接口定义，准备和检查模板修改内容，查询模板直接引用关系。

2.1.2 注意事项

（1）表单保存与模板设计保存的支持范围不同。当前可以填写和保存业务表单；表单模板设计可以读取、准备修改、检查及查看差异，但暂未开放正式保存。
（2）实际可见工具由当前 MCP 访问模式决定；能否操作还受云表账号权限和允许编辑的模板范围限制。本指南不是对所有模板、公式或客户端都兼容的承诺。

2.2 每个工具的作用

以下按用途整理工具。名称便于与 AI 客户端中的工具列表对照；标为“暂未开放”的工具仅说明用途，不表示当前可以调用。
参数要点供 AI 调用和排查时参考，日常使用仍只需自然语言。appId 与 appRegistrationId 在本服务中都表示当前 URL 末段的空间 ID，但必须使用对应工具要求的参数名，不能随意互换。formId 在模板设计和业务表单工具中含义不同。  

2.2.1 常用参数示例

（1）读取已有表单模板设计：空间 ID 加实际模板名称；也可将名称换为已查到的模板定义 formId。需要设计读取模式。  
{ "appId": "10001", "templateName": "采购订单" }
（2） 查询业务表单：分页参数放入 page，第 1 页的 pageIndex 为 0；不要把 pageSize 放在顶层。
{ "appId": "10001", "templateName": "采购订单", "page": { "pageSize": 20, "pageIndex": 0 } }
以上模板名称和空间 ID 均需替换为当前实际对象；完整参数格式及条件仍以当前工具定义和前置读取结果为准。

2.2.2 工具列表

确认当前连接的空间，了解 MCP 服务本身提供的能力。
（1）应用空间与服务信息
yunbiao_app_list查看当前应用空间列出当前 MCP 连接配置的云表应用空间。不会枚举其他服务器、账号或未配置的连接。必填参数：无业务参数。
yunbiao_app_get读取应用空间信息读取当前连接的应用空间信息。不能通过指定其他空间 ID 切换服务器或账号。必填参数：appId
yunbiao_service_capabilities查看 MCP 能力说明查看服务提供的能力及限制，可用于了解服务是否能响应。该工具不检查云表连接及业务权限；调用成功不等于云表业务连接正常。必填参数：无业务参数。
（2）查找模板、查询和保存表单
日常查数、填单和改单使用的主要工具。
工具作用、参数与注意事项
yunbiao_form_types查找业务模板列出或搜索表单定义、流程定义、统计定义、报表定义，支持分页，包含目录返回的菜单隐藏项。泛称“有哪些模板”时优先使用。找到模板不代表支持该类型的全部查询、填写或设计操作。必填参数：appRegistrationId此工具使用 appRegistrationId；分页使用 page.pageSize 和返回的 page.cursor。
yunbiao_form_query查询总表数据查询已有表单、统计或报表模板的总表数据，支持过滤、排序和分页。使用实际模板名称；不提供临时创建任意跨模板统计查询的能力。必填参数：appId、templateName每页条数写在 page.pageSize；page.pageIndex 与 page.rowIndex 从 0 开始且二选一，不支持顶层 pageSize。
yunbiao_form_schema_get读取填写与修改要求读取新建或修改业务表单时可填写的数据项、明细表及保存格式要求。用于正确填单，不是修改模板设计。必填参数：appId、templateName修改已有表单时提供业务表单 formId；读取新建填写结构时省略。
yunbiao_form_get读取一张表单读取指定模板下的一张已保存业务表单，查看基本信息、明细及当前可用状态按钮等内容。需要业务表单 ID，不能用模板定义 ID 代替。必填参数：appId、templateName、formId
yunbiao_form_save新建或修改业务表单在已有模板下新建业务表单，或保存指定表单的修改，保存后读回核验。普通保存内部处理已支持的新建初始化、真实值变化和保存前填表公式。遇到补填或选源时，尚未完成保存。必填参数：appId、templateName、patch修改已有表单必须携带原业务表单 formId；patch 按结构工具返回的约定填写，不传完整原生表单 JSON。
（3）填写规范与填表公式
选择真实候选、自动填写关联信息，以及处理支持的填表公式。
工具作用、参数与注意事项
yunbiao_field_candidates_get查询填写候选按数据项的填写规范查询候选，例如供应商或物料，结合当前未保存内容处理联动过滤。缺少输入时需要补充；候选来自实际数据，不应由 AI 编造。该操作不保存表单。必填参数：appId、templateName、fieldKey携带完整 currentRecordPatch；处理明细数据项时指定实际 tableKey。
yunbiao_field_candidate_apply应用选择结果将选中的候选应用到当前未保存内容，按照填写规范自动填写相关数据项。例如选择供应商后填写供应商编号和名称。应用选择结果不等于保存，之后仍需保存表单。必填参数：appId、templateName、fieldKey、selectionTokens选择标识来自候选查询；传入查询时一致的完整 currentRecordPatch，不能编造或混用标识。
yunbiao_formula_value_changed_apply计算值变化填表公式根据实际数据项值变化和当前未保存内容，执行支持的填表公式，主要用于计算预览、诊断或测试。不保存表单；普通填报保存无需先调用该工具。当前不是完整的云表公式引擎。必填参数：appId、templateName、fieldKey、newValue
yunbiao_formula_data_source_selection_apply继续公式来源数据选择公式要求选择来源记录时，提交本次选择，继续同一次公式计算或保存准备。可能还需继续选择；该工具自身不保存表单，完成后仍按返回指引提交保存。必填参数：appId、templateName、formulaContinuationToken、selectionTokens使用同一次公式待选返回的标识、候选及对应未保存内容，不与填写规范候选标识混用。
（4）状态按钮与流程操作
先查看当前实际可用操作，再执行对应按钮；状态审核与流程审批不能相互替代。
工具作用、参数与注意事项
yunbiao_form_state_execute执行一个状态按钮点击已保存表单当前可用的一个手动状态按钮，例如实际提供的审核或反审核按钮。先读取表单，使用返回的按钮及版本信息。当前状态按钮前后的填表公式默认不执行；云表自身业务公式仍可能触发。必填参数：templateName、formId、stateField、expectedVersion
yunbiao_workflow_actions_get查看流程按钮和进度读取当前任务或业务表单的系统流程按钮及进度，了解当前环节、执行人和可用操作。只读取，不提交流程；发现按钮不等于该按钮的所有执行方式都已支持。必填参数：按目标条件填写，见下方。必须二选一：workItemId，或 templateName 加 formId；本工具不需要 appId。
yunbiao_workflow_action_execute执行流程操作执行已支持的流程操作，包括已保存表单启动，以及审批、完成、转办、加签、抄送、催办、撤回等基础操作；根据返回问题补充意见或人员。以当前按钮、权限及具体执行支持情况为准。不支持“新建并启动”和任意自定义撤销；本次操作完成不等于整个流程结束。必填参数：actionRefactionRef 来自流程按钮发现结果；需续交时沿原引用提交返回的 continuationToken 和 answers，不自行编造动作或任务 ID。
（5）读取和准备表单模板设计
可以读取设计、准备修改、检查问题和查看差异；以下操作不会将设计修改正式保存到云表。
工具作用、参数与注意事项
yunbiao_template_list查找表单模板设计列出或搜索表单模板的设计目录，支持分页，用于明确的表单模板设计查看与维护任务。仅列出“表单定义”；查看四类业务模板目录应使用 yunbiao_form_types。必填参数：appId分页使用顶层 limit 与 cursor，不是表单查询的 page 格式。
yunbiao_template_new读取空白模板初始内容获取空白表单模板的初始定义，用于了解新模板所需内容。名称中虽有 new，但不会在云表创建模板，也不会建立编辑草稿。必填参数：appId
yunbiao_template_get读取表单模板定义按实际模板名称或模板定义 ID 读取已有表单模板的设计内容。找不到目标或没有权限时，应说明原因，不得擅自新建模板替代。必填参数：appIdtemplateName 与模板定义 formId 至少提供一项；不支持 formTypeId。
yunbiao_template_edit_start准备模板修改内容基于空白内容或已有表单模板，建立尚未保存的编辑草稿。修改任务必须基于已有模板，不得因找不到或无权限自行转为新建。必填参数：appId、modemode 为 create 或 update；新建需模板名称，修改需定位已有模板或来源。只建立草稿，不保存。
yunbiao_template_get_summary查看待修改内容摘要读取模板编辑草稿的数据项、表结构摘要及后续修改所需的实际标识和格式。用于准备准确修改，不保存云表模板。必填参数：editSessionId
yunbiao_template_patch调整尚未保存的模板内容按支持的操作修改草稿中的模板、表和数据项，也可仅预览影响。不是完整模板设计器；不支持直接编辑填写规范、数据接口、公式、布局和样式等内容。必填参数：editSessionId、nodeType、operationtarget、patch 等按具体操作及草稿摘要填写，不自行编造节点。
yunbiao_template_validate检查待修改内容检查模板编辑草稿及本地保存格式的适配情况，返回已发现的问题。不执行云表远端保存，也不表示所有业务设计均已验证。必填参数：editSessionId指定节点范围时，另需对应的 nodeType 和 target。
yunbiao_template_diff查看模板修改差异比较当前编辑草稿和开始编辑时的内容，查看已支持的模板、表和数据项差异。不保存修改；当前不提供完整原生定义差异输出。必填参数：editSessionId
（6）数据接口
当前覆盖自动编号、下拉列表、列表选择和树形列表四类，不是任意 HTTP 接口调用工具。
工具作用、参数与注意事项
yunbiao_data_intf_list查看全局数据接口目录列出当前支持类型的全局数据接口设计目录，可按接口类型筛选。仅列目录，不执行接口。必填参数：appId
yunbiao_data_intf_new读取数据接口初始内容获取指定类型的全局数据接口空白定义及配置说明。不会创建、保存或执行接口。必填参数：appId、interfaceType
yunbiao_data_intf_get读取全局数据接口定义按真实类型和名称读取已有全局数据接口的定义及配置说明。不执行接口，也不修改定义。必填参数：appId、interfaceType、name
yunbiao_data_intf_invoke调用已有数据接口按实际类型、所属模板和名称，调用已有自动编号、下拉列表、列表选择或树形列表接口。自动编号可能消耗编号，不宜试探性重复调用；该工具不代替填写候选的选择与自动填写步骤。必填参数：appId、interfaceType、name模板所属接口按实际定义提供 ownerTemplateId，全局接口省略或填 0；不能填业务表单 ID。
（7）模板引用关系
用于了解修改影响和追查数据来源配置。
工具作用、参数与注意事项
yunbiao_template_relations_query查询模板直接引用查询一个模板直接引用了哪些模板，或被哪些模板引用，并返回已配置的引用位置。查询两个方向需分别调用；结果是直接配置关系，不代表业务实际执行记录或完整间接关系。要求云表服务器版本不低于 3.3.54.0，并检查模板可读权限。必填参数：appIdreferenceTemplate 查它引用谁，referencedTemplate 查谁引用它；同时填写按 AND 过滤，查询两个方向应分别调用。
（8）设计模板工具（暂未开放）
为避免误解，这里列出用途；当前 MCP 入口不提供以下设计保存能力。
工具用途与当前状态
yunbiao_template_save直接保存表单模板设计用途是通过完整定义或修改内容保存表单模板设计。当前暂未开放，不能通过该工具正式新建或修改云表模板。必填参数：appId还需提供 json 或 patch；此处 formId 为模板定义 ID。当前保存入口未开放。
yunbiao_template_commit提交模板编辑草稿用途是提交准备完成的模板编辑草稿并核验结果。当前暂未开放；草稿检查通过或差异已生成，都不等于模板已保存。必填参数：editSessionId
yunbiao_data_intf_save保存全局数据接口设计用途是保存新建或修改后的全局数据接口定义。当前暂未开放；读取空白定义不等于已经创建数据接口。必填参数：appId、interfaceType还需提供 json 或 patch；此处 formId 为接口定义 ID。当前保存入口未开放。

2.3 当前限制

云表平台具备的功能，不代表当前 MCP 都已接入。以下是使用时需要明确的边界。
功能当前情况
正式保存模板设计暂未开放表单模板及全局数据接口的设计保存。切换为预留的 edit-design 模式也不会开启这些功能。
设计其他类型模板业务目录能找到流程、统计和报表模板，不代表提供这些类型的完整设计工具。当前模板编辑草稿针对表单模板。
临时跨模板统计查询可以查询已有统计或报表模板，不支持临时构造并执行任意关联、汇总查询。
完整填表公式只执行当前支持的公式与来源数据操作。遇到不支持的表达式或操作时会明确失败，不能跳过后强行保存。
状态按钮前后填表公式当前默认不执行。依赖这些公式的业务需要单独确认；云表自身既有业务公式仍可能触发。
任意流程和自定义按钮只支持已接入的执行方式，不保证所有会签、选人、自定义分支或撤销逻辑可执行。“新建并启动”暂不支持，可先保存表单，再查看可用启动操作。
其他常用功能暂未提供表单删除、附件管理、批量导入导出、打印、文件夹管理、业务公式设计，以及系统变量类型的数据接口工具。
注意：修改失败，不等于可以新建。找不到目标、没有权限或用户反复催促，都不算新建授权；只有用户明确改为新建，才可以改变任务方向。该要求用于约束 AI 的操作意图，不应被理解为仅靠说明文字就能保证模型永不出错。

2.4 结合 Skill 使用

Skill 是供 AI 参考的业务操作说明。把企业常用的填写要求和处理规则写进去，可以减少每次重复说明。

2.4.1 skill说明

（1）MCP提供工具：负责读取实际数据、查询填写候选、保存表单和执行已支持的操作
（2）skill补充业务要求：说明使用哪个模板、如何定位目标、哪些内容不能改、何时询问，以及失败后怎么处理。

2.4.2 怎样准备一份业务 Skill

  1. 确定业务范围。例如只处理采购订单查询、填写和修改，不兼做模板设计或自动审批。
  2. 补充真实业务要求。写清模板名称、订单定位方式、明细匹配条件、必填要求与确认规则。
  3. 按客户端方式启用。将下面内容保存为 SKILL.md，放入所用 AI 客户端支持的 Skill 目录或按其方式导入。不同客户端的安装、识别与调用方式可能不同。
  4. 用具体要求验证。核对 AI 是否定位正确、保留无关内容，并能在找不到、无权限或结果不明时停止。建议先在测试数据上试用。

2.4.3 可调用的skill示例

以下是可调整的业务示例，不是 MCP 随附的采购订单 Skill 安装包。模板、数据项和业务规则均为示例；使用前按实际应用修改，不要把示例名称当作已存在的数据。
SKILL.md
5.2 KB
注意：不安装 Skill 也能使用 MCP。Skill 用于补充业务规则，不能增加云表权限、开启暂未开放的功能，也不能保证模型绝不出错。Skill 中不要填写账号密钥、Token 或 Cookie。

2.5 提问示例

说清楚目标、修改范围、是否保存以及是否操作流程，比只说“帮我改一下”更容易得到符合预期的结果。以下名称和编号均为示例。
2.5.1 修改查询表单示例
示例一 · 按 Skill 修改已有订单
在对话中发送：按采购订单 Skill，把 PO-20261030-018 中物料 M-001 的数量改为 120，单价和其他明细不变。先列出修改清单，等我确认后保存，不发起流程。
//进行的操作：
查询订单 → 读取并定位明细 → 列出修改，等待确认 → 保存并核实
找不到订单、目标行不唯一或没有权限时，应说明情况；不能另建订单替代。
示例二 · 查询已有统计模板
在对话中发送：查找“入库明细查询”统计模板，查询本月的记录，按供应商整理结果。如果筛选条件需要补充，请先问我。只查询，不修改数据。
//进行的操作：
使用已有统计模板查询；不是让 AI 临时创建统计模板或构造任意跨模板查询。

2.5.2 模板分析与引用关系

示例三 · 分析表单模板
在对话中发送：读取“采购订单”表单模板设计，整理基本数据项、明细表、填写规范和填表公式，说明当前配置的填写与计算关系。只依据实际读取到的内容分析；读不到或不能确定的部分单独列出，不修改模板，也不填写业务数据。
//进行的操作：
分析已有设计，不执行公式或验证实际业务结果；不能读取的内容不能靠猜测补齐。
示例四 · 查询两个方向的模板引用
在对话中发送：分别查询“采购订单”直接引用了哪些模板，以及哪些模板直接引用了“采购订单”。按引用方向、关联模板和引用位置整理清单。只查询现有配置，不修改任何模板。
//进行的操作：
两个方向分别查询。结果受模板可读权限限制，只说明直接配置关系，不代表完整的间接关系或业务实际执行记录。
示例五 · 评估模板修改影响
在对话中发送：准备调整“采购订单”采购明细中的“数量”数据项。先读取相关设计并查询直接引用关系，列出可能需要检查的填写规范、公式和相关模板，将已确认的配置与需要进一步核对的风险分开说明。只分析，不保存设计修改。
//进行的操作：
依据实际读取的设计和引用记录评估，不保证覆盖全部间接影响，也不把分析结论当作修改后已通过业务验证。

2.5.3 流程按钮操作

以下仅举审核、转办、抄送三个按钮示例。先定位表单并查看当前可用操作；没有对应按钮、无权限或操作暂不支持时，应说明原因并停止。结果不明确时先核实，不重复提交。
示例六 · 流程审核
在对话中发送：处理“采购订单”PO-20261030-018 当前由我审批的任务。先展示表单摘要和可用审批操作，审批意见为“数量、价格已核对，同意采购”。等我确认后再提交通过，不修改订单内容。
//进行的操作：
使用流程审批按钮，不能用修改“审核”状态代替；本次审批成功不等于整个流程结束。
示例七 · 转办
在对话中发送：把“采购订单”PO-20261030-018 当前由我处理的任务转办给采购部张敏，原因为“由张敏继续核对供应商交期”。先从实际人员候选中确认接收人；同名时让我选择，等我确认后再转办。不修改订单，也不代替对方审批。
//进行的操作：
接收人必须来自实际候选；没有转办按钮或找不到接收人时停止，不用其他操作替代。
示例八 · 抄送
在对话中发送：将“采购订单”PO-20261030-018 的流程抄送财务部李明，说明为“请关注本单付款安排”。先确认实际候选人员，等我确认后再提交。只抄送，不执行审批或转办。
//进行的操作：
工具确认已接受抄送，不代表已经证明收件人已读或通知已送达。
2026-11-12
扫码获取更多内容
© 2026 云表平台帮助文档 版权所有 粤ICP备10204380号
0 0