> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-dne9il.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCPクライアントをアカウントに接続する

> 対話型MCPクライアントをFirecrawlアカウントに接続する

ユーザーがサインインしてアクセスを承認する場合は、Firecrawlのaccountエンドポイントを使用します。クライアントは、生のFirecrawl APIキーではなく、短期間のみ有効でリソースに紐付けられたトークンを受け取ります。

アカウントOAuth、無人でのAPIキーアクセス、キーレスアクセスの使い分けについては、[Firecrawl MCPに接続する](/ja/mcp-server/connect)を参照してください。

<div id="connect-an-interactive-client">
  ## 対話型クライアントを接続する
</div>

互換性のある対話型クライアントで、次を指定します。

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp-oauth
```

クライアントからOAuth クライアントIDまたはクライアントシークレットの入力を求められた場合は、どちらも空欄のままにしてください。対応クライアントは、クライアントID Metadata Documentsまたは動的クライアント登録を使用して自身を識別します。

クライアントによってブラウザでFirecrawlが開きます。サインインし、コネクタで使用するチームを選択して、同意リクエストを確認し、アクセスを承認します。リクエストの料金は選択したチームに請求されます。

ChatGPTとClaudeでは設定画面やワークスペースのルールが異なるため、それぞれのクライアント向けガイドである[ChatGPT](/ja/developer-guides/mcp-setup-guides/chatgpt)と[Claude](/ja/developer-guides/mcp-setup-guides/claude-ai)を参照してください。

<div id="cursor-and-vs-code-redirect-support">
  ### Cursor と VS Code のリダイレクト対応
</div>

インストールされているクライアントのバージョンでリモート 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 には絶対に含めないでください。

<div id="choose-the-hosted-mode">
  ## ホストモードを選択する
</div>

| エンドポイント                                  | 用途                  | 認証と利用できるツール                                                                                                                      |
| ---------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `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 やプロジェクト構成ファイルに記載しないでください。

<div id="manage-a-connection">
  ## 接続を管理する
</div>

クライアントを切断するには、[Firecrawl 設定](https://www.firecrawl.dev/app/settings?tab=mcp)で**MCP**を開き、接続を取り消します。取り消すと、アクセス トークンとリフレッシュ トークンは使用できなくなります。再度認可するには、クライアントから再接続してください。

<div id="compatibility-during-migration">
  ## 移行期間中の互換性
</div>

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

<div id="security-properties">
  ## セキュリティプロパティ
</div>

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

<div id="supported-standards">
  ## 対応標準
</div>

* PKCE (S256) を使用するOAuth 2.0認可コード
* RFC 8414 認可サーバーメタデータ
* RFC 9728 保護対象リソースメタデータ
* クライアントIDメタデータドキュメント (CIMD)
* RFC 7591 動的クライアント登録 (DCR)
* RFC 8707 リソースインジケーター

新しいアカウント接続では、認可リクエストおよびトークンリクエストでこのリソースを正確に指定する必要があります。

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp-oauth
```

認可サーバーのメタデータは以下で確認できます。

```bash theme={null}
curl -s "https://www.firecrawl.dev/.well-known/oauth-authorization-server" | jq .
```
