Skip to content
🚀 EDDI 6.5.0

19个LLM提供商、可抓取网站并读取文件的知识库,以及沿用兼容代理版本的对话新功能

托管云 立即开始
所有集成
代理协议mcpcalls

MCP Client

让 EDDI 代理使用外部 MCP 服务器的工具。服务器的工具会成为代理的工具,并与其他所有工具一样受到相同的审批关口和审计记录约束。

你将获得

  • 来自任何支持 Streamable HTTP 的 MCP 服务器的工具
  • 名称允许列表和拒绝列表,用于精简工具清单
  • 可选的资源列出与读取
  • 断路器,在服务器持续失败时停止调用

在 EDDI 中如何工作

  1. 创建一个 mcpcalls 配置,填入服务器 URL、传输方式 http,以及以 ${vault:...} 引用形式提供的 API 密钥。
  2. 把它作为工作流步骤引用(eddi://ai.labs.mcpcalls)。
  3. 代理的 LLM 任务会自动获取该服务器的工具(enableMcpCallTools 默认为 true)。
  4. 把这些工具加入 toolApprovals,使影响重大的调用等待人工审批。
  5. 对于仅支持 stdio 的服务器,把它放在自己的容器中,经由 HTTP 桥接对外提供,并让 EDDI 指向该桥接。

配置

摘自 EDDI 文档。诸如 your-agent-id 之类的占位符需要你自行替换。

mcpcalls configuration一个 mcpcalls 配置。令牌是保管库引用。
{
  "mcpServerUrl": "https://mcp.example.com/mcp",
  "name": "example",
  "transport": "http",
  "apiKey": "${vault:example-mcp-token}",
  "timeoutMs": 30000
}
agent configuration (hitlConfig)除只读工具外,为所有 MCP 工具设置审批。
{
  "hitlConfig": {
    "toolApprovals": {
      "requireApproval": [
        "mcp:*"
      ],
      "exempt": [
        "mcp:read_*"
      ],
      "approvalTimeout": "PT30M",
      "timeoutPolicy": "AUTO_REJECT"
    }
  }
}

治理

  • MCP 工具调用与其他所有工具来源一样,参与同一套人工介入审批关口。
  • 工具描述中带有指令特征的文本会被脱敏,并限制长度。工具结果会附带来源信息,且默认会对带有指令特征的内容进行脱敏。
  • 工具白名单属于上下文管理,不是安全边界。真正的边界是你赋予该连接的凭据,加上审批关口。
  • 每一个受控决定都会写入审计账本。

须知

  • EDDI 只实现一种 MCP 传输方式,即 Streamable HTTP。它不会自行启动 stdio 服务器,因为可通过配置编辑的命令,等同于以 EDDI 进程用户身份执行任意代码。请使用桥接 sidecar。
  • 断路器会在 60 秒内失败 3 次后打开,因此工具缺失通常意味着服务器正在出错。

相关集成

本页的配置和行为依据 EDDI 文档,核对日期为 2026-10-14。字段名称和默认值可能随版本变化,请在所用版本的文档中确认。