Skip to main content
Vercel AI SDK の MCP クライアントを Firecrawl のホスト型MCPサーバーに接続し、generateText や streamText から Firecrawl のツールを使用します。
MCP 接続ではなく、AI SDK のツールとしてパッケージ化された Firecrawl ツールを使いたい場合は、Vercel AI SDK ガイドを参照してください。

クイックセットアップ

Firecrawl APIキーを作成したら、AI SDK とその MCP パッケージをインストールします。
HTTP トランスポートを使用し、Authorization ヘッダーに API キーを指定してクライアントを作成します。
このリストには firecrawl_scrape、firecrawl_search、firecrawl_map、firecrawl_crawl が含まれます。AI SDK MCP ガイドの説明に従って tools を generateText または streamText に渡し、レスポンスが完了したら await mcpClient.close() でクライアントを閉じてください。 ローカルプロセスを使用したい場合は、AI SDK の stdio トランスポートで npx -y firecrawl-mcp を実行し、env に FIRECRAWL_API_KEY を設定してください。なお、AI SDK では本番環境での HTTP の使用を推奨しています。

試してみる

ツールを直接呼び出して、接続を確認します。
次に、以下のようなプロンプトを添えて、ツールをモデルに渡します。

トラブルシューティング

  • 認証エラー: クライアントを実行するプロセスで FIRECRAWL_API_KEY が設定されていること、およびヘッダーの値が Bearer <key> になっていることを確認してください。
  • リダイレクトエラー: AI SDK クライアントはデフォルトでリダイレクトを拒否します。URL は https://mcp.firecrawl.dev/v2/mcp を正確に指定してください。
  • スクリプト終了後もハンドルが開いたままになる: ツールを使い終わったら mcpClient.close() を呼び出してください。