MCP 服务

在配置里加一个服务

写在 ~/.heng-agent/config.json（或项目的 .heng-agent/config.json）的 mcp_servers 里。两种连接方式：command 启动一个程序（stdio），url 连一个已经在跑的服务（http，即 MCP 的 Streamable HTTP）：

{
  "mcp_servers": {
    "本地工具": { "command": "my-mcp", "args": ["--stdio"], "env": { "FOO": "bar" }, "timeout": 60 },
    "远程服务": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer 令牌" } }
  }
}

也认 mcpServers 这个写法（Claude Code、Kimi 用的），它们的配置可以直接贴过来；项目根目录的 .mcp.json 也会读，支持 ${变量}、${变量:-默认值}。老式 SSE 传输不支持。

看连上没有

MCP 服务在后台连接，不耽误欢迎页出来；提交第一句时还没连好会等一下（Ctrl+C 跳过）。状态栏第一行显示连接情况：

连好后每个服务一行列出工具数，最后一行汇总与用时。/mcp 查看已接入的工具和连不上的原因；改好配置后 /mcp reconnect 服务名，不用重启。

调用前会问你

工具注册成 mcp__服务名__工具名。外部工具可能写数据库、发消息，除全部放行（auto）模式外调用前都会问你，计划模式也一样。常用的可以写成允许规则，见 权限模式与规则。

工具太多：按需加载

接几个大服务很容易上百个工具，声明每次请求都带上会占掉大半上下文、每问都花这么多钱。所以 MCP 工具声明超过上下文的 10% 时，heng-agent 先不发声明，只给模型一个 tool_search：它按关键词搜，搜到的工具立即加载、下一步就能调用。

配置 settings.mcp_tool_search：auto（默认）/ on / off。