发布和管理MCP Tool

添加Tool

1. 选择应用和应用版本、确定Tool名称（Tool name）、所属MCP Server等基础信息。

   

   参数	说明
   应用和应用版本	重要 Tool与RPA应用的关系： 只能将已经发布的应用创建为MCP Tool。 应用和Tool是1:1的对应关系；应用版本和Tool版本同样是1:1的对应关系。
   Tool名称（Tool name）	Tool name目前最长100个字符，不支持使用中文，建议使用英文下划线（_）分隔各个单词。 重要 建议Tool name不要直接使用应用名称。 在本地型机器人的使用场景中，还支持使用者在机器人客户端上根据应用名称筛选后执行；Tool name和Tool description提供给大模型查找所需的Tool，因此Tool name需要更加容易被大模型所理解。
   所属MCP Server	只能选择业务类MCP Server。

2. 补充该版本Tool的Tool description、Tool Input信息。

   

   参数	说明
   描述（Tool description）	产品提供了默认的Description模板，您可以在此模板上完善内容。
   输入参数	输入参数分成2类：自动化流程的输入参数、系统输入参数。 系统输入参数：不可修改、不可删除。 自动化流程的输入参数，参数名称、参数类型和是否必填来自流程开发阶段的定义。 重要 本步骤会对参数名称、参数类型进行校验，校验失败将不能继续。可根据错误提示在编辑器的参数面板中进行修改，并重新发布新版本应用后，再为新版本应用添加Tool。 参数名、参数类型、必填，需要在编辑器的参数面板进行定义或修改，如下图所示。

   • 自动化流程的输入参数

     建议项	内容
     参数名称	在编辑器的参数面板中定义和编辑。 格式要求：大小写英文 or 数字 or 下划线，开头只能英文字符，结尾不能下划线结尾
     参数类型	编辑器参数面板 说明 在使用RPA开发MCP Tool的场景下，建议全部使用“文本框”类型（如上图所示），并在自动化流程内按需进行格式转换，降低传输过程中因为格式转换引出的各种问题。 Tool的参数类型 MCP协议中使用jsonrpc描述Tool的定义，因此在本步骤中在补充Tool入参信息时，也全部使用JSON基本类型及JSON Schema。 具体参数类型的使用建议，详见下文。
     是否必填	在编辑器的参数面板中定义和编辑。
     参数说明	需要您重点补充完善，从而能够告知大模型此入参的用途、填写内容的补充要求（如格式要求等）。

     根据参数的不同用途，可分为：基本类型、结构化字符串和文件三种。

     基本类型

     支持的基本类型包括：string、integer、date、datetime；并设置基本类型的一些校验条件，例如：默认值、枚举值等。

     结构化字符串

     自动化流程经常会需要对一组数据进行操作，比如向多个人发送不同的消息，因此需要某个入参具有一定的数据结构。在使用RPA开发MCP Tool的场景下，建议需要控制入参结构的复杂度，不要过于复杂，给大模型在生成Tool入参时造成困难。

     针对结构化的入参，可选择“json结构”类型，根据引导完成定义。

     参数结构建议不要超过如下几种示例的复杂度：

     类型	举例
     简单数组	["1","2","3"]
     二维数组	[ ["1","2","3"], ["a","b","c"] ]
     K-V结构	{ "name":"Tom", "age":21, "address":"Beijing" }
     包含多个K-V结构数据的数组	[ { "name": "Tom", "age": 21, "address": "Beijing" }, { "name": "Jerry", "age": 19, "address": "Hangzhou" } ]

     生成参数定义。可以利用页面中提供的功能，自动生成参数定义。

     • 参数类型选择“json结构”，出现json定义窗口。如果您熟悉JSON Schema，可直接在窗口开始进行数据结构定义或直接导入json schema内容。

     • 

     • 同时也可以使用“JSON数据快捷导入”功能，通过json数据自动生成对应的json schema。

     说明

     • 建议对结构化的入参进行参数定义，便于大模型更好的理解Tool所需的参数和拼装；

     • 定义生成过程建议使用“JSON数据快速导入”功能，根据数据自动生成定义。

     文件

     自动化流程中经常会需要操作文件，如从Excel文件中读取需要在网站上填报的数据。此种情况下就会需要考虑如何向自动化流程中传入文件内容。

     • 方式1：如果文件内容比较小，并且有明确的结构（如Excel、CSV等），可以考虑将文件内容解析后传入，使用前文提到的结构化入参的方式。

     • 方式2：如果文件内容较大，建议使用传递文件链接方式。自动化流程的入参是文件链接（例如保存在OSS上），自动化流程中下载该文件、解析后完成后续操作。详见 使用阿里云OSS下载和上传文件。

   • 系统输入参数

     参数名	类型	必填	说明
     RobotId	string	是	需要指定机器人执行该自动化任务。 两种类型的机器人（本地型机器人、服务型机器人）都支持被MCP调用。
     TaskPriority	integer	否	自动化任务优先级，0-100的正整数，默认50。 仅在机器人的等待执行任务队列中生效，数字越大，越会优先执行。

