Skip to main content
GitHub Copilot CLI または VS Code の Copilot をホスト型MCPサーバー経由で Firecrawl に接続し、Firecrawl アカウントでサインインします。Copilot コーディングエージェントの場合は APIキーで接続します。 以下のサーバーURLはクライアントに設定する構成値です。ブラウザーで直接開くページではありません。

Copilot CLI

  1. Firecrawl を追加する

これにより、サーバーの設定が ~/.copilot/mcp-config.json に書き込まれます。対話型セッション内で /mcp add を実行して HTTP 型を選択するか、ファイルを直接編集することもできます。
~/.copilot/mcp-config.json

  1. サインインして確認する

初回接続時には、Copilot CLI がブラウザーで Firecrawl の sign-in フローを開きます。画面の案内に従って Team を選択し、接続を承認してください。/mcp と入力し、firecrawl が接続されていることを確認します。

代わりにAPIキーを使用する

ユーザー操作なしで使用する場合は、Firecrawl APIキーを作成して FIRECRAWL_API_KEY としてエクスポートし、Bearerヘッダーを指定してAPIキー用のエンドポイントを追加します。
キーは ~/.copilot/mcp-config.json に保存されるため、このファイルはバージョン管理に含めないでください。

VS Code

  1. Firecrawl を追加する

コマンドパレットから MCP: Add Server を実行して HTTP を選択するか、ワークスペースに .vscode/mcp.json を作成します。
.vscode/mcp.json
すべてのワークスペースでこのサーバーを使用できるようにするには、MCP: Open User Configuration を実行し、そこにも同じエントリを追加します。

  1. サインインと動作確認

mcp.json エディター、または MCP: List Servers からサーバーを開始します。VS Code から認証を求められたら許可し、ブラウザーで Firecrawl の sign-in を完了します。次に、Copilot Chat を Agent モードで開き、ツールアイコンを選択して、Firecrawl のツールが一覧に表示されていることを確認します。

代わりにAPIキーを使用する

APIキー用のエンドポイントを使用し、キーの入力はVS Codeのプロンプトに任せます。これにより、キーはファイルに書き込まれることなく安全に保存されます。
.vscode/mcp.json

Copilot コーディングエージェント

Copilot コーディングエージェント (Copilot クラウドエージェントとも呼ばれます) は、GitHub 上のイシューやプルリクエストを処理します。リポジトリのMCP設定は OAuth を使用するリモートサーバーに対応していないため、このセットアップでは Firecrawl APIキーを Agents シークレットとして保存し、ヘッダーで送信します。

要件

  • 有料の GitHub Copilot プラン (対象リポジトリでコーディングエージェントが有効になっていること)
  • リポジトリの管理者権限 (MCP設定と Agents シークレットの編集に必要)
  • Firecrawl APIキー

セットアップ

  1. リポジトリで Settings、Secrets and variables、Agents の順に開きます。
  2. New repository secret を選択し、名前を COPILOT_MCP_FIRECRAWL_API_KEY に設定して Firecrawl APIキーを貼り付け、保存します。Copilot が MCP サーバーに渡すのは、名前が COPILOT_MCP_ で始まる Agents シークレットだけです。
  3. Settings、Copilot、MCP servers の順に開きます。
  4. 次の構成を MCP configuration に貼り付け、Save MCP configuration を選択します。
  1. イシューを Copilot に割り当てます。プルリクエストが作成されたら View session を選択し、ログ内の Start MCP Servers ステップを開いて、Firecrawl のツールが一覧に表示されていることを確認します。
Copilot は、tools リスト内のツールを承認なしで使用します。リストにはエージェントが必要とするツールだけを含めてください。"*" は、Firecrawl のすべてのツールを利用可能にしたい場合にのみ使用してください。

試してみる

Firecrawl MCP のツール一覧については、ツールを選択するを参照してください。

トラブルシューティング

  • ツールが表示されない: firecrawl サーバーが 1 つだけ設定されていることを確認してから Copilot CLI を再起動してください。VS Code の場合は MCP: List Servers を実行し、サーバーを再起動してください。
  • 再度 sign-in が求められる、または 401 が返される: サーバーを再起動し、ブラウザーで sign-in を完了してください。なお、認証前に OAuth サーバーへ単純なリクエストを送ると 401 が返されますが、これは想定どおりの動作です。
  • API キーによる接続で 401 が返される: URL が https://mcp.firecrawl.dev/v2/mcp (/v2/mcp-oauth ではありません) であること、およびヘッダーが Authorization: Bearer <FIRECRAWL_API_KEY> であることを確認してください。
  • 組織のポリシー: GitHub 組織で Copilot の MCP サーバー利用が制限されている場合、Firecrawl に接続するには管理者による許可が必要です。
  • コーディングエージェント: セッションログに Firecrawl のツールが表示されない: シークレット名が COPILOT_MCP_FIRECRAWL_API_KEY と完全に一致していること、また Actions シークレットではなく Agents シークレットとして登録されていることを確認してください。