创建MCP服务

前提条件

• 已购买Versatile智能体平台。
• 如果需要接入自主开发的MCP服务，需确保该服务已完成独立部署。
• 如果需要安装第三方MCP，需要确保该服务已经订阅成功。订阅第三方MCP服务的详情信息，请参考使用第三方MCP服务。
  

  自主开发的MCP服务需在服务器或本地独立部署，并通过测试确保其能够正常运行。

创建MCP服务

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏选择“开发中心 > 组件库 > 我的MCP”，单击页面左上角的“创建MCP服务”创建MCP服务。
3. 在“创建MCP服务”的下拉列表中选择创建MCP的方式，目前支持空白创建、官方模板创建和第三方服务安装。
   • 空白创建：适用于安装开源社区的MCP或接入自主开发的MCP服务。
     1. 在“空白创建”的弹框中，输入MCP服务的配置信息，参数说明请参考表1。

        表1 创建MCP服务参数说明

        参数	说明
        服务图标	MCP服务的图标。 支持SVG、PNG、JPG、JPEG格式，不超过1MB。
        服务名称	MCP服务名称，用于区分不同的MCP服务实例，不会对大模型的判断和调用产生影响。 命名规则： 命名要求：仅支持以中英文开头。 支持字符：中英文、数字、中划线（-）、下划线（_）。 长度限制：2~64个字符。
        服务描述	MCP服务的描述信息，帮助用户理解服务功能。例如，一个强大的MCP服务器，可以轻松地将网页内容抓取并转换为各种格式（HTML、JSON、Markdown、纯文本）。
        服务介绍（非必填）	更详细地介绍该MCP服务的一些功能。例如，使用方式，关键能力，使用场景，注意事项等。
        安装方式	选择MCP服务的安装方式，支持以下几种方式： NPX：当MCP基于Node.js开发时选择NPX方式。 UVX：当MCP基于Python开发时选择UVX方式。 SSE：适用于与已部署在外部环境的远程MCP服务器建立连接，例如，接入自主开发的基于SSE协议的MCP服务。 streamableHttp：适用于与已部署在外部环境的远程MCP服务器建立连接，例如，接入自主开发的基于streamable http协议的MCP服务。
        输入MCP服务配置	支持使用表单编辑或使用JSON格式编辑。 使用JSON格式编辑。当使用JSON格式编辑时，加密的参数值将以明文显示。 加密变量以_encrypt_开头，请谨慎操作。 安装平台预置的MCP时，默认展示当前MCP的服务配置，一般无需修改，部分服务需要填写API Key，请登录该MCP服务的官网获取。 例如，百度地图的服务配置如下，“BAIDU_MAP_API_KEY”需要登录百度地图官网获取。 { "mcpServers": { "baidu-map": { "command": "npx", "args": [ "-y", "@baidumap/mcp-server-baidu-map" ], "env": { "BAIDU_MAP_API_KEY": "xxx" } } } } 如果部署开源社区的MCP，请在开源社区该MCP服务详情页获取配置代码。 如果接入自主开发的MCP服务，服务配置模板如下，请将“url”更换为该MCP服务的实际部署地址。 基于SSE安装的MCP服务 { "mcpServers": { "example-sse": { "url": "https://example.com?key=<您在服务官网上申请的key>" } } } 基于streamableHttp安装的MCP服务 { "mcpServers": { "example-streamable-http": { "url": "https://example.com?key=<您在服务官网上申请的key>" } } } 使用表单编辑 参数：填写参数值时，多个参数值之间使用英文逗号分隔。例如，-y,@baidumap/mcp-server-baidu-map。 环境变量：单击“添加环境变量”，输入键值对，配置环境变量，例如，BAIDU_MAP_API_KEY: XXX。 URL：外部环境部署的MCP服务的地址。例如，https://example.com?key=<您在服务官网上申请的key>。 请求头：单击“添加请求头”，输入键值对，配置请求头。 加密功能：单击输入框右侧的密文图标，可将参数值加密显示。

     2. 单击“安装”。即可安装自定义的MCP服务。
   • 官方模板创建：适用于安装平台预置的MCP服务。
     1. 在“选择服务”页面中，从预置的MCP列表中选择需要安装的MCP服务，单击“下一步”。
     2. 在“服务配置”页面中，可以根据需要修改MCP服务的配置信息。参数说明请参考表1。
     3. 配置信息修改完成后，单击“安装”。即可安装预置的MCP服务。
   • 第三方服务安装：适用于安装订阅的ROMA Connect的MCP服务。订阅后的第三方MCP服务才能安装。
     订阅ROMA Connect的MCP服务的详情信息，请参考使用第三方MCP服务。

     1. 在“第三方服务安装”的弹框中，选择需要安装的MCP服务。

        如果需要批量安装多个第三方MCP服务，可以勾选“服务名称”列左侧复选框进行批量安装。

        图1 批量安装MCP服务
        
     2. 单击“安装”，即可安装第三方MCP服务。

4. 安装完成之后，可以在“我的MCP”页面查看MCP的部署状态，部署成功的MCP才能在智能体或工作流使用。

更多操作

MCP服务创建完成后，在“我的MCP”界面，您可以通过属性类型（服务名称）或搜索关键字功能来查找MCP服务。也可根据需要执行如表2所示的操作。