MCP 客户端接入

任何支持 Streamable HTTP MCP 传输的客户端都可以接入。你需要的是工作空间的接入地址:

http://127.0.0.1:18765/mcp/<uuid>

(面板「工作空间」卡片可一键复制。)

Claude Desktop

编辑 MCP 配置文件(设置 → Developer → Edit Config),加入:

{
  "mcpServers": {
    "workspace": {
      "url": "http://127.0.0.1:18765/mcp/<uuid>"
    }
  }
}

重启 Claude Desktop,工具列表即出现在可用工具中。

Cursor

Settings → MCP → Add a new MCP Server:

• Type: Streamable HTTP(或 URL 类型)
• URL: http://127.0.0.1:18765/mcp/<uuid>

或在 .cursor/mcp.json 中:

{
  "mcpServers": {
    "workspace": {
      "url": "http://127.0.0.1:18765/mcp/<uuid>"
    }
  }
}

其他客户端 / 自研 Agent

接入只需满足两点:

1. 传输:HTTP POST <接入地址>,JSON-RPC 2.0(MCP Streamable HTTP,无状态、无需会话头);
2. 发现:先调 initialize → tools/list,即可看到全部工具(名称、参数 schema 与内置文档齐全)。

健康检查:GET <接入地址>/healthz(挂在 MCP 端口)。

WARNING

接入地址即权限:拿到 URL 的任何人都能对该工作空间读写执行。不要把本地地址泄露给不可信方;公网模式请阅读公网访问的安全边界。

多客户端并存

不同客户端可以用同一个工作空间地址,也可以各自绑定不同工作空间(UUID 不同)——例如一个聊天客户端只读仓库 A,另一个编码 Agent 用仓库 B,互不干扰。