Execute o Firecrawl MCP localmente quando um cliente precisar iniciar um processo local, quando você precisar de um transporte HTTP local ou quando o servidor MCP precisar se conectar a uma API do Firecrawl auto-hospedada. Para o serviço gerenciado, comece por Primeiros passos.
Pré-requisitos#
- Node.js 22 ou posterior
- npm e
npx, incluídos no Node.js - Uma chave de API do Firecrawl para a API em nuvem ou uma URL de API do Firecrawl auto-hospedada
Confirme a versão do Node.js instalada:
Inicie o servidor#
Use stdio quando o cliente MCP iniciar o Firecrawl como um processo local:
Configure o cliente para executar npx -y firecrawl-mcp@3.23.7 e forneça FIRECRAWL_API_KEY por meio do ambiente protegido ou do mecanismo de gerenciamento de segredos do cliente.
Use HTTP quando um cliente, como o n8n, se conectar a um servidor que já está em execução:
Conecte o cliente a:
Confirme que o servidor está pronto:
A verificação de integridade retorna ok. A rota local é /mcp; /v2/mcp pertence ao serviço Firecrawl hospedado.
Configure a API do Firecrawl#
| Variável de ambiente | Finalidade |
|---|---|
FIRECRAWL_API_KEY | Autentica na API em nuvem do Firecrawl. É opcional somente quando uma API auto-hospedada não exige autenticação. |
FIRECRAWL_API_URL | Envia solicitações para uma API do Firecrawl auto-hospedada em vez da API em nuvem. |
HTTP_STREAMABLE_SERVER | Defina como true para iniciar o transporte Streamable HTTP local em vez de stdio. |
A análise direta de arquivos locais com firecrawl_parse exige que FIRECRAWL_API_URL aponte para uma API do Firecrawl auto-hospedada. Um servidor MCP local conectado apenas à API em nuvem não pode fazer upload de um arquivo local por essa ferramenta; em vez disso, o servidor hospedado usa uma transferência de upload assinada.
Instalar globalmente#
Use npx para a configuração mais simples. Para instalar globalmente a mesma versão revisada:
Em seguida, execute:
Solução de problemas#
O cliente relata o erro spawn npx ENOENT
Instale o Node.js 22 ou uma versão mais recente, confirme que npx está no PATH do cliente e reinicie-o completamente. No Windows, execute where npx no Prompt de Comando e configure o cliente para usar o caminho retornado para npx.cmd.
O cliente HTTP não consegue se conectar
Confirme que HTTP_STREAMABLE_SERVER=true e, em seguida, acesse http://localhost:3000/health. Use http://localhost:3000/mcp como endpoint do cliente, não o caminho hospedado /v2/mcp.
Uma ferramenta não está disponível
A disponibilidade das ferramentas depende dos serviços do Firecrawl habilitados na implantação de destino. Compare a conexão em Ferramentas e verifique a saída do processo local em busca de erros de registro ou autenticação.
O servidor está sujeito a limite de taxa
Os limites de taxa são aplicados pela API do Firecrawl conectada. Consulte os limites de taxa atuais e os limites configurados para uma implantação auto-hospedada.