MCP 服务器

MCP（Model Context Protocol）用来把外部工具和数据源接进来。配好一个服务器，它的工具会出现在 Agent 的资源列表里，按需勾选即可。

服务器类型

类型	适用场景	关键字段
SSE	远程服务，服务端推送	端点 URL、请求头
HTTP	远程服务，普通请求/响应	端点 URL、请求头
WebSocket	需要长连接的双向通信	端点 URL、请求头
Stdio	本机可执行程序	命令、参数、环境变量

远程类型需要填端点 URL 和可选的请求头（Headers）；Stdio 需要填命令与参数。

新建服务器

左侧菜单 MCP → 新建服务器：

1. 名称：例如 filesystem、internal-search。
2. 描述：写清它提供什么能力，方便在 Agent 里辨认。
3. 服务器类型：按上面的表选择。
4. 连接信息：
   • 远程：端点 URL；需要鉴权时在 Headers 里加。
   • Stdio：命令与参数（参数每行一个，支持带空格的路径）。
5. 超时时间（秒）：工具调用较慢时适当调大。
6. 保存后，系统会尝试发现工具；成功后可在详情里看到工具清单。

在 Agent 中使用

打开 Agents 的编辑页，在MCP 服务器区域勾选。没勾选的服务器不会被这个 Agent 调用。

常见问题

连接失败：先在服务器详情里点测试/刷新，确认 URL、Headers、超时；Stdio 确认命令在当前环境存在且可执行。

看不到工具：服务器可能只暴露了资源而没有工具；也可能握手失败，检查日志与超时。

工具调用超时：调大超时；如果工具本身返回很慢，考虑改成异步任务型工具。

多个 Agent 共用：同一个 MCP 服务器可以被多个 Agent 勾选，配置只维护一份。