Claude Media
Brave Search MCPサーバーの設定ガイド — Claude Desktopでの使い方
ClaudeMCPClaude連携チュートリアル

Brave Search MCPサーバーの設定ガイド — Claude Desktopでの使い方

Brave Search MCPサーバーをClaude Desktopに設定する手順です。APIキーの取得、config.jsonの書き方、8種類の検索ツール、旧パッケージからの移行点まで扱います。

読了目安 約10分

Brave Search MCPサーバーは、BraveのWeb検索・画像検索・動画検索・ニュース検索・ローカル検索などをまとめてClaude Desktopから呼び出せるようにするMCPサーバーです。以前から出回っている設定例の多くはAnthropicが公開した参照実装を使っていますが、このパッケージはnpm上で既に非推奨(deprecated)と表示されており、新規の設定には使えません。本稿では、Brave公式の現行パッケージを使ったAPIキーの取得からclaude_desktop_config.jsonへの追加、使える検索ツールの一覧、旧パッケージからの移行点、よくあるつまずきまでを順に確認します。

Brave Search MCPサーバーとは

Brave Search MCPサーバー(@brave/brave-search-mcp-server)とは、Brave Search APIの検索機能をMCP経由でAIエージェントに提供する、Brave Software公式のnpmパッケージです。GitHubのbrave/brave-search-mcp-serverリポジトリで開発が続いています。公式のMCPサーバーレジストリにもio.github.brave/brave-search-mcp-serverとして登録されています。

最新バージョンは2.1.3です。Web検索・ローカル検索・動画検索・画像検索・ニュース検索・地点検索(Place)の6種類の検索ツールに加えて、検索結果をAIが要約するSummarizerと、RAG向けにWebコンテンツを整形して返すLLM Contextの2種類を提供します。合わせて計8種類のツールです。検索そのものを返すツールと、検索結果をAI向けに加工するツールが分かれている点は、他のMCP検索サーバーにあまり見られない構成です。

以前からある@modelcontextprotocol/server-brave-searchは、Anthropicが公開していた参照実装です。npmのパッケージ情報には「Package no longer supported」という非推奨の注記が付いており、サポートは終了しています。この記事で扱う設定は、すべて現行の@brave/brave-search-mcp-serverを対象にします。

APIキーを取得する

Brave Search MCPサーバーを使うには、先にBrave Search APIのAPIキーを発行します。無料クレジットの範囲内でも動作確認は可能です。

  1. Brave Search APIのページからアカウントを登録する(不正利用対策のため、クレジットカード情報の入力を求められます)
  2. 開発者ダッシュボードでプランを選び、APIキーを発行する

料金プランは用途によって2種類に分かれます。

プラン料金上限主な用途
Search Plan料金$5 / 1,000リクエスト上限50クエリ/秒主な用途Web・画像・動画・ニュース・ローカル・地点検索
Answers Plan料金$4 / 1,000リクエスト + $5 / 100万トークン上限2クエリ/秒主な用途AI生成の要約回答(Summarizer)

どちらのプランにも毎月$5分の無料クレジットが自動付与されます。Search Planなら月あたり約1,000リクエスト相当が無料枠に収まる計算です。クレジットカードの登録自体は本人確認のための措置で、無料枠の範囲内であれば請求は発生しません。Claude Desktopから対話的に使う分には、Search Planの50クエリ/秒という上限に達することはまずありません。

Answers Planは$4/1,000リクエストに加えて$5/100万トークンのAI生成コストが乗ります。Summarizerを高頻度で呼ぶ使い方だと、Search Planより割高になりやすい点は覚えておきます。単発の検索結果をそのまま使うならSearch Plan、要約まで一気に受け取りたい場面だけAnswers Planを併用する、という切り分けが無駄なく運用しやすい選び方です。

Claude Desktopへの設定ファイルの書き方

claude_desktop_config.jsonへの追記だけで、Brave Search MCPサーバーをClaude Desktopに登録できます。設定ファイルの場所はOSごとに決まっています。

OSパス
macOSパス~/Library/Application Support/Claude/claude_desktop_config.json
Windowsパス%APPDATA%\Claude\claude_desktop_config.json

Claude Desktopの「Settings」→「Developer」タブ→「Edit Config」からも同じファイルを開けます。ファイル自体の構造やmcpServersキーの基本的な書き方はClaude Desktop MCP設定ガイドで扱った内容と共通です。

設定ファイルに次の内容を追記します。YOUR_API_KEY_HEREの部分は取得したAPIキーに置き換えます。

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "http"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Node.jsを事前にインストールしたくない場合は、Dockerでも同じサーバーを起動できます。

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "docker.io/mcp/brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

保存後はClaude Desktopを完全に終了してから再起動します。ウィンドウを閉じるだけではプロセスが常駐したままなので、メニューから「Quit」を選ぶ必要があります。再起動後、入力欄下の「+」ボタンから「brave-search」のツールが表示されていれば接続は成功です。

接続を確認できたら、チャットで「最近のAI関連ニュースを検索して」のようにWeb検索が必要な質問を送ります。Claudeがbrave_web_searchの呼び出しを提案し、許可するとBrave Search APIへのリクエストが実際に飛ぶ様子をその場で確認できます。

