ホスト型の 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 キーを使用してください。
構成例については、クライアントのセットアップを参照してください。クライアントがリモート OAuth フローを完了できない場合は、代わりに無人のヘッダーベース構成またはキーなしモードを使用してください。カスタムヘッダーも送信できない場合は、以下のレガシーフォールバックを参照してください。
このレガシー形式は、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では受け付けられません。