Skip to main content
Conecte modelos da OpenAI ao Firecrawl adicionando o servidor MCP hospedado como uma ferramenta mcp remota na Responses API. A OpenAI lista as ferramentas do Firecrawl, e o modelo as chama para fazer buscas na web e ler páginas.
A documentação da OpenAI informa que o Agent Builder será desativado em 30 de novembro de 2026. A ferramenta MCP remota descrita nesta página não depende do Agent Builder.

Requisitos

Configuração rápida

Adicione o servidor do Firecrawl à lista tools. O campo authorization contém sua chave de API do Firecrawl, e allowed_tools restringe as ferramentas que o modelo pode chamar:
A OpenAI não armazena o valor de authorization, então envie-o em todo request. Defina require_approval como "always" se quiser revisar cada chamada de ferramenta antes que os dados sejam enviados ao servidor. Veja Configurar uma API key para saber mais sobre conexões baseadas em chave. Com essa configuração, seu código não faz chamadas diretas à API do Firecrawl, pois a OpenAI se conecta ao servidor MCP por você.

Experimente

O que você pode fazer

Busca

Encontre informações atualizadas e leia o conteúdo dos resultados relevantes.

Scraping

Converta URLs em markdown limpo ou dados estruturados.

Interagir

Navegue, clique e preencha formulários para chegar aos dados de que você precisa.

Alexandria

Descubra ferramentas de dados estruturados, confira as entradas e os preços e execute-as pelo Firecrawl.

Solução de problemas

  • A request falha ao listar as ferramentas: confirme se server_url é exatamente https://mcp.firecrawl.dev/v2/mcp e se FIRECRAWL_API_KEY está definida no ambiente que executa o script.
  • O servidor retorna 401: substitua a chave e envie a request novamente, pois a OpenAI não armazena o valor de authorization entre requisições.
  • Uma ferramenta não aparece: adicione o nome dela a allowed_tools ou remova allowed_tools para importar todas as ferramentas expostas pelo servidor.
  • O modelo responde sem usar o Firecrawl: mencione a ferramenta no seu prompt, por exemplo: “Use firecrawl_search para encontrar…”.