3. （可选）回调设置。

   1. 配置回调之后，调用该MCP Tool创建的任务，在任务状态发生变化时，会触发回调通知。回调通知的具体细节和使用的机器人类型有关，服务型机器人请查看 CreateTask，本地型机器人请查看 createServiceTask。

   2. 配置回调地址时，会向该地址发送真实HTTP Post请求，以确认连通性。

      重要

      校验方式是通过互联网向该地址发送POST请求、请求内容为空；需要HTTP返回Status等于200时，则通过测试。

4. （可选）发布到MCP网关实例。Tool需要发布到MCP网关实例上才可被调用，在本步骤中可以直接将已经定义的Tool发布。

5. （可选）使用大模型对MCP Tool进行评估，协助您对补充的Tool信息进行修改。

评估Tool

MCP Tool在给大模型调用之前，可使用AI辅助评估的功能，目的是从模型角度评估人工补充的Tool信息是否能够被大模型准确理解和使用。您可结合实际情况决定是否进行修改。

• 评估内容包括：该版本MCP Tool的本Tool name、description、input schema。

• 评估过程为静态评估，不会发起真正的MCP Tool调用。

• 评估结果举例如下：

Tool版本管理

研发迭代的测试和生产

Tool发布上线后，持续的研发迭代过程中，可能会涉及如下的修改：

• Tool自身信息的修改，如修改description

• 自动化流程的调整，带来对应的RPA应用的版本变化

此种情况下，在正式上线前，也需要对Tool进行测试，参考RPA应用的处理方式（详见应用迭代：测试和发布线上），可以通过创建测试用途的MCP Server和MCP Tool进行测试。以get_city_weather为例。

其他操作

• 修改指定版本Tool。支持修改Tool description、Tool Input内容；修改后需要发布到MCP网关实例上才可生效。

• 修改Tool名称。需要先将该Tool的所有版本下线，然后可修改Tool名称。

• 删除Tool版本。需要先将该版本下线，然后可删除该版本。

• 删除Tool。删除该Tool的所有版本后，Tool会自动删除。

系统内置Tool

详见 系统内置MCP Tool

MCP调用认证和权限范围

所有MCP请求都需要认证，不支持匿名调用。可在MCP Server-凭证管理中进行凭证管理。

MCP调用的权限范围，与使用的机器人类型有关，更多机器人类型详见 选择机器人类型。

• 本地型机器人

  • 机器人能够运行的应用范围需要使用账号提前进行申请和审批，详见发布和管理应用；触发机器人运行的类型包括客户端手动执行、OpenAPI触发等。

  • 如果使用MCP调用此种类型机器人时，MCP Client获得tool list仍然为该MCP网关实例上的所有Tool，但执行Tool时可能会因为该Token没有应用权限而运行失败。

• 服务型机器人

  • 服务型机器人可通过OpenAPI调用触发，OpenAPI能够运行所有已上架应用，由您的上层系统负责控制运行范围。

  • 因此使用MCP调用此种类型机器人时，MCP Client可调用全部Tool。

获取MCP连接信息

在MCP Server菜单中，可通过“获取MCP Server连接信息”获取指定MCP网关实例的调用地址和连接信息。

MCP调用时序

请参考 OpenAPI触发和MCP触发