跳至内容

MCP 与 Bridge

MCP 集成和 Bridge 跨界面连接构成了 Claude Code 扩展织物的两条核心通道——一条向外接入外部工具能力,一条向内连接多端界面。

核心问题

Agent 系统如何在不修改核心代码的情况下接入外部能力?如何让同一个 agent 同时支持 CLI、IDE、Desktop 和 Mobile?MCP 和 Bridge 分别回答了这两个问题。

MCP 集成

传输层

Claude Code 支持 6 种 MCP 传输方式:

传输说明
stdio标准输入输出,本地进程通信
SSEServer-Sent Events,HTTP 长连接
HTTP标准 HTTP 请求/响应
WebSocket全双工通信
SDKAnthropic SDK 原生集成
claude.ai proxy通过 claude.ai 中转

配置范围

MCP 服务器可以在 7 个配置范围中注册:

范围生效范围典型用途
全局用户配置所有项目通用工具(搜索、浏览器)
项目 .mcp.json单个项目项目专用工具
CLAUDE.md 声明项目/本地轻量级工具声明
插件内嵌插件范围插件附带的 MCP 服务器
环境变量会话级临时覆盖
SDK 模式程序化使用SDK 客户端提供
IDE 配置IDE 范围VS Code / JetBrains 集成

工具命名与注册

MCP 工具以 mcp__<server>__<tool> 模式命名,动态注册到工具系统中。这意味着 MCP 工具与内建工具共用:

  • 相同的权限检查流程
  • 相同的执行编排(并行/串行分区)
  • 相同的结果预算机制
  • 相同的 Hook 拦截点

这种"统一工具面"的设计让外部工具无法绕过治理体系。

OAuth 2.0 + PKCE

远程 MCP 服务器的认证采用 OAuth 2.0 + PKCE 流程,支持:

  • 授权码模式(适合有浏览器的环境)
  • 设备码模式(适合纯 CLI 环境)
  • Token 缓存与刷新

Bridge 跨界面连接

多端架构

Bridge 不是实验功能,而是已集成的跨界面连接能力。它让同一个 Claude Code 实例能够被多种界面访问:

连接端命令入口用途
IDEsrc/commands/ideVS Code、JetBrains 等编辑器
Desktopsrc/commands/desktopElectron 桌面应用
Mobilesrc/commands/mobile移动端控制
Chromesrc/commands/chrome浏览器扩展

邮箱机制

Bridge 通过 Mailbox 实现跨界面消息传递:

  • src/utils/mailbox.ts — 消息邮箱核心
  • src/context/mailbox.tsx — 邮箱 UI 上下文

消息邮箱是异步的——发送方不需要等待接收方在线。这使得 CLI 可以在后台运行,而 IDE 界面随时连接/断开。

    flowchart TB
    subgraph Core ["Claude Code 核心"]
        Agent["Agent Loop"]
        Bridge["Bridge 服务<br/>src/bridge/"]
        Mailbox["Mailbox<br/>消息队列"]
    end

    subgraph MCP_Layer ["MCP 通道"]
        MCP1["stdio MCP Server"]
        MCP2["HTTP MCP Server"]
        MCP3["claude.ai Proxy"]
    end

    subgraph UI_Layer ["界面通道"]
        CLI["CLI 终端"]
        IDE["VS Code / JetBrains"]
        Desktop["Desktop App"]
        Mobile["Mobile"]
    end

    Agent --> Bridge
    Agent --> MCP1
    Agent --> MCP2
    Agent --> MCP3

    Bridge --> Mailbox
    Mailbox --> CLI
    Mailbox --> IDE
    Mailbox --> Desktop
    Mailbox --> Mobile
  

两条通道的交汇

MCP 和 Bridge 在扩展织物中的角色不同但互补:

维度MCPBridge
方向向外:接入外部能力向内:连接多端界面
注册时机配置时或运行时发现进程启动时
通信模式请求/响应消息邮箱(异步)
治理统一工具面独立连接管理

两者在一些场景中交汇:IDE 可以通过 Bridge 连接到 Claude Code,而 Claude Code 又通过 MCP 连接到 IDE 提供的 LSP 服务。

对 agent 开发者的启示

模式说明
统一工具面外部工具(MCP)和内建工具共用同一套治理,不设后门
多传输适配不要假设用户只有一种网络环境——支持从 stdio 到 WebSocket 的多种传输
异步邮箱跨界面通信不要求双方同时在线——消息队列是更稳健的选择
配置分层全局 → 项目 → 插件 → 会话,让用户在合适的范围覆盖配置

路径证据

路径职责
src/services/mcp/MCP 集成核心
src/bridge/Bridge 服务核心
src/utils/mailbox.ts消息邮箱机制
src/context/mailbox.tsx邮箱 UI 上下文
src/commands/bridgeBridge 命令入口
src/commands/ideIDE 集成命令

进一步阅读

  1. 架构地图 — 扩展织物在六层结构中的位置
  2. 工具平面 — MCP 工具的注册和治理
  3. 插件系统 — 插件如何内嵌 MCP 服务器
  4. 扩展与信号 — Bridge 的成熟度判定