Configure o Firecrawl MCP em um cliente

Comece por Conectar o Firecrawl MCP para escolher OAuth da conta, acesso não assistido com chave de API ou acesso sem chave. Estes exemplos específicos de cada cliente usam o mesmo contrato compatível com o modo selecionado.

Executando no Cursor

Instale o servidor hospedado sem chave com um clique (não requer chave de API):

Adicionar o servidor MCP do Firecrawl ao Cursor

Ou adicione-o manualmente ao ~/.cursor/mcp.json:

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

Execução local com uma chave de API

Observação: requer o Cursor versão 0.45.6 ou superior. Para ver as instruções de configuração mais atualizadas, consulte a documentação oficial do Cursor sobre configuração de servidores MCP: Guia de configuração do servidor MCP do Cursor Para configurar o Firecrawl MCP no Cursor v0.48.6

Abra as configurações do Cursor
Acesse Recursos > Servidores MCP
Clique em ”+ Adicionar novo servidor MCP global”

Insira o seguinte código:

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Para configurar o Firecrawl MCP no Cursor v0.45.6

Abra as configurações do Cursor
Acesse Recursos > Servidores MCP
Clique em ”+ Adicionar novo servidor MCP”
Insira o seguinte:
- Nome: “firecrawl-mcp” (ou o nome de sua preferência)
- Tipo: “command”
- Comando: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp@3.22.4

Se estiver usando o Windows e tiver problemas, tente cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp@3.22.4"

Substitua your-api-key pela sua chave de API do Firecrawl. Se ainda não tiver uma, crie uma conta e obtenha-a em https://www.firecrawl.dev/app/api-keys Depois de adicionar, atualize a lista de servidores MCP para ver as novas ferramentas. O agente Composer usará o Firecrawl MCP automaticamente quando apropriado, mas você também pode solicitá-lo explicitamente descrevendo suas necessidades de dados da web. Acesse o Composer com Command+L (Mac), selecione “Agent” ao lado do botão de envio e insira sua consulta.

Executando no Windsurf

Adicione o seguinte ao seu ./codeium/windsurf/model_config.json:

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

Executando com o modo Streamable HTTP

Para executar o servidor localmente usando o transporte Streamable HTTP em vez do transporte stdio padrão:

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.22.4

Use a URL local: http://localhost:3000/v2/mcp ou a hospedada: https://mcp.firecrawl.dev/v2/mcp

Instalação via Smithery (legado)

Para instalar automaticamente o Firecrawl no Claude Desktop via Smithery:

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

Executando no VS Code

Para instalar com um clique, clique em um dos botões abaixo…

Para instalar manualmente, adicione o seguinte bloco JSON ao arquivo User Settings (JSON) do VS Code. Para isso, pressione Ctrl + Shift + P e digite Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl API Key",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json no seu espaço de trabalho. Assim, você poderá compartilhar a configuração com outras pessoas:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Observação: Alguns usuários relataram problemas ao adicionar o servidor MCP ao VS Code devido à forma como ele valida JSON usando um formato de esquema desatualizado (microsoft/vscode#155379). Isso afeta várias ferramentas MCP, incluindo o Firecrawl. Solução alternativa: Desative a validação de JSON no VS Code para que o servidor MCP seja carregado corretamente. Consulte: directus/directus#25906 (comentário). O servidor MCP continua funcionando normalmente quando invocado por outras extensões, mas o problema ocorre especificamente ao registrá-lo diretamente na lista de servidores MCP. Planejamos adicionar orientações assim que o VS Code atualizar a validação de esquema.

Executando no Claude Desktop

Para conectar uma conta de forma interativa, adicione o endpoint da conta e conclua o fluxo OAuth no navegador:

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

Para uma configuração sem supervisão ou com chave de API, use https://mcp.firecrawl.dev/v2/mcp com o header Authorization: Bearer <FIRECRAWL_API_KEY>. Se você receber o erro “Não foi possível acessar o servidor MCP”, sua versão do Claude Desktop pode não ser compatível com o transporte Streamable HTTP. Use a abordagem local com npx (requer Node.js):

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

Se aparecer o erro spawn npx ENOENT, o Node.js não está instalado ou não está incluído no PATH do sistema. Instale o Node.js em nodejs.org (versão LTS) e reinicie completamente o Claude Desktop. No Windows, você também pode executar where npx no Prompt de Comando e usar o caminho completo (por exemplo, C:\\Program Files\\nodejs\\npx.cmd) como valor de command.

No Claude Code

Adicione o servidor MCP do Firecrawl usando a CLI do Claude Code. Você pode usar a URL hospedada remotamente ou executá-lo localmente:

# Conexão interativa da conta (recomendado)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# Para uma configuração não assistida com chave de API, use um header Authorization
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer <FIRECRAWL_API_KEY>"

# Ou execute localmente via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-your-api-key -- npx -y firecrawl-mcp@3.22.4

No Google Antigravity

O Google Antigravity permite configurar servidores MCP diretamente pela interface do Agent.

Abra a barra lateral do Agent no Editor ou a visualização do Agent Manager
Clique no menu ”…” (Mais ações) e selecione MCP Servers
Selecione View raw config para abrir o arquivo local mcp_config.json
Adicione a seguinte configuração:

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

Salve o arquivo e clique em Atualizar na interface MCP do Antigravity para ver as novas ferramentas

Substitua YOUR_FIRECRAWL_API_KEY pela sua chave de API em https://firecrawl.dev/app/api-keys.

Executando no n8n

Para conectar o servidor MCP do Firecrawl ao n8n:

Obtenha sua chave de API do Firecrawl em https://firecrawl.dev/app/api-keys
No seu fluxo de trabalho do n8n, adicione um nó AI Agent
Na configuração do AI Agent, adicione uma nova Tool
Selecione MCP Client Tool como o tipo de ferramenta
Insira o endpoint do servidor MCP:

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

Defina Server Transport como HTTP Streamable
Defina Authentication como Bearer e cole sua chave de API do Firecrawl ou mantenha None para usar o nível gratuito sem chave
Em Tools to include, você pode selecionar All, Selected ou All Except — isso disponibilizará as ferramentas do Firecrawl (scraping, rastreamento, map, busca, Extract etc.)

Para implantações auto-hospedadas, execute o servidor MCP com npx e habilite o modo de transporte HTTP:

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp@3.22.4

Isso iniciará o servidor em http://localhost:3000/v2/mcp, que você pode usar como endpoint no seu fluxo de trabalho do n8n. A variável de ambiente HTTP_STREAMABLE_SERVER=true é obrigatória, pois o n8n requer transporte HTTP.

Primeiros passos

Endpoints principais

Mais

Guias de início rápido

Guias para desenvolvedores

Webhooks

Casos de uso

Outros

Como contribuir

Configure o Firecrawl MCP em um cliente

Executando no Cursor

Execução local com uma chave de API

Executando no Windsurf

Executando com o modo Streamable HTTP

Instalação via Smithery (legado)

Executando no VS Code

Executando no Claude Desktop

No Claude Code

No Google Antigravity

Executando no n8n

​Executando no Cursor

​Execução local com uma chave de API

​Executando no Windsurf

​Executando com o modo Streamable HTTP

​Instalação via Smithery (legado)

​Executando no VS Code

​Executando no Claude Desktop

​No Claude Code

​No Google Antigravity

​Executando no n8n

Executando no Cursor

Execução local com uma chave de API

Executando no Windsurf

Executando com o modo Streamable HTTP

Instalação via Smithery (legado)

Executando no VS Code

Executando no Claude Desktop

No Claude Code

No Google Antigravity

Executando no n8n