工具与 MCP

MCP（Model Context Protocol）服务为 Agent 和工作流接入外部工具能力。通过 MCP，您可以让 Agent 调用数据库查询、API 请求、文件操作等外部服务。

核心概念

MCP 服务

MCP 服务是一个遵循标准协议的外部工具提供方。每个 MCP 服务可以包含多个工具，Agent 在执行任务时按需调用这些工具。

传输方式

MCP 服务支持两种传输方式：

传输方式	运行位置	配置要素	适用场景
本地模式	您的设备上	启动命令、参数、环境变量	本地工具、开发调试
远程模式	远程服务器	服务地址、请求头	云服务、团队共享工具

添加 MCP 服务

手动填写

进入工具管理页面，点击「添加 MCP 服务」，填写以下参数：

字段	类型	必填	说明	条件
服务名称	文本	是	MCP 服务标识名，在工具列表中显示	-
传输方式	下拉选择	是	stdio（本地模式）或 streamable_http（远程模式）	-
启动命令	文本	是	本地进程的启动命令，如 npx、python	传输方式 = stdio
命令参数	多行文本	否	传递给启动命令的参数，每行一个	传输方式 = stdio
服务地址	文本	是	远程 MCP 服务的 HTTP 端点 URL	传输方式 = streamable_http
环境变量	键值对	否	传递给进程的环境变量，如 API Key、Token	-
请求头	键值对	否	HTTP 请求头，用于认证或自定义头信息	-

JSON 导入

如果您已有现成的 MCP 配置（例如从社区或团队获取），可以直接通过 JSON 导入：

1. 进入工具管理页面
2. 点击「JSON 导入」
3. 粘贴 JSON 配置内容并确认

JSON 格式示例：

{
  "mcpServers": {
    "my-service": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

远程模式的 JSON 格式：

{
  "mcpServers": {
    "remote-service": {
      "transport": "streamable_http",
      "url": "https://mcp.example.com/api",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

TIP

JSON 导入适合快速接入已有配置。社区和市场中有大量现成的 MCP 服务配置可供使用。

验证与连接

添加 MCP 服务后，需要完成以下验证步骤：

1. 测试连接：点击「测试」按钮，确认服务可以正常响应
2. 刷新工具列表：点击「刷新工具」，获取该服务提供的所有工具
3. 确认工具数量：工具列表中每个工具显示为 mcp.<服务ID>.<工具名> 格式，核对数量是否与预期一致
4. 建立连接：点击「连接」，服务状态变为已连接后即可在 Agent 中调用

WARNING

如果测试连接失败，请检查：本地模式下确认启动命令和环境变量是否正确；远程模式下确认服务地址是否可达。

MCP 与接入渠道的区别

对比项	MCP 服务	接入渠道
核心用途	扩展 Agent 的工具能力	连接外部消息入口
数据方向	Agent 主动调用外部工具	外部消息触发 Agent 响应
典型场景	数据库查询、API 调用	飞书消息、钉钉通知

适用场景

场景	说明
数据查询	让 Agent 直接查询数据库或 API
文件操作	让 Agent 读写本地或远程文件
第三方集成	接入 GitHub、Jira、Slack 等服务
自定义工具	将内部工具包装为 MCP 服务供 Agent 使用

下一步

• 接入第一个 MCP 服务：连接 MCP
• 连接外部消息入口：接入渠道
• 社区 MCP 服务：市场资源