使えるツールの一覧

Brave Search MCPサーバーが登録するツールは8種類です。用途に応じて使い分けます。

ツール名検索対象主な用途
brave_web_search検索対象Web全般主な用途一般的なWeb検索。最大400文字・50語のクエリに対応
brave_local_search検索対象店舗・施設主な用途営業時間や評価を含む店舗検索(Proプラン推奨、それ以外はWeb検索にフォールバック)
brave_video_search検索対象動画主な用途サムネイル付きの動画検索結果を取得
brave_image_search検索対象画像主な用途画像URLと寸法情報を取得(v2でbase64データの返却を廃止し軽量化)
brave_news_search検索対象ニュース主な用途既定で直近24時間に絞った速報性の高い検索
brave_place_search検索対象地点情報主な用途緯度経度や地名から周辺の施設を検索
brave_summarizer検索対象要約主な用途Web検索結果をAIで要約(先にbrave_web_searchをsummary: trueで実行しておく)
brave_llm_context検索対象RAG向け抽出主な用途LLMのグラウンディング用に整形済みのWebコンテンツを抽出

旧パッケージからの移行点

検索して見つかる設定例の多くは@modelcontextprotocol/server-brave-searchを使っていますが、このパッケージは既に非推奨のため新規の設定には向きません。すでに旧パッケージで動かしている環境からも、書き換えはcommandとargsの値だけで済みます。

観点旧パッケージ(非推奨)現行パッケージ
パッケージ名旧パッケージ(非推奨)@modelcontextprotocol/server-brave-search現行パッケージ@brave/brave-search-mcp-server
提供元旧パッケージ(非推奨)Anthropic(参照実装)現行パッケージBrave Software(公式)
ツール数旧パッケージ(非推奨)2種類(Web・ローカル検索のみ)現行パッケージ8種類
通信方式の既定旧パッケージ(非推奨)STDIOのみ現行パッケージSTDIO(v2.xの既定。--transport httpでHTTP切り替え可)
画像検索の応答旧パッケージ(非推奨)base64データを含む現行パッケージv2でURLベースの応答に軽量化

envに指定するBRAVE_API_KEYのキー自体は共通なので、APIキーを取り直す必要はありません。argsのパッケージ名を差し替えるだけで移行が完了します。

旧パッケージの設定例が今も検索で上位に出やすいのは、Brave自身が公開しているガイドの一つが2025年5月の公開以降更新されておらず、旧パッケージのコマンド例を掲載し続けているためです。ブログや質問サイトの多くはそのガイドを参照しているため、コピー元をたどると同じ非推奨パッケージに行き着くケースが目立ちます。移行先のパッケージ名さえ分かれば書き換え自体は数分で終わるため、動かなくなってから調べるより先に現行パッケージへ揃えておくほうが手戻りは少なくなります。

よくあるつまずき

APIキーのエラーが返る。無料クレジットを使い切っていないか、発行したキーが想定しているプランに紐づいているかを開発者ダッシュボードで確認します。コピー時に前後へ空白が混入するミスも典型的な原因です。

ツールが表示されない。設定ファイルを保存した後にClaude Desktopを完全終了せず、再起動しただけのケースが大半です。JSON構文エラーがないかもあわせて確認します。

Node.jsのインストール方法で失敗する。Windows環境でnode installerを使うと、npx経由のMCPサーバー起動でエラーが出る場合があります。node version manager(nvm等)経由のインストールに切り替えると解消することがあります。

Summarizerが動かない。brave_summarizerは単体では使えません。先にbrave_web_searchをsummary: true付きで実行し、返ってきたsummary keyを渡す2段階の呼び出しが必要です。この挙動を知らずにbrave_summarizerだけを直接呼ぼうとして失敗するケースが多く見られます。

無料枠だけでは足りなくなる。無料クレジットは月$5分で自動更新されますが、使い切ると追加分がカード請求されます。テスト運用中はダッシュボードの使用量表示を定期的に確認しておくと安心です。

HTTPトランスポートでポートが衝突する。--transport httpを指定した場合、既定のポート8080が別プロセスに使われていると起動に失敗します。BRAVE_MCP_PORT環境変数で別のポート番号を指定すれば回避できます。

まとめ

Brave Search MCPサーバーは、Brave Search APIのWeb・画像・動画・ニュース・ローカル・地点検索とAI要約をまとめてClaude Desktopから呼び出せるようにする公式パッケージです。設定はAPIキーの発行とclaude_desktop_config.jsonへの追記だけで完了し、既に@modelcontextprotocol/server-brave-searchを使っている場合もパッケージ名の書き換えだけで移行できます。まずは無料クレジットの範囲で動作を確認し、必要に応じてSearch PlanかAnswers Planを選ぶ進め方が手堅い選択です。MCPサーバーの権限管理やAPIキーの扱いについてはMCPセキュリティガイドも参照してください。Claude Codeから同じサーバーを使いたい場合はClaude Code MCP設定ガイドの手順で追加できます。

この記事を共有:XはてブLinkedIn

関連する記事

Claude をもっと見る →