配置 MCP 服务器

前置要求

• Node.js 22.0.0 或更高版本 —— 用于在本地运行 MCP 服务器进程

添加 MCP 服务器

将 DevBridge MCP 服务器配置添加到任何支持 Model Context Protocol 的 AI 应用。受支持的应用举例：

• Claude Code
• Cursor
• Claude Desktop
• Windsurf
• VS Code

服务器配置

{
  "mcpServers": {
    "devbridge": {
      "command": "npx",
      "args": ["devbridge-mcp@latest"]
    }
  }
}

首次运行时会发生什么： npx devbridge-mcp@latest 首次运行时会自动安装 native messaging host manifest，使 Chrome 能够与本地 MCP 服务器通信。这是一次性配置，后续运行会直接启动。

各工具配置步骤

Claude Code

1. 在项目根目录创建或编辑 .mcp.json
2. 添加上述服务器配置
3. 在该项目中重启 Claude Code —— DevBridge 会出现在 MCP 工具列表中
4. 在项目的 .claude/settings.local.json 中添加以下配置，预先批准所有 DevBridge 工具：

{
  "permissions": {
    "allow": ["mcp__devbridge__*"]
  }
}

为什么需要这一步： Claude Code 对每个 MCP 工具都需要明确授权。不添加此配置时，每个工具首次调用会弹出批准对话框。在非交互式环境（CI、无终端弹窗场景）中，未经批准的工具会被静默拒绝并返回"user rejected"，不会有任何弹窗提示。mcp__devbridge__* 通配符一次性批准全部 18 个 DevBridge 工具。

更多信息见 Claude Code 的 MCP 文档。

Cursor

1. 打开 Cursor 完整设置
2. 切换到 Tools 标签页
3. 点击 New MCP server
4. 添加上述服务器配置
5. 点击 devbridge 服务器旁的刷新按钮重新加载配置

工具授权： Cursor 会在每个 MCP 工具首次调用时弹出批准提示，点击 Allow 即可。

更多信息见 Cursor 的 MCP 文档。

Claude Desktop

将上述服务器配置添加到 claude_desktop_config.json，然后重启 Claude Desktop。

注意： Claude Desktop 存在一个已知问题：MCP 服务器会被启动两次。启动时可能短暂显示错误提示，但 DevBridge 仍可正常工作。

更多信息见 Claude 的 MCP 快速上手。

Windsurf

通过 Windsurf 的 MCP 设置入口添加上述服务器配置。

更多信息见 Windsurf 的 MCP 文档。

VS Code

VS Code 通过 GitHub Copilot 的 agent 模式支持 MCP。将以下配置添加到工作区的 .vscode/mcp.json（注意顶层键是 servers，不是 mcpServers）：

{
  "servers": {
    "devbridge": {
      "command": "npx",
      "args": ["devbridge-mcp@latest"]
    }
  }
}

工具授权： VS Code 会在每个 MCP 工具首次调用时弹出批准通知，点击 Allow 即可。

更多信息见 VS Code 的 MCP 文档。

→ 下一步：快速开始