连接 Codex、Claude 与 VS Code

请始终从 Weave 的“AI 集成（MCP）”界面复制实际生成的配置。示例路径和 secret 只是结构说明，不能直接使用。

Codex

把生成的 TOML 合并到 ~/.codex/config.toml：

[mcp_servers.weave]
command = "/Applications/Weave.app/Contents/MacOS/zhixi-mcp"
startup_timeout_sec = 10
tool_timeout_sec = 60
default_tools_approval_mode = "writes"

[mcp_servers.weave.env]
ZX_RUNTIME_DATA_ROOT = "/Users/example/Library/Application Support/cloud.longde.zhixi.desktop"
ZX_MCP_CLIENT_FINGERPRINT = "codex-local"
ZX_MCP_BRIDGE_SECRET = "paired-secret-shown-once"

完全重启 Codex 后运行 /mcp，确认 weave 已连接。

Claude Desktop 或 Claude Code

Claude 使用 mcpServers 结构。Claude Desktop 的 macOS 配置通常位于：

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weave": {
      "type": "stdio",
      "command": "/Applications/Weave.app/Contents/MacOS/zhixi-mcp",
      "args": [],
      "env": {
        "ZX_RUNTIME_DATA_ROOT": "/Users/example/Library/Application Support/cloud.longde.zhixi.desktop",
        "ZX_MCP_CLIENT_FINGERPRINT": "claude-local",
        "ZX_MCP_BRIDGE_SECRET": "paired-secret-shown-once"
      }
    }
  }
}

Claude Code 也可以读取项目中的 .mcp.json。如果文件包含真实 secret，必须加入 .gitignore；更推荐用户级配置。

VS Code 与 GitHub Copilot

优先运行 MCP: Open User Configuration，避免 secret 进入仓库。VS Code 使用 servers 结构：

{
  "servers": {
    "weave": {
      "type": "stdio",
      "command": "/Applications/Weave.app/Contents/MacOS/zhixi-mcp",
      "args": [],
      "env": {
        "ZX_RUNTIME_DATA_ROOT": "/Users/example/Library/Application Support/cloud.longde.zhixi.desktop",
        "ZX_MCP_CLIENT_FINGERPRINT": "vscode-local",
        "ZX_MCP_BRIDGE_SECRET": "paired-secret-shown-once"
      }
    }
  }
}

保存后运行 MCP: List Servers 并启动 weave。

通用 Agent

目标 Agent 必须支持本地 stdio MCP Server，并允许配置命令、参数和环境变量。不要假设 Claude、Codex 或 VS Code 的完整配置文件可以互换。