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

​
アカウントを接続する

Claude や Codex などの OAuth 対応の対話型クライアントでは、このモードを使用します。この URL をクライアントに追加すると、Firecrawl’s の認可メタデータが検出され、ブラウザが開いて、使用するチームの承認を求められます。
クライアントには、Firecrawl APIキーではなく、有効期間が短くリソースに紐づいたトークンが渡されます。MCP設定でアクセスを確認・取り消しできます。
クライアントからOAuth Client IDまたはClient Secretの入力を求められた場合は、どちらも空欄のままにしてください。互換性のあるクライアントでは、Client ID Metadata Documentsまたは動的クライアント登録が使用されます。

​
無人実行

CI、サーバー、スクリプト、またはブラウザを利用できないランタイムでは、このモードを使用します。API キーは環境変数またはシークレットストアに保存し、Authorization ヘッダーとして送信します。
Firecrawl MCP のすべてのツールを使用します。新しい構成では、API キーを URL に含めたり、プロジェクトの構成ファイルにコミットしたりしないでください。

​
キーなしで試す

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

​
無料利用上限に達した場合

キーなしの利用枠は、ネットワークごとに適用されるローリング制限です。利用可能な場合、MCP エラーには次回の再試行可能時刻が含まれます。その時刻まで待てば、アカウントなしで Search、Scrape、Parse を引き続き使用できます。 すぐに続行するには、次のいずれかを選択してください。
  • 対話型 OAuth: アカウントエンドポイント https://mcp.firecrawl.dev/v2/mcp-oauth に接続します。Claude Code の場合:
    次に /mcp を実行し、ブラウザで認証します。
  • ユーザー操作なしの API キー: Firecrawl dashboard でキーを作成し、Authorization: Bearer <FIRECRAWL_API_KEY> を設定します。

​
適切なモードを選択する

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

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

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

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

このレガシー形式は、OAuth を完了できない、またはカスタム Authorization ヘッダーを送信できない既存の構成やクライアント向けにのみ提供されています。新しいインテグレーションには推奨されません。
API キーは URL の一部であるため、URL 全体をパスワードと同様に扱ってください。クライアントが対応している場合は、アカウント OAuth または環境変数で管理された Authorization: Bearer header を使用してください。この URL が漏洩した場合は、API キーをローテーションしてください。チャット、スクリーンショット、issue、共有構成に貼り付けないでください。 このフォールバックは、/v2/mcp の全機能にのみ適用されます。OAuth 専用の search resource では機能しません。

​
移行中の互換性

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