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

# Firecrawl MCP をローカルで実行

> オープンソースの Firecrawl MCP サーバーを stdio または Streamable HTTP 経由で起動・設定します。

クライアントがローカルプロセスを起動する必要がある場合、ローカル HTTP トランスポートを使用する場合、または MCP サーバーをセルフホスト型 Firecrawl API に接続する必要がある場合は、Firecrawl MCP をローカルで実行します。マネージドサービスを使用する場合は、[Agent MCP](/ja/mcp-server/agent-mcp)または[Human MCP](/ja/mcp-server/human-mcp)を使用してください。

<div id="prerequisites">
  ## 前提条件
</div>

* Node.js 22 以降
* Node.js に含まれる npm と `npx`
* クラウド API 用の Firecrawl APIキー、またはセルフホスト型 Firecrawl API の URL

インストール済みの Node.js のバージョンを確認します。

```bash theme={null}
node --version
```

<div id="start-the-server">
  ## サーバーを起動する
</div>

<Tabs>
  <Tab title="stdio">
    MCP クライアントが Firecrawl をローカルプロセスとして起動する場合は、stdio を使用します。

    ```bash theme={null}
    env FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
      npx -y firecrawl-mcp@3.23.4
    ```

    クライアントで `npx -y firecrawl-mcp@3.23.4` を実行するよう設定し、クライアントの保護された環境変数またはシークレット管理機構で `FIRECRAWL_API_KEY` を指定します。
  </Tab>

  <Tab title="Streamable HTTP">
    n8n などのクライアントがすでに起動しているサーバーに接続する場合は、HTTP を使用します。

    ```bash theme={null}
    env HTTP_STREAMABLE_SERVER=true \
      FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
      npx -y firecrawl-mcp@3.23.4
    ```

    クライアントを次のエンドポイントに接続します。

    ```text theme={null}
    http://localhost:3000/mcp
    ```

    サーバーの準備ができていることを確認します。

    ```bash theme={null}
    curl http://localhost:3000/health
    ```

    ヘルスチェックの戻り値は `ok` です。ローカルのルートは `/mcp` です。`/v2/mcp` はホスト型 Firecrawl サービス用です。
  </Tab>
</Tabs>

<div id="configure-the-firecrawl-api">
  ## Firecrawl API を設定する
</div>

| 環境変数                     | 用途                                                             |
| ------------------------ | -------------------------------------------------------------- |
| `FIRECRAWL_API_KEY`      | Firecrawl クラウド API への認証に使用します。セルフホスト型 API で認証が不要な場合にのみ任意です。    |
| `FIRECRAWL_API_URL`      | クラウド API ではなく、セルフホスト型 Firecrawl API にリクエストを送信します。              |
| `HTTP_STREAMABLE_SERVER` | stdio の代わりにローカルの Streamable HTTP トランスポートを開始するには、`true` に設定します。 |

<CodeGroup>
  ```bash Cloud API theme={null}
  export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
  npx -y firecrawl-mcp@3.23.4
  ```

  ```bash Self-hosted API theme={null}
  export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
  export FIRECRAWL_API_KEY=your-api-key # インスタンスで認証が不要な場合は省略
  npx -y firecrawl-mcp@3.23.4
  ```
</CodeGroup>

<Note>
  `firecrawl_parse` でローカルファイルを直接解析するには、セルフホスト型 Firecrawl API を指す `FIRECRAWL_API_URL` が必要です。クラウド API のみに接続されたローカル MCP サーバーでは、このツールを介してローカルファイルをアップロードできません。代わりに、[ホスト型サーバーでは署名付きアップロードの引き渡しを使用します](/ja/mcp-server/tools#important-behavior)。
</Note>

<div id="install-globally">
  ## グローバルにインストール
</div>

最短のセットアップには `npx` を使用します。代わりに、レビュー済みの同じリリースをグローバルにインストールするには：

```bash theme={null}
npm install -g firecrawl-mcp@3.23.4
```

次を実行します。

```bash theme={null}
env FIRECRAWL_API_KEY=fc-YOUR-API-KEY firecrawl-mcp
```

<div id="troubleshooting">
  ## トラブルシューティング
</div>

<AccordionGroup>
  <Accordion title="クライアントで spawn npx ENOENT が発生する">
    Node.js 22 以降をインストールし、クライアントの `PATH` に `npx` が含まれていることを確認してから、クライアントを完全に再起動してください。Windows では、コマンドプロンプトで `where npx` を実行し、表示された `npx.cmd` のパスを使用するようクライアントを設定してください。
  </Accordion>

  <Accordion title="HTTP クライアントが接続できない">
    `HTTP_STREAMABLE_SERVER=true` であることを確認してから、`http://localhost:3000/health` を呼び出してください。クライアントのエンドポイントには、ホスト型の `/v2/mcp` パスではなく、`http://localhost:3000/mcp` を使用してください。
  </Accordion>

  <Accordion title="ツールを利用できない">
    ツールを利用できるかどうかは、対象のデプロイメントで有効になっている Firecrawl サービスによって異なります。[Tools](/ja/mcp-server/tools) の接続設定と比較し、ローカルプロセスの出力で登録または認証のエラーを確認してください。
  </Accordion>

  <Accordion title="サーバーにレート制限がかかっている">
    レート制限は、接続されている Firecrawl API によって適用されます。現在の[レート制限](/ja/rate-limits)と、セルフホスト型デプロイメントに設定されている制限を確認してください。
  </Accordion>
</AccordionGroup>