Execute o Firecrawl MCP localmente

• 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:

node --version

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y [email protected]

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

Use o transporte HTTP para clientes como o n8n que se conectam a um servidor MCP já em execução:

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
  npx -y [email protected]

Conecte o cliente a:

http://localhost:3000/mcp

Confirme se o servidor está pronto:

curl http://localhost:3000/health

A verificação de integridade retorna ok. A rota local é /mcp; /v2/mcp é a rota do Firecrawl hospedada.

npm install -g [email protected]

Em seguida, execute:

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY firecrawl-mcp

• 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)

Para usar a API na nuvem:

export FIRECRAWL_API_KEY=your-api-key

Para uma instância auto-hospedada:

export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Se sua instância exigir autenticação

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

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.

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.