Skip to main content
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, use o Agent MCP ou o Human MCP.

​
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.4 e forneça FIRECRAWL_API_KEY por meio do ambiente protegido ou do mecanismo de gerenciamento de segredos do cliente.

​
Configure a API do Firecrawl

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

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.
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.
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.
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.