Firecrawl MCP をローカルで実行

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

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

前提条件

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

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

node --version

サーバーを起動する

stdio

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

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 を指定します。

Streamable HTTP

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

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
  npx -y firecrawl-mcp@3.23.4

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

http://localhost:3000/mcp

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

curl http://localhost:3000/health

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

Firecrawl API を設定する

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

Cloud API

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
npx -y firecrawl-mcp@3.23.4

firecrawl_parse でローカルファイルを直接解析するには、セルフホスト型 Firecrawl API を指す FIRECRAWL_API_URL が必要です。クラウド API のみに接続されたローカル MCP サーバーでは、このツールを介してローカルファイルをアップロードできません。代わりに、ホスト型サーバーでは署名付きアップロードの引き渡しを使用します。

グローバルにインストール

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

npm install -g firecrawl-mcp@3.23.4

次を実行します。

env FIRECRAWL_API_KEY=fc-YOUR-API-KEY firecrawl-mcp

トラブルシューティング

クライアントで spawn npx ENOENT が発生する

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

HTTP クライアントが接続できない

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

ツールを利用できない

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

サーバーにレート制限がかかっている

レート制限は、接続されている Firecrawl API によって適用されます。現在のレート制限と、セルフホスト型デプロイメントに設定されている制限を確認してください。