MCPクライアントをアカウントに接続する
対話型MCPクライアントをFirecrawlアカウントに接続する
ユーザーがサインインしてアクセスを承認する場合は、Firecrawlのaccountエンドポイントを使用します。クライアントは、生のFirecrawl APIキーではなく、短期間のみ有効でリソースに紐付けられたトークンを受け取ります。
アカウントOAuth、無人でのAPIキーアクセス、キーレスアクセスの使い分けについては、Firecrawl MCPに接続するを参照してください。
互換性のある対話型クライアントで、次を指定します。
https://mcp.firecrawl.dev/v2/mcp-oauthクライアントからOAuth クライアントIDまたはクライアントシークレットの入力を求められた場合は、どちらも空欄のままにしてください。対応クライアントは、クライアントID Metadata Documentsまたは動的クライアント登録を使用して自身を識別します。
クライアントによってブラウザでFirecrawlが開きます。サインインし、コネクタで使用するチームを選択して、同意リクエストを確認し、アクセスを承認します。リクエストの料金は選択したチームに請求されます。
ChatGPTとClaudeでは設定画面やワークスペースのルールが異なるため、それぞれのクライアント向けガイドであるChatGPTとClaudeを参照してください。
インストールされているクライアントのバージョンでリモート 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 には絶対に含めないでください。
| エンドポイント | 用途 | 認証と利用できるツール |
|---|---|---|
https://mcp.firecrawl.dev/v2/mcp | キーレスの試用または無人プロセス | 認証情報なしでは、対象となりレート制限の範囲内である場合に限り、Search、Scrape、Parse のみを利用できます。Authorization: Bearer <FIRECRAWL_API_KEY> を指定すると、すべてのツールを利用できます。 |
https://mcp.firecrawl.dev/v2/mcp-oauth | 対話型のブラウザベースのアカウント接続 | OAuth が起動し、認可後にすべてのツールを利用できます。互換性のため、APIキーも使用できます。 |
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 リソースインジケーター
新しいアカウント接続では、認可リクエストおよびトークンリクエストでこのリソースを正確に指定する必要があります。
https://mcp.firecrawl.dev/v2/mcp-oauth認可サーバーのメタデータは以下で確認できます。
curl -s "https://www.firecrawl.dev/.well-known/oauth-authorization-server" | jq .