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
- Uma API key da OpenAI em
OPENAI_API_KEYe o pacote Pythonopenai. - Uma chave de API do Firecrawl em
FIRECRAWL_API_KEY.
Configuração rápida
Adicione o servidor do Firecrawl à listatools. O campo authorization contém sua chave de API do Firecrawl, e allowed_tools restringe as ferramentas que o modelo pode chamar:
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é exatamentehttps://mcp.firecrawl.dev/v2/mcpe seFIRECRAWL_API_KEYestá 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 deauthorizationentre requisições. - Uma ferramenta não aparece: adicione o nome dela a
allowed_toolsou removaallowed_toolspara 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…”.

