MCP 配置

MCP 工具让 Claude Code 的代码搜索更聪明。不配也能用，配了体验好很多。

npx ccg-workflow menu  # 选「配置 MCP」

代码检索工具（选一个就行）

ace-tool

基于 Augment Code 的语义搜索。搜代码的时候不是傻找关键字，而是理解你想找什么。

需要 Augment Code 账号。没有的话可以用第三方中转。

fast-context

Windsurf 的 Fast Context。不需要给整个仓库建索引就能搜，速度快。

需要 Windsurf 账号。

ContextWeaver

完全本地运行的混合搜索（Embedding + Rerank）。不用联网，但需要硅基流动 API Key（免费注册就有）。

辅助工具（可选）

• Context7 — 查最新的库文档。初始化时自动装好，不用管。
• Playwright — 浏览器自动化和测试。
• DeepWiki — 知识库查询。
• Exa — 搜索引擎，需要 API Key。

MCP 同步

配好 MCP 之后，CCG 会自动把配置同步到 Codex 和 Gemini：

• Codex 同步到 ~/.codex/config.toml
• Gemini 同步到 ~/.gemini/settings.json

这样 /ccg:codex-exec 的时候 Codex 也能直接用 MCP 搜索代码，不用你单独配。

自动授权

CCG 装好后会自动配一个 Hook，让 codeagent-wrapper 的命令不用每次都手动确认。需要装 jq。

v1.7.71 之前需要手动配

在 ~/.claude/settings.json 里加：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' 2>/dev/null | grep -q 'codeagent-wrapper' && echo '{\"hookSpecificOutput\": {\"hookEventName\": \"PreToolUse\", \"permissionDecision\": \"allow\", \"permissionDecisionReason\": \"codeagent-wrapper auto-approved\"}}' || true",
            "timeout": 1
          }
        ]
      }
    ]
  }
}

出问题了？

npx ccg-workflow diagnose-mcp

这个命令会检查你的 MCP 配置哪里不对。