MCP 服务

橘记支持通过 Model Context Protocol 接入外部工具服务。

配置文件

MCP 服务器配置在橘记用户目录下的 mcp.json：

~/.orange/mcp.json

结构：

json

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@some/mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    },
    "remote-server": {
      "url": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${TOKEN}"
      }
    }
  }
}

传输方式

传输	配置字段	说明
stdio	`command` + `args`	本地进程，通过标准输入输出通信
streamable HTTP	`url`	远程服务

配置约束

command 必须是一个可执行文件，不能是 shell 脚本（不能包含换行）。
不支持旧的 SSE 传输，请改用 streamable HTTP 的 url。
不支持 !command 插值，请改用 ${环境变量}。

权限与审批

场景	MCP 是否可见
本地交互会话，两种完全权限档	✅
两种工作区权限档	❌
计划模式	❌
远程 / IM 会话	❌

完全权限，需审批：每次调用都审批，服务声称只读也不免批。
完全权限，无需审批：自动执行，仍验证功能启用和会话权限。
审批绑定会话、权限版本、工具及准确参数，300 秒超时；停止、收权、重启、重复或迟到决定不会执行。
外部服务的远端副作用不受本地文件 diff 与 hash 保护。
与橘记内置工具重名的 MCP 工具不会暴露给模型。

下一步