Skip to main content
ユーザーがサインインしてアクセスを承認する場合は、Firecrawlのaccountエンドポイントを使用します。クライアントは、生のFirecrawl APIキーではなく、短期間のみ有効でリソースに紐付けられたトークンを受け取ります。 アカウントOAuth、無人でのAPIキーアクセス、キーレスアクセスの使い分けについては、Firecrawl MCPに接続するを参照してください。

​
対話型クライアントを接続する

互換性のある対話型クライアントで、次を指定します。
クライアントからOAuth クライアントIDまたはクライアントシークレットの入力を求められた場合は、どちらも空欄のままにしてください。対応クライアントは、クライアントID Metadata Documentsまたは動的クライアント登録を使用して自身を識別します。 クライアントによってブラウザでFirecrawlが開きます。サインインし、コネクタで使用するチームを選択して、同意リクエストを確認し、アクセスを承認します。リクエストの料金は選択したチームに請求されます。 ChatGPTとClaudeでは設定画面やワークスペースのルールが異なるため、それぞれのクライアント向けガイドであるChatGPTとClaudeを参照してください。

​
Cursor と VS Code のリダイレクト対応

インストールされているクライアントのバージョンでリモート OAuth フローを完了できる場合にのみ、account エンドポイントを使用してください。Firecrawl は HTTPS リダイレクト URI と、http://localhost、http://127.0.0.1、または http://[::1] を使用するループバック リダイレクト URI を受け入れます。ネイティブ HTTP ループバック クライアントでは、ポートは実行ごとに異なる場合がありますが、登録したホストとパスは、リクエストしたリダイレクト URI と一致している必要があります。 使用中のバージョンの Cursor または VS Code でリモート OAuth を完了できない場合は、代わりに https://mcp.firecrawl.dev/v2/mcp を設定し、Authorization: Bearer <FIRECRAWL_API_KEY> ヘッダーを付与してください。キーはクライアントの環境変数または安全なシークレットストアに保存し、URL には絶対に含めないでください。

​
ホストモードを選択する

CI、サーバー、スクリプト、その他の無人クライアントでは、環境変数から設定する Authorization: Bearer <FIRECRAWL_API_KEY> ヘッダーを使用して https://mcp.firecrawl.dev/v2/mcp に接続してください。APIキーを URL やプロジェクト構成ファイルに記載しないでください。

​
接続を管理する

クライアントを切断するには、Firecrawl 設定でMCPを開き、接続を取り消します。取り消すと、アクセス トークンとリフレッシュ トークンは使用できなくなります。再度認可するには、クライアントから再接続してください。

​
移行期間中の互換性

  • /v2/mcp に明示的に紐付けられた既存のOAuthトークンは、引き続き /v2/mcp で利用できます。
  • 移行期間中は、互換性のある既存の /v2/mcp トークンを /v2/mcp-oauth でも受け付けます。
  • /v2/mcp-oauth 向けに新たに発行されたトークンは、/v2/mcp では受け付けられません。
  • オーディエンスが欠落している、または曖昧なトークンは拒否されます。
  • 既存のレガシーなパス内キー方式のMCP構成は引き続き利用できますが、新しい構成ではOAuthまたはBearerヘッダーを使用してください。

​
セキュリティプロパティ

  • アクセストークンは1時間で失効します。
  • リフレッシュトークンは、リフレッシュが成功するたびにローテーションされます。
  • 各接続は、OAuthクライアント、ユーザー、チーム、スコープ、MCPリソースに紐づけられます。
  • OAuthクライアントはPKCEを使用する認可コードフローを使用し、クライアントシークレットは不要です。

​
対応標準

  • PKCE (S256) を使用するOAuth 2.0認可コード
  • RFC 8414 認可サーバーメタデータ
  • RFC 9728 保護対象リソースメタデータ
  • クライアントIDメタデータドキュメント (CIMD)
  • RFC 7591 動的クライアント登録 (DCR)
  • RFC 8707 リソースインジケーター
新しいアカウント接続では、認可リクエストおよびトークンリクエストでこのリソースを正確に指定する必要があります。
認可サーバーのメタデータは以下で確認できます。