Skip to main content
在 Responses API 中将远程托管的 MCP 服务器添加为远程 mcp 工具,即可将 OpenAI 模型连接到 Firecrawl。OpenAI 会列出各项 Firecrawl 工具,模型则调用这些工具进行网页搜索并读取页面内容。
根据 OpenAI 的文档,Agent Builder 计划于 2026 年 11 月 30 日停止服务。本页介绍的远程 MCP 工具不依赖 Agent Builder。

前置要求

  • 将 OpenAI API 密钥配置到 OPENAI_API_KEY 中,并安装 openai Python 包。
  • 将 Firecrawl API 密钥配置到 FIRECRAWL_API_KEY 中。

快速配置

将 Firecrawl 服务器添加到 tools 列表中。authorization 字段用于传入你的 Firecrawl API 密钥,allowed_tools 则用于限制模型可调用的工具:
OpenAI 不会存储 authorization 值,因此每次请求都需要携带该值。如果希望在数据发送到服务器之前逐一审核每次工具调用,请将 require_approval 设置为 "always"。 有关基于密钥的连接的更多信息,请参见配置 API 密钥。在此配置方式下,你的代码不会直接调用 Firecrawl API,而是由 OpenAI 代你连接 MCP 服务器。

试一试

你可以用它做什么

搜索

查找最新信息,并读取相关结果的内容。

抓取

将 URL 转换为干净的 markdown 或结构化数据。

交互

通过页面导航、点击和表单填写,获取所需数据。

Alexandria

发现结构化数据工具,查看其输入参数和定价,然后通过 Firecrawl 运行这些工具。

故障排除

  • 列出工具时请求失败: 确认 server_url 与 https://mcp.firecrawl.dev/v2/mcp 完全一致,并确认运行脚本的环境中已设置 FIRECRAWL_API_KEY。
  • 服务器返回 401: 更换 API 密钥后重新发送请求。OpenAI 不会在请求之间保留 authorization 值。
  • 缺少某个工具: 将其名称添加到 allowed_tools,或移除 allowed_tools,以导入服务器公开的全部工具。
  • 模型未调用 Firecrawl 就直接给出答案: 在 prompt 中明确指定工具名称,例如“Use firecrawl_search to find…”。