Collide MCP Server已验证已精选

什么是 Collide MCP？

Collide MCP 是面向 AI 编程智能体的协同服务器。它让在同一个仓库中工作的 Claude Code、Codex、Cursor 和其他 MCP 智能体，实时感知彼此正在进行的符号级修改，并提供一个共享记忆：当它所描述的代码发生变化时，会自动标记为可能过期。

每个智能体都从一份基于代码库符号级映射生成的精简简报开始，先声明打算修改的内容，写入前检查冲突，写入后上报修改。Collide 在内存中解析上报的文件内容，随后将其丢弃。持久保存的只有符号名称、类型、签名、哈希、行范围、事件以及智能体保存的笔记。免费的本地版本完全在一台机器上运行，托管服务器 https://mcp.collidemcp.com 则在团队成员的多台机器之间提供协同。

如何使用 Collide MCP？

有两种开始方式。

本地安装（免费，无需账户）。安装一次即可覆盖本机所有仓库，且不会向仓库写入任何内容：

curl -fsSL https://collidemcp.com/install.sh | sh

也可以运行 npx collidemcp。

托管服务器。把智能体连接到 https://mcp.collidemcp.com。首次使用时在浏览器中通过 OAuth 登录，无需粘贴任何 key。智能体的第一次 Collide 调用会安装相同的本机 hooks，并注册到 Claude Code、Codex 和 Cursor 的用户级设置中。仓库通过其 git remote 自动发现，无需配置。

Claude Code

claude mcp add --scope user --transport http collide https://mcp.collidemcp.com

Claude Desktop 和 claude.ai

在 Settings、Connectors 中添加自定义连接器，URL 填写 https://mcp.collidemcp.com，然后在浏览器中批准登录。

Cursor

{
  "mcpServers": {
    "collide": {
      "url": "https://mcp.collidemcp.com"
    }
  }
}

VS Code

{
  "servers": {
    "collide": {
      "type": "http",
      "url": "https://mcp.collidemcp.com"
    }
  }
}

在 collidemcp.com 打开仪表盘，可以实时查看修改、意图和冲突。对于不支持 hooks 的智能体，可以使用 collide-watch 监视器（pipx install collide-watch）从磁盘上报修改。

Collide MCP 的主要功能

• 通过 MCP 握手教给智能体的六步协议：吸收简报、声明意图、检查冲突、上报修改、收尾、合并检查。
• 类型化的意图操作（rename、add_param、move、delete 等），可以与其他进行中的意图给出可证明的可交换或冲突判断。
• Compare-and-swap 写入：传入你读取时的符号哈希，如果之后有任何变动，写入会被拒绝。
• 锚定到符号、文件或目录的记忆，在智能体接触相关代码时自动出现，锚点被重写后会标记为过期。
• 适用于 Claude Code、Codex、Cursor 和 Hermes 的 hooks，自动上报，出现任何错误都会放行（fail open），另有可选的 git pre-commit 关卡。
• enforce 模式会阻止落在确定且破坏性冲突上的写入；advisory 模式则不设关卡。
• Enterprise 套餐支持在你的 VPC 中自托管。

Collide MCP 工具

每个工具都需要 repo_id。

• 会话与感知：会话开始时调用 get_briefing，list_activity 查看实时状态，blind_spots 列出映射不可靠的文件，以及 compliance_report（Business 套餐）。
• 意图：declare_intent、heartbeat（意图的 TTL 为 15 分钟）、附带理由的 complete_intent，以及为下一个智能体留下提醒的 defer_intent。
• 检查与写入：check_collisions 是核心调用；report_edit 在写入后提交文件；get_symbol 返回某个符号的最新状态。
• 记忆：remember 和 recall。
• 合并：simulate_merge 预演多个工作区合并的结果；differential_check 返回 PASS、FAIL 或 UNKNOWN，判断你的修改是否保留了另一个工作区所依赖的接口。
• 设置：connect_agents、install_hooks、setup、sync_agents_block 和 switch_workspace。

Collide MCP 的使用场景

• 在同一仓库中同时运行 Claude Code 和 Codex：“修改 auth.py 之前先检查冲突。”
• 避免重复劳动：智能体先声明意图，另一个智能体就能看到某个符号已经在重命名中。
• 更安全的合并：“模拟把我的工作区和 Dana 的合并，告诉我哪些符号不一致。”
• 沉淀团队知识：“记住 validateToken 必须保持同步执行。”并锚定到代码，让下一个智能体看到。
• 会话交接：每次会话都从近期重命名、热点和被放弃工作的简报开始，而不是重新通读仓库。

Collide MCP 常见问题排查

• 仓库没有出现：hooks 会在智能体第一次在仓库中工作时，根据 git remote 上报该仓库。若想提前关注，在仪表盘中连接 GitHub 并添加仓库。
• 仓库被放进了错误的工作区：让智能体调用 move_repo，或在仪表盘的 Settings → Repo 中调整。
• 写入被拒绝：使用 expected_hashes 时，符号有变动就会拒绝写入。重新读取、调整后再试。
• 出现用量警告：限额是软上限。超出时响应会附带 usage_notice，智能体不会被阻止。
• pre-commit 关卡误拦：用 git commit --no-verify 跳过。