> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-27eiio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecte o Firecrawl ao MCP

> Escolha o acesso sem chave, o login OAuth pelo navegador ou uma chave de API para seu cliente MCP.

Escolha a configuração de acordo com como a conexão será executada. Você não precisa definir se é humano ou agente.

<CardGroup cols={3}>
  <Card title="Teste na hora" icon="bolt" href="/pt-BR/mcp-server/keyless-api-key#try-instantly" cta="Iniciar configuração sem chave" arrow>
    Sem conta nem chave. Use Busca, Scraping e Parse com um limite diário compartilhado entre usuários no mesmo IP público.
  </Card>

  <Card title="Entre com sua conta" icon="right-to-bracket" href="/pt-BR/mcp-server/oauth" cta="Conectar conta" arrow>
    Login pelo navegador (OAuth) no ChatGPT, Claude.ai, Codex, Claude Code e outros clientes interativos. Acesso mais amplo às ferramentas.
  </Card>

  <Card title="Use uma chave de API" icon="key" href="/pt-BR/mcp-server/keyless-api-key#add-an-api-key" cta="Configurar uma chave de API" arrow>
    Acesso estável para agentes, CI e backends. Mantenha a chave fora do chat e do controle de versão.
  </Card>
</CardGroup>

A URL do servidor hospedado sem chave e com chave de API é:

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp
```

<Note>
  Esta é uma URL de servidor para seu cliente MCP, não uma página para abrir diretamente no navegador. O OAuth usa uma URL de servidor diferente, e seu cliente inicia o fluxo de login no navegador.
</Note>

Se você optar por usar uma chave de API, nunca a inclua em uma URL do MCP, em uma conversa com um agente ou em um arquivo de projeto submetido ao controle de versão. Configure-a por meio de uma variável de ambiente ou do armazenamento de segredos do seu cliente.

<div id="fix-a-broken-connection">
  ## Corrija uma conexão com falha
</div>

Use esta seção quando um erro do Firecrawl mencionar `KEYLESS_QUOTA_EXHAUSTED`, `KEYLESS_TOOL_NOT_AVAILABLE`, `KEYLESS_ACCESS_NOT_AVAILABLE`, `KEYLESS_ELIGIBILITY_UNAVAILABLE`, `CREDENTIAL_INVALID`, `OAUTH_CONNECTION_INVALID` ou uma credencial "inválida ou revogada".

* **Limite sem chave atingido:** aguarde o `retry_after_seconds` do erro (quando presente) ou peça ao operador humano para se conectar via OAuth ou configurar uma chave de API. busca, scraping e Parse permanecem disponíveis após a redefinição do limite.
* **Acesso sem chave indisponível:** para `KEYLESS_ELIGIBILITY_UNAVAILABLE`, tente novamente após o intervalo indicado. Se o problema persistir ou o erro for `KEYLESS_ACCESS_NOT_AVAILABLE`, peça ao operador humano para se conectar via OAuth ou configurar uma chave de API.
* **Ferramenta não disponível sem chave (`KEYLESS_TOOL_NOT_AVAILABLE`):** a ferramenta existe, mas não está disponível no modo sem chave. Conecte-se via OAuth ou configure uma chave de API para usá-la; busca, scraping e Parse continuam funcionando sem chave.
* **chave de API inválida ou revogada:** o operador humano ou do sistema deve substituir a chave na configuração existente do servidor, fora da conversa com o agente.
* **Conexão OAuth inválida em `/v2/mcp`:** adicione uma chave de API a esse servidor existente ou altere sua URL para `https://mcp.firecrawl.dev/v2/mcp-oauth` e faça login pelo cliente. Não abra essa URL diretamente em um navegador.
* **Conexão OAuth inválida em `/v2/mcp-oauth`:** faça login novamente pelo fluxo de conexão de conta do cliente.

Após qualquer alteração na credencial ou URL do servidor, mantenha uma única entrada de servidor `firecrawl`, inicie uma nova sessão do cliente e tente novamente. Consulte [Conexão OAuth](/pt-BR/mcp-server/oauth#switch-an-existing-keyless-connection) ou [configuração de chave de API](/pt-BR/mcp-server/keyless-api-key#add-an-api-key) para obter as etapas exatas.

<div id="go-deeper">
  ## Explore mais a fundo
</div>

<CardGroup cols={2}>
  <Card title="Escolha uma ferramenta" icon="wrench" href="/pt-BR/mcp-server/tools">
    Encontre a ferramenta Firecrawl MCP ideal para cada job e veja quais ferramentas cada modo de conexão disponibiliza.
  </Card>

  <Card title="Execute o MCP localmente" icon="terminal" href="/pt-BR/mcp-server/local">
    Execute o servidor MCP de código aberto via stdio ou Streamable HTTP.
  </Card>
</CardGroup>
