MCP

MCP市场已集成了AgentArts资产广场中精选的MCP服务，支持直接在市场中浏览并一键安装。

1. 单击码道Agent Space页面右上角的设置图标 ，进入设置页面。
2. 在左侧导航栏选择“MCP工具”，进入MCP服务页面。
3. 在“市场”页签中，找到您所需要的MCP服务（如墨稿大师），单击右侧的“+”，安装MCP服务。
   

   码道Agent Space对可添加的MCP服务器数量没有硬性限制，建议创建数量不超过20个；同时建议开启数量控制在8个以内，启用3个可获得最优使用体验。

   图1 安装MCP服务
   

   安装完成后，在“已安装”页签，可查看到已安装的MCP服务。

   图2 查看已安装的MCP服务
   

4. 使用已安装的MCP服务。
   1. 在码道Agent Space聊天界面的输入框中，输入如下内容，单击发送图标 。
      墨稿大师是一款基于MCP协议构建的高效本地文档转换工具，能够快速将Markdown文件转换为Word文档。输入相关指令后，智能体将自动调用已安装的墨稿大师MPC服务器，完成文档的格式转换。

      请将code-analyzer.md文档转换为word格式

   2. 查看MCP调用结果。
      在“编辑器 > 资源管理器”中生成对应Word格式的文档，说明MCP调用成功。

      图3 查看调用结果
      

1. 单击码道Agent Space页面右上角的设置图标 ，进入设置页面。
2. 在左侧导航栏选择“MCP工具”，进入MCP服务页面。
3. 单击“配置MCP”，打开“mcp_settings.json”文件，编辑MCP服务器的JSON配置文件。
   

   码道Agent Space对可添加的MCP服务器数量没有硬性限制，建议创建数量不超过20个；同时建议开启数量控制在8个以内，启用3个可获得最优使用体验。

   MCP配置的通用模板如下：

   {
     "mcpServers": {
       "服务器名称": {
         "command": "启动进程的命令",
         "args": [
           "参数数组"
         ],
         "env": {
           "环境变量"
         }
       }
     }
   }

   表2 配置参数说明

   参数	说明
   服务器名称	服务器的唯一名称/标识符，长度不能超过64个字符，用于区分不同的MCP服务器。 说明： 服务器名称超过64个字符时，可能返回以下报错并导致当前请求不可用。您可以参考服务器核心功能中的“Tools”参数的定义。 type: session.error info length over limit, maximum is 64
   command	必填，要执行的命令或程序路径，用于指定启动MCP服务器所需的程序。
   args	选填，传递给命令的参数列表，配合command使用，指定如何运行MCP服务器。
   env	选填，传递给MCP服务器的环境变量集合，所有环境变量值均需为字符串类型。

   例如，您想通过Playwright直接操控浏览器完成网页导航、点击、输入、截图、数据提取等自动化操作。mcp_settings.json文件配置如下：

   {
     "mcpServers": {
       "playwright": {
         "command": "npx",
         "args": [
           "@playwright/mcp@latest"
         ]
       }
     }
   }

   此示例用户需要本地安装node.js环境，推荐node-v24.x版本。您也可以通过与智能体交互，让智能体为您直接安装。

4. 配置完成后按快捷键（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）保存，等待工具启动完成。

   如果在配置中遇到问题，可以返回到聊天界面，与智能体进行交互，帮助您修复问题。

1. 单击码道Agent Space页面右上角的设置图标 ，进入设置页面。
2. 在左侧导航栏选择“MCP工具”，进入MCP服务页面。
3. 单击“配置MCP”，打开“mcp_settings.json”文件，对MCP服务器的JSON配置文件进行自定义编辑。
   

   码道Agent Space对可添加的MCP服务器数量没有硬性限制，建议创建数量不超过20个；同时建议开启数量控制在8个以内，启用3个可获得最优使用体验。

   • 适配SSE协议的MCP通用配置模板，适用于事件型实时推送场景。

     {
       "mcpServers": {    
         "服务器名称": {
           "url": "https://example.com/mcp/sse",
           "type": "sse"
         }
       }
     }

   • 适配Streamable HTTP协议的MCP通用配置模板，适用于通用流式数据传输场景。

     {
       "mcpServers": {
         "服务器名称": {
           "url": "https://example.com/mcp",
           "type": "streamableHttp"
         }
       }
     }

   表3 配置参数说明

   参数	说明
   服务器名称	服务器的唯一名称/标识符，长度不能超过64个字符，用于区分不同的MCP服务器。 说明： 服务器名称超过64个字符时，可能返回以下报错并导致当前请求不可用。您可以参考服务器核心功能中的“Tools”参数的定义。 type: session.error info length over limit, maximum is 64
   url	用于访问远程MCP服务器的地址，需确保是合法的HTTP或HTTPS类型URL。
   type	MCP服务器的通信协议类型，取值为sse或streamableHttp。 注意： 如果现有示例中缺少“type”参数，建议在使用前手动补充，以确保在码道Agent Space中正常运行。

   假设，您希望将高德MCP服务器与高德地图APP进行对接，“mcp_settings.json”文件的配置如下所示。

   {
     "mcpServers": {
       "amap-maps-streamableHTTP": {
         "url": "https://mcp.amap.com/mcp?key=您在高德官网上申请的key",
         "type": "streamableHttp"
       }
     }
   }

4. 配置完成后按快捷键（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）保存，等待工具启动完成。
   图4 MCP工具启动完成
   

   如果在配置中遇到问题，可以返回到聊天界面，与智能体进行交互，帮助您修复问题。

5. 使用已安装的MCP服务。
   1. 在码道Agent Space聊天界面的输入框中，输入如下内容，单击发送图标 。

      帮我规划一个北京一日游，包含故宫、长城，包含美食

   2. 查看MCP调用结果。
      智能体会通过MCP服务器调用高德地图，为您生成个性化的一日游路线规划。

      图5 一日游路线规划