Skip to main content
Conecte o Grok Build, a CLI de agente de programação da xAI (grok), ao Firecrawl por meio do servidor MCP hospedado. O OAuth é a configuração interativa recomendada. Com o OAuth, a chave não precisa ser inserida na linha de comando, nos arquivos do projeto nem na conversa.

​
Configuração rápida

​
  1. Adicione o Firecrawl

Execute:
https://mcp.firecrawl.dev/v2/mcp-oauth é um valor de configuração do cliente, e não uma página para abrir diretamente no navegador.

​
  1. Faça login e verifique

Inicie o Grok Build:
Digite /mcps, selecione firecrawl e pressione i para iniciar o login pelo navegador. Escolha uma equipe e aprove a conexão. O Grok armazena os tokens OAuth em ~/.grok/mcp_credentials.json. Verifique se há apenas um servidor firecrawl ativo e, em seguida, experimente:

​
O que você pode fazer

Busca

Encontre informações atualizadas e leia o conteúdo dos resultados relevantes.

Scraping

Converta URLs em markdown limpo ou dados estruturados.

Interagir

Navegue, clique e preencha formulários para chegar aos dados de que você precisa.

Alexandria

Descubra ferramentas de dados estruturados, confira as entradas e os preços e execute-as pelo Firecrawl.

​
MCP local com uma API key

Use o servidor local somente quando precisar de um processo local ou de uma API do Firecrawl auto-hospedada. O pacote local requer Node.js 22 ou superior. Defina FIRECRAWL_API_KEY no ambiente que inicia o Grok. Em seguida, adicione este bloco ao ~/.grok/config.toml:
O Grok expande ${FIRECRAWL_API_KEY} ao carregar a configuração, então a chave não fica gravada no arquivo. Mantenha o segredo fora do chat com o agente e do controle de versão. Use apenas uma entrada firecrawl: antes, remova o servidor hospedado com grok mcp remove firecrawl. Para configurações self-hosted, veja Executar o MCP localmente.

​
Outros modos de conexão

  • Experimente o MCP sem chave para usar Pesquisar, Raspar e Parse sem conta nem chave.
  • Configure uma API key para uso não assistido do servidor hospedado. Mantenha o segredo fora do chat do agente e use uma referência a uma variável de ambiente.

​
Solução de problemas

  • Já existe um servidor do Firecrawl: execute grok mcp remove firecrawl, adicione a conexão desejada uma única vez e inicie uma nova sessão.
  • O Grok mostra um segundo servidor firecrawl: o Grok também carrega servidores MCP de ~/.claude.json, .cursor/mcp.json e de arquivos .mcp.json do projeto. Execute grok inspect para ver a origem de cada servidor e remova o duplicado.
  • O servidor mostra 401: digite /mcps, selecione firecrawl e pressione i para fazer login novamente. Não cole uma API key na conversa nem na URL do OAuth.
  • O servidor local não conecta: execute grok mcp doctor firecrawl. O Grok grava os erros do servidor em ~/.grok/logs/mcp/firecrawl.stderr.log. Se o npx baixar o pacote na primeira inicialização, aumente o valor de startup_timeout_sec.