MCPサーバーの設定

前提条件

• Node.js 22.0.0 以降 —— ローカルで MCP サーバープロセスを実行するために必要

MCPサーバーを追加

Model Context Protocol をサポートする AI アプリケーションに DevBridge MCP サーバーの設定を追加します。対応アプリケーションの例：

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

サーバー設定

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

初回実行時の動作： npx -y devbridge-mcp@latest の初回実行時に、Chrome がローカル MCP サーバーと通信できるよう、ネイティブメッセージングホストの manifest が自動的にインストールされます。これは初回のみの処理で、以降の実行はすぐに開始されます。

ツール別の設定手順

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__* ワイルドカードで 25 個すべての 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 に追加してください（最上位キーは mcpServers ではなく servers であることに注意）：

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

ツールの承認： VS Code は各 MCP ツールの初回使用時に承認通知を表示します。Allow をクリックして承認してください。

詳細は VS Code の MCP ドキュメント を参照してください。

Codex

Codex CLI、デスクトップアプリ（macOS および Windows）、IDE 拡張機能に対応しています —— 3 つはすべて同じ設定ファイルを共有するため、一度だけ設定すれば完了です。

方法 A —— CLI ワンラインコマンド：

codex mcp add devbridge -- npx -y devbridge-mcp@latest

方法 B —— 設定ファイルを直接編集：

~/.codex/config.toml を開きます（デスクトップアプリでは MCP Settings → Open config.toml から開けます）：

[mcp_servers.devbridge]
command = "npx"
args = ["-y", "devbridge-mcp@latest"]

ファイルを保存して Codex を再起動すると、すべての DevBridge ツールが自動的に使用可能になります。

詳細は Codex MCP ドキュメント を参照してください。

→ 次へ：クイックスタート