> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl MCP に接続

> アカウント OAuth、無人 API キー、またはキーなしの Firecrawl MCP セットアップを選択します。

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

<div id="connect-an-account">
  ## アカウントを接続する
</div>

Claude や Codex などの OAuth 対応の対話型クライアントでは、このモードを使用します。この URL をクライアントに追加すると、Firecrawl's の認可メタデータが検出され、ブラウザが開いて、使用するチームの承認を求められます。

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

クライアントには、Firecrawl APIキーではなく、有効期間が短くリソースに紐づいたトークンが渡されます。[MCP設定](https://www.firecrawl.dev/app/settings?tab=mcp)でアクセスを確認・取り消しできます。

<Tip>
  クライアントからOAuth Client IDまたはClient Secretの入力を求められた場合は、どちらも空欄のままにしてください。互換性のあるクライアントでは、Client ID Metadata Documentsまたは動的クライアント登録が使用されます。
</Tip>

<div id="run-unattended">
  ## 無人実行
</div>

CI、サーバー、スクリプト、またはブラウザを利用できないランタイムでは、このモードを使用します。API キーは環境変数またはシークレットストアに保存し、Authorization ヘッダーとして送信します。

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp
Authorization: Bearer <FIRECRAWL_API_KEY>
```

Firecrawl MCP のすべてのツールを使用します。新しい構成では、API キーを URL に含めたり、プロジェクトの構成ファイルにコミットしたりしないでください。

<div id="try-keyless">
  ## キーなしで試す
</div>

このモードでは、アカウントやAPIキーなしでFirecrawlを試すことができます。

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

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

<div id="pick-the-right-mode">
  ## 適切なモードを選択
</div>

| モード   | エンドポイント         | 最適な用途                        | 認証情報                                        |
| ----- | --------------- | ---------------------------- | ------------------------------------------- |
| アカウント | `/v2/mcp-oauth` | ブラウザでOAuthフローを完了できる対話型クライアント | クライアント側で管理するOAuthトークン                       |
| 無人実行  | `/v2/mcp`       | CI、サーバー、スクリプト                | `Authorization: Bearer <FIRECRAWL_API_KEY>` |
| キーなし  | `/v2/mcp`       | 制限付きの試用                      | なし                                          |

<div id="client-specific-help">
  ## クライアント固有のヘルプ
</div>

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

<div id="legacy-api-key-url-support">
  ## レガシー API キー URL のサポート
</div>

<Warning>
  このレガシー形式は、OAuth を完了できない、またはカスタム Authorization ヘッダーを送信できない既存の構成やクライアント向けにのみ提供されています。新しいインテグレーションには推奨されません。
</Warning>

```text theme={null}
https://mcp.firecrawl.dev/<FIRECRAWL_API_KEY>/v2/mcp
```

API キーは URL の一部であるため、URL 全体をパスワードと同様に扱ってください。クライアントが対応している場合は、アカウント OAuth または環境変数で管理された `Authorization: Bearer` header を使用してください。この URL が漏洩した場合は、API キーをローテーションしてください。チャット、スクリーンショット、issue、共有構成に貼り付けないでください。

このフォールバックは、`/v2/mcp` の全機能にのみ適用されます。OAuth 専用の search resource では機能しません。

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

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