Brave DevTools MCP

エージェント向け Brave DevTools

Chrome DevTools MCP と完全な機能互換性を備え、Brave 向けに再構築しました。

brave-mcp を使うと、Claude Code、Codex、Cursor、OpenCode、その他の MCP クライアントから Brave に直接アクセスし、ブラウザーの自動化、ネットワークとコンソールのデバッグ、パフォーマンス分析、スクリーンショット、アクセシビリティの検査、メモリのプロファイリングを行えます。単体で使える brave-devtools CLI も含まれています。

1 つのコマンドでインストール

以下のコマンドでは --autoConnect を使用します。これにより brave-mcp がすでに開いている Brave に接続され、エージェントは実際のタブやサインイン済みのセッションを操作できます。一度有効にしてください。Brave で brave://inspect/#remote-debugging を開き、このブラウザーインスタンスのリモートデバッグを許可するにチェックを入れます。Brave はこの設定を再起動後も保持します。

Claude Code

claude mcp add brave-devtools --scope user -- npx -y brave-mcp@latest --autoConnect

Cursor

cursor --add-mcp '{"name":"brave-devtools","command":"npx","args":["-y","brave-mcp@latest","--autoConnect"]}'

Codex

codex mcp add brave-devtools -- npx -y brave-mcp@latest --autoConnect

OpenCode

opencode mcp add brave-devtools -- npx -y brave-mcp@latest --autoConnect

クライアントを再起動して、次のプロンプトを試してください。

Brave で自分のアプリを開いてください。コンソールエラーと失敗したネットワークリクエストを見つけ、アクセシビリティツリーを調べ、Lighthouse を実行して、最も影響の大きい問題を説明してください。

エージェントが接続すると、Brave が許可を求めます。許可をクリックしてください。

--autoConnect は、--channel beta または --channel nightly を追加しない限り、Brave Release に接続します。エージェントを普段使いのブラウザーから分離するには、--autoConnect を省略してください。サーバーは専用プロファイルで独自の Brave を起動します。

Chrome DevTools MCP ではなく、これを使う理由は？

機能	brave-mcp	chrome-devtools-mcp
ブラウザーのネイティブな起動と検出	Brave Release、Beta、Nightly	Chrome Stable、Beta、Dev、Canary
既存ブラウザーへの接続	Brave のプロファイル、HTTP、または WebSocket	Chrome のプロファイル、HTTP、または WebSocket
上流の DevTools 機能	完全な互換性。現在、遅れは 0 コミットです	ソース実装
使用状況のテレメトリー	デフォルトで無効	デフォルトで有効
単体で使える CLI	brave-devtools	chrome-devtools

対象のブラウザーが Chrome の場合は、Chrome DevTools MCP をお使いください。対象が Brave で、上流の機能を維持しながら、Brave ネイティブの検出、プロファイル、チャンネル、名称、プライバシー設定を使いたい場合は brave-mcp をお使いください。

ツールリファレンス | 変更履歴 | コントリビューション | トラブルシューティング | 設計原則

主な機能

• パフォーマンスに関する分析情報を取得：Chrome DevTools を使用してトレースを記録し、実行可能なパフォーマンス分析情報を抽出します。
• 高度なブラウザーのデバッグ：ネットワークリクエストの分析、スクリーンショットの撮影、ブラウザーコンソールのメッセージの確認（ソースマップ付きスタックトレースを含む）ができます。
• 信頼性の高い自動化。puppeteer を使用して Brave での操作を自動化し、操作結果が得られるまで自動的に待機します。

免責事項

brave-mcp はブラウザーインスタンスのコンテンツを MCP クライアントに公開し、ブラウザーや DevTools 内のあらゆるデータの確認、デバッグ、変更を可能にします。MCP クライアントと共有したくない機密情報や個人情報は共有しないでください。

brave-mcp は Brave の現行リリースを正式にサポートしています。Beta チャネルと Nightly チャネルは明示的に選択できます。

パフォーマンスツールは、実際のユーザーの利用データを取得するため、トレース URL を Google CrUX API に送信する場合があります。これにより、フィールドデータをラボデータと併せて提示し、パフォーマンスを包括的に把握できます。このデータは Chrome User Experience Report (CrUX) によって収集されます。無効にするには、--no-performance-crux フラグを指定して実行してください。

使用統計

このフォークでは、使用統計の収集はデフォルトで無効になっています。上流の Google Clearcut 実装を使用する --usage-statistics で明示的に有効にできます。

"args": ["-y", "brave-mcp@latest", "--usage-statistics"]

有効にした場合、Google はGoogle プライバシー ポリシーに従ってこのデータを取り扱います。BRAVE_DEVTOOLS_MCP_NO_USAGE_STATISTICS または CI が設定されている場合、収集は無効のままです。

アップデートの確認

デフォルトでは、サーバーは定期的に npm レジストリでアップデートを確認し、新しいバージョンがある場合は通知をログに記録します。 BRAVE_DEVTOOLS_MCP_NO_UPDATE_CHECKS を設定すると、これらのアップデート確認を無効にできます。

要件

• Node.js の LTS バージョン。
• Brave の現行リリース以降。
• npm

はじめに

brave://inspect/#remote-debugging でリモートデバッグを一度有効にしてから、実行中の Brave に接続するため、以下の設定を MCP クライアントに追加してください。

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

メモ

brave-mcp@latest を使用すると、MCP クライアントは常に最新バージョンの Brave DevTools MCP サーバーを使用します。

専用プロファイルでサーバー独自の Brave を起動するには、--autoConnect を省略してください。

基本的なブラウザー操作のみを行う場合は、--slim モードを使用してください。

{
  "mcpServers": {
    "brave-devtools": {
      "command": "npx",
      "args": ["-y", "brave-mcp@latest", "--slim", "--headless"]
    }
  }
}

スリム版ツールのリファレンスをご覧ください。

MCP クライアントの設定

エディターやエージェント（例：Antigravity、Claude Code、Cursor、VS Code）に固有のセットアップ手順については、クライアント設定ガイドをご覧ください。実行中の Brave に接続するには、そこに記載されているサーバー引数に --autoConnect を追加してください。

最初のプロンプト

すべてが正常に動作することを確認するには、MCP クライアントに以下のプロンプトを入力してください。

Check the performance of https://brave.com

Brave から接続を許可するよう求められます。許可をクリックすると、MCP クライアントが Brave でページを開き、パフォーマンストレースを記録します。

メモ

MCP サーバーは、クライアントの起動時ではなく、MCP クライアントがブラウザーを必要とするツールを初めて使用したときに Brave に接続します。--autoConnect を指定しない場合、その時点でサーバーが独自の Brave を起動します。

ツール

問題が発生した場合は、トラブルシューティングガイドをご確認ください。 サポートされている MCP 機能の全一覧については、ツールのリファレンスをご覧ください。

設定

サーバーパラメーター（例：--headless、--isolated、--slim）の全一覧と、WebSocket 接続の設定方法については、設定ガイドをご覧ください。

高度な使用方法

同時セッションの処理、永続的なユーザーデータディレクトリ、新しい Brave を起動する代わりに実行中の Brave インスタンスへの接続、Android でのデバッグなどの高度な機能については、高度な使用方法ガイドをご覧ください。

既知の制限事項

トラブルシューティングをご覧ください。

ブラウザーサブエージェントとしての統合

エージェント型ツールを開発しており、製品の一部として統合されたブラウザーサブエージェントを提供したい場合は、Brave DevTools for agents を基盤として構築することをおすすめします。

参考実装については、Gemini CLI ブラウザーエージェントのドキュメントをご覧ください。