Skip to main content

前提条件

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

stdio 経由で実行

これは、MCP サーバー をローカルプロセスとして起動するクライアント向けのデフォルトのトランスポートです。

Streamable HTTP で実行する

すでに起動している MCP サーバー に接続する n8n などのクライアントでは、HTTP トランスポート を使用します。
クライアントを次に接続します。
サーバーの準備ができていることを確認します。
ヘルスチェックの戻り値は ok です。ローカルルートは /mcp、ホスト型の Firecrawl ルートは /v2/mcp です。

グローバルインストール

次を実行します。

構成

環境変数

クラウド API とセルフホスト型 API

  • FIRECRAWL_API_KEY: Firecrawl APIキー
    • クラウド API (デフォルト) を使用する場合は必須
    • FIRECRAWL_API_URL を指定したセルフホスト型インスタンスを使用する場合は任意
  • FIRECRAWL_API_URL (任意) : セルフホスト型インスタンス用のカスタム API エンドポイント
    • 例: https://firecrawl.your-domain.com
    • 指定しない場合はクラウド API が使用されます (APIキーが必要です)

構成例

クラウド API を使用する場合:
セルフホスト型インスタンスの場合:

Claude Desktop のカスタム構成

claude_desktop_config.jsonに以下を追加します:

Hosted MCP とローカル MCP

ホスト型 MCP サーバーは、安全なリモート利用に最適化されています。MCP サーバーをローカルで実行する場合に利用できる一部のオプションは、リモートでは制限されるか利用できません。
  • ホスト型のキーなしモードでは、Search、Scrape、Parse のみが利用可能で、IP アドレスごとにレート制限が適用されます。
  • ローカル専用のファイル読み取りは、MCP サーバーをローカルで実行している場合にのみ利用できます。
  • Agent がローカルリソースにアクセスする必要がある場合は、webhook とローカルファイルパスをローカルまたはセルフホスト型の MCP サーバーで設定してください。
firecrawl_parse によるローカルファイルの直接解析には、セルフホスト型 Firecrawl API を指す FIRECRAWL_API_URL が必要です。クラウド API キーのみで設定されたローカル MCP サーバーでは、そのツールを介してローカルファイルをアップロードできません。

レート制限

Firecrawl ではレート制限が適用されます。より高い制限とすべてのツールセットへのアクセスには、API キーをご利用ください。