Firecrawl MCP

Conecte o Firecrawl a um cliente MCP com OAuth, uma chave de API ou uma avaliação sem chave.

O Firecrawl MCP dá aos clientes de IA acesso a dados da web em tempo real por meio do Model Context Protocol. Use o servidor hospedado para uma configuração mais rápida ou execute o servidor de código aberto localmente quando precisar de um processo local ou de uma API do Firecrawl auto-hospedada.

Esta página é o guia de configuração oficial do Firecrawl MCP hospedado.

​

Configurar o Firecrawl MCP Server

Para um cliente interativo, conecte-se via OAuth. O cliente abre o Firecrawl no navegador para que você possa fazer login, escolher uma equipe e aprovar o acesso sem copiar uma chave de API.

Codex

Adicione o servidor hospedado e conclua o login via OAuth:

codex mcp add firecrawl \
  --url https://mcp.firecrawl.dev/v2/mcp-oauth
codex mcp login firecrawl

Inicie ou reinicie o aplicativo, a CLI ou a extensão de IDE do Codex. Digite /mcp para confirmar que firecrawl está conectado.

Claude Desktop

1. Abra Configuração > Connectors.
2. Selecione Add custom connector.
3. Insira https://mcp.firecrawl.dev/v2/mcp-oauth como URL do servidor MCP remoto.
4. Selecione Connect, faça login no Firecrawl e aprove o acesso.

Servidores remotos devem ser adicionados em Configuração > Connectors. O arquivo claude_desktop_config.json é destinado a servidores MCP locais.

Claude Code

Adicione o servidor hospedado:

claude mcp add --transport http firecrawl \
  https://mcp.firecrawl.dev/v2/mcp-oauth

Digite /mcp no Claude Code, escolha firecrawl e conclua o login no navegador.

Cursor

Adicione o servidor hospedado a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

Salve o arquivo, abra as configurações de MCP do Cursor e conclua o login no Firecrawl. Em seguida, o Cursor disponibilizará as ferramentas do Firecrawl para o Agent.

Outros clientes

Configure um cliente MCP remoto compatível com OAuth para usar:

https://mcp.firecrawl.dev/v2/mcp-oauth

Se o cliente solicitar um Client ID ou Client Secret do OAuth, deixe ambos em branco. Clientes compatíveis usam documentos de metadados de Client ID ou Dynamic Client Registration.

Se o cliente não conseguir concluir o OAuth remoto, use a configuração com chave de API abaixo. Se não puder enviar cabeçalhos de solicitação, execute o Firecrawl MCP localmente.

Conexões OAuth recebem tokens de curta duração vinculados a recursos, em vez da sua chave de API do Firecrawl. Você pode analisá-los e revogá-los nas configurações de MCP.

​

Configure com uma chave de API

Use uma chave de API em CI, servidores, scripts ou outro cliente que não possa concluir o OAuth no navegador. Crie uma chave de API do Firecrawl, mantenha-a em uma variável de ambiente ou gerenciador de segredos e conecte-se ao endpoint MCP hospedado completo.

Codex

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
codex mcp add firecrawl \
  --url https://mcp.firecrawl.dev/v2/mcp \
  --bearer-token-env-var FIRECRAWL_API_KEY

Claude Code

O Claude Code expande a variável de ambiente ao se conectar:

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
claude mcp add --transport http firecrawl \
  https://mcp.firecrawl.dev/v2/mcp \
  --header 'Authorization: Bearer ${FIRECRAWL_API_KEY}'

Outros clientes

Configure o cliente para enviar a chave de API como um token de portador:

URL: https://mcp.firecrawl.dev/v2/mcp
Authorization: Bearer <FIRECRAWL_API_KEY>

A configuração do header varia conforme o cliente. Mantenha a chave no ambiente do cliente ou em um armazenamento protegido de segredos.

Nunca coloque uma chave de API em um arquivo de configuração do projeto, cole-a em um chat ou compartilhe-a em uma captura de tela ou issue. Novas configurações devem usar OAuth ou um cabeçalho Authorization com base em variável de ambiente, nunca uma URL que contenha credenciais.

​

Teste sem uma chave de API

Para testar o Firecrawl sem criar uma conta, adicione o endpoint sem chave a qualquer cliente compatível com MCP remoto:

https://mcp.firecrawl.dev/v2/mcp

O MCP sem chave tem limite de taxa por rede e disponibiliza exatamente Busca, Scrape e Parse enquanto você for elegível. Conecte-se via OAuth ou com uma chave de API quando precisar do conjunto completo de ferramentas ou de limites mais altos.

O que acontece quando atinjo o limite sem chave?

Quando disponível, o erro do MCP informa o tempo atual de nova tentativa. Aguarde esse intervalo para continuar usando o MCP sem chave ou conecte-se imediatamente via OAuth ou com uma chave de API.

​

Verifique sua conexão

Abra o status do MCP ou a lista de ferramentas do cliente e confirme que firecrawl está conectado. Uma conexão sem chave exibe firecrawl_search, firecrawl_scrape e firecrawl_parse; uma conexão autenticada pode disponibilizar o conjunto completo de ferramentas, conforme o plano, a implantação e a política da equipe.

Tente uma solicitação somente leitura:

Faça uma busca na web pelas notas da última release do Firecrawl e resuma as fontes.

Se nenhuma ferramenta do Firecrawl aparecer, reinicie ou recarregue o cliente após salvar a configuração do MCP. Em caso de erro de processo local, como spawn npx ENOENT, consulte Executar o Firecrawl MCP localmente.

​

Compatibilidade e configuração legada

Suporte a URL legada com chave de API

Este formato legado existe apenas para configurações e clientes existentes que não conseguem concluir o OAuth ou enviar um cabeçalho Authorization personalizado. Não é a configuração recomendada para novas integrações.

https://mcp.firecrawl.dev/<FIRECRAWL_API_KEY>/v2/mcp

A chave de API faz parte da URL; portanto, trate a URL completa como uma senha. Se ela for exposta, faça a rotação da chave. Esse fallback se aplica apenas a toda a superfície do /v2/mcp. Ele não funciona para o recurso de busca exclusivo do OAuth.

Conexões OAuth existentes

As conexões OAuth existentes do /v2/mcp continuam compatíveis durante a migração para o endpoint dedicado da conta. Novas conexões interativas de conta devem usar /v2/mcp-oauth; novos tokens para esse recurso de conta não são aceitos pelo /v2/mcp.

​

Próximas etapas

Escolha uma ferramenta

Encontre a ferramenta Firecrawl MCP ideal e confira a disponibilidade de cada conexão.

Execute localmente

Inicie o servidor de código aberto via stdio ou Streamable HTTP.

Contribua

Desenvolva, teste e contribua com o servidor Firecrawl MCP.

Para consultar a cota sem chave atual e os limites do plano, veja Limites de taxa.