Skip to main content

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:

Execute via stdio

Este é o transporte padrão para clientes que iniciam o servidor MCP como um processo local.

Executar com Streamable HTTP

Use o transporte HTTP para clientes como o n8n que se conectam a um servidor MCP já em execução:
Conecte o cliente a:
Confirme se o servidor está pronto:
A verificação de integridade retorna ok. A rota local é /mcp; /v2/mcp é a rota do Firecrawl hospedada.

Instale globalmente

Em seguida, execute:

Configuração

Variáveis de ambiente

API em nuvem e auto-hospedada

  • FIRECRAWL_API_KEY: Sua chave de API do Firecrawl
    • Obrigatória ao usar a API em nuvem (padrão)
    • Opcional ao usar uma instância auto-hospedada com FIRECRAWL_API_URL
  • FIRECRAWL_API_URL (Opcional): Endpoint de API personalizado para instâncias auto-hospedadas
    • Exemplo: https://firecrawl.your-domain.com
    • Se não for fornecida, a API em nuvem será usada (requer uma chave de API)

Exemplos de configuração

Para usar a API na nuvem:
Para uma instância auto-hospedada:

Configuração personalizada com o Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

MCP hospedado vs. MCP local

O servidor MCP hospedado é otimizado para uso remoto seguro. Algumas opções disponíveis ao executar o servidor MCP localmente são restritas ou indisponíveis remotamente:
  • O modo hospedado sem chave expõe apenas Search, Scrape e Parse e tem limite de taxa por IP.
  • A leitura de arquivos locais está disponível apenas quando você executa o servidor MCP localmente.
  • Webhooks e caminhos de arquivos locais devem ser configurados em um servidor MCP local ou auto-hospedado quando o agente precisar acessar recursos locais.
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 configurado apenas com uma API em nuvem não pode enviar um arquivo local por essa ferramenta.

Limites de taxa

Os limites de taxa são aplicados pelo Firecrawl. Use uma chave de API para obter limites mais altos e acesso ao conjunto completo de ferramentas.