Skip to main content
将 Vercel AI SDK 的 MCP 客户端连接到 Firecrawl 远程托管的 MCP 服务器,即可在 generateText 和 streamText 中使用 Firecrawl 的工具。
如果希望直接使用封装为 AI SDK 工具的 Firecrawl 工具,而不是通过 MCP 连接,请参见 Vercel AI SDK 指南。

快速配置

创建 Firecrawl API 密钥,然后安装 AI SDK 及其 MCP 包:
使用 HTTP 传输创建客户端,并在 Authorization 标头中填入你的键:
该列表包括 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。

试一试

直接调用一个工具,确认连接是否正常:
然后将这些工具提供给模型,并使用类似下面的 prompt:

故障排除

  • 身份验证错误: 确认运行客户端的进程中已设置 FIRECRAWL_API_KEY,且标头值为 Bearer <key>。
  • 重定向错误: AI SDK 客户端默认拒绝重定向;请使用完整的 URL https://mcp.firecrawl.dev/v2/mcp。
  • 脚本结束后句柄未释放: 工具使用完毕后,请调用 mcpClient.close()。