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

​
前提条件

  • Node.js 22 以降
  • Node.js に含まれる npm と npx
  • クラウド API 用の Firecrawl APIキー、またはセルフホスト型 Firecrawl API の URL
インストール済みの Node.js のバージョンを確認します。

​
サーバーを起動する

MCP クライアントが Firecrawl をローカルプロセスとして起動する場合は、stdio を使用します。
クライアントで npx -y firecrawl-mcp@3.23.7 を実行するよう設定し、クライアントの保護された環境変数またはシークレット管理機構で FIRECRAWL_API_KEY を指定します。

​
Firecrawl API を設定する

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

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

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

​
トラブルシューティング

Node.js 22 以降をインストールし、クライアントの PATH に npx が含まれていることを確認してから、クライアントを完全に再起動してください。Windows では、コマンドプロンプトで where npx を実行し、表示された npx.cmd のパスを使用するようクライアントを設定してください。
HTTP_STREAMABLE_SERVER=true であることを確認してから、http://localhost:3000/health を呼び出してください。クライアントのエンドポイントには、ホスト型の /v2/mcp パスではなく、http://localhost:3000/mcp を使用してください。
ツールを利用できるかどうかは、対象のデプロイメントで有効になっている Firecrawl サービスによって異なります。Tools の接続設定と比較し、ローカルプロセスの出力で登録または認証のエラーを確認してください。
レート制限は、接続されている Firecrawl API によって適用されます。現在のレート制限と、セルフホスト型デプロイメントに設定されている制限を確認してください。