Firecrawl MCP に接続

アカウント OAuth、無人 API キー、またはキーなしの Firecrawl MCP セットアップを選択します。

ホスト型の Firecrawl MCP サービスは、3 つのモードで利用できます。ユーザーがサインインできるか、クライアントが API キーを安全に保存できるかに応じて選択してください。

アカウントを接続する

Claude や Codex などの OAuth 対応の対話型クライアントでは、このモードを使用します。この URL をクライアントに追加すると、Firecrawl’s の認可メタデータが検出され、ブラウザが開いて、使用するチームの承認を求められます。

https://mcp.firecrawl.dev/v2/mcp-oauth

クライアントには、Firecrawl APIキーではなく、有効期間が短くリソースに紐づいたトークンが渡されます。MCP設定でアクセスを確認・取り消しできます。

クライアントからOAuth Client IDまたはClient Secretの入力を求められた場合は、どちらも空欄のままにしてください。互換性のあるクライアントでは、Client ID Metadata Documentsまたは動的クライアント登録が使用されます。

無人実行

CI、サーバー、スクリプト、またはブラウザを利用できないランタイムでは、このモードを使用します。API キーは環境変数またはシークレットストアに保存し、Authorization ヘッダーとして送信します。

https://mcp.firecrawl.dev/v2/mcp
Authorization: Bearer <FIRECRAWL_API_KEY>

Firecrawl MCP のすべてのツールを使用します。新しい構成では、API キーを URL に含めたり、プロジェクトの構成ファイルにコミットしたりしないでください。

キーなしで試す

このモードでは、アカウントやAPIキーなしでFirecrawlを試すことができます。

https://mcp.firecrawl.dev/v2/mcp

Keyless MCP は IP アドレスごとにレート制限があり、利用条件を満たしている場合は Search、Scrape、Parse のみ利用できます。すべてのツール機能やより高い上限が必要な場合は、アカウントを接続するか、API キーを使用してください。

適切なモードを選択する

モード	エンドポイント	利用可能なツール	最適な用途	認証情報
アカウント	`/v2/mcp-oauth`	プランと機能の提供状況に応じたすべてのMCPツール	ブラウザでOAuthを完了できる対話型クライアント	クライアントが管理するOAuthトークン
ユーザー操作なし	`/v2/mcp`	プランと機能の提供状況に応じたすべてのMCPツール	CI、サーバー、スクリプト	`Authorization: Bearer <FIRECRAWL_API_KEY>`
キーなし	`/v2/mcp`	Search、Scrape、Parseのみ	制限付きトライアル	なし

現在利用可能なツールと、ローカル環境およびセルフホスト環境での利用可否については、ツールとオペレーションを参照してください。

クライアント固有のヘルプ

構成例については、クライアントのセットアップを参照してください。クライアントがリモート OAuth フローを完了できない場合は、代わりに無人のヘッダーベース構成またはキーなしモードを使用してください。カスタムヘッダーも送信できない場合は、以下のレガシーフォールバックを参照してください。

レガシー API キー URL のサポート

このレガシー形式は、OAuth を完了できない、またはカスタム Authorization ヘッダーを送信できない既存の構成やクライアント向けにのみ提供されています。新しいインテグレーションには推奨されません。

https://mcp.firecrawl.dev/<FIRECRAWL_API_KEY>/v2/mcp

API キーは URL の一部であるため、URL 全体をパスワードと同様に扱ってください。クライアントが対応している場合は、アカウント OAuth または環境変数で管理された Authorization: Bearer header を使用してください。この URL が漏洩した場合は、API キーをローテーションしてください。チャット、スクリーンショット、issue、共有構成に貼り付けないでください。

このフォールバックは、/v2/mcp の全機能にのみ適用されます。OAuth 専用の search resource では機能しません。

移行中の互換性

専用のアカウントエンドポイントへの移行期間中も、既存の/v2/mcp OAuth接続は引き続きサポートされます。新しい対話型アカウント接続には/v2/mcp-oauthを使用してください。このアカウントリソース用に新たに発行されたトークンは、/v2/mcpでは受け付けられません。