Skip to main content
Responses API でホスト型MCPサーバーをリモートの mcp ツールとして追加すると、OpenAI のモデルを Firecrawl に接続できます。OpenAI が Firecrawl のツール一覧を取得し、モデルはそれらのツールを呼び出してウェブを検索したり、ページの内容を読み取ったりします。
OpenAI のドキュメントによると、Agent Builder は 2026 年 11 月 30 日に提供終了となる予定です。このページで紹介するリモート MCP ツールは Agent Builder に依存しません。

前提条件

  • OPENAI_API_KEY に設定した OpenAI APIキーと、openai Python パッケージ
  • FIRECRAWL_API_KEY に設定した Firecrawl APIキー

クイックセットアップ

tools リストに Firecrawl サーバーを追加します。authorization フィールドには Firecrawl APIキーを指定し、allowed_tools でモデルが呼び出せるツールを制限します。
OpenAI は authorization の値を保存しないため、リクエストのたびに送信してください。データがサーバーに送信される前に各ツール呼び出しを確認したい場合は、require_approval を "always" に設定します。 キーベースの接続について詳しくは、APIキーを設定するを参照してください。このセットアップでは OpenAI が MCP サーバーへの接続を代行するため、コードから Firecrawl API を直接呼び出すことはありません。

試してみる

できること

Search

最新の情報を検索し、関連する結果のコンテンツを取得します。

Scrape

URLをクリーンなMarkdownや構造化データに変換します。

Interact

ページ遷移、クリック、フォーム入力を行い、必要なデータにアクセスします。

Alexandria

構造化データツールを探し、入力パラメータと料金を確認したうえで、Firecrawl経由で実行します。

トラブルシューティング

  • ツールの一覧取得中にリクエストが失敗する: server_url が https://mcp.firecrawl.dev/v2/mcp と完全に一致していること、およびスクリプトを実行する環境に FIRECRAWL_API_KEY が設定されていることを確認してください。
  • サーバーが 401 を返す: OpenAI はリクエスト間で authorization の値を保持しないため、キーを差し替えてからリクエストを再送信してください。
  • ツールが見つからない: allowed_tools にそのツール名を追加するか、allowed_tools を削除してサーバーが公開するすべてのツールをインポートしてください。
  • モデルが Firecrawl を使用せずに回答する: プロンプト内でツール名を明示してください(例: 「Use firecrawl_search to find…」)。