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

# Conecte um cliente MCP à sua conta

> Conecte um cliente MCP interativo à sua conta do Firecrawl

Use o endpoint de conta do Firecrawl quando houver uma pessoa disponível para fazer login e aprovar o acesso. Em vez da sua chave de API do Firecrawl, o cliente recebe tokens de curta duração vinculados a recursos.

Para ver todas as opções entre OAuth de conta, acesso não assistido com chave de API e acesso sem chave, consulte [Conectar o MCP do Firecrawl](/pt-BR/mcp-server/connect).

<div id="connect-an-interactive-client">
  ## Conecte um cliente interativo
</div>

Configure um cliente interativo compatível para:

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

Se o cliente solicitar um ID de cliente OAuth ou um segredo do cliente, deixe ambos em branco. Clientes compatíveis se identificam por meio de documentos de metadados de ID do cliente ou do Registro Dinâmico de Cliente.

O cliente abre o Firecrawl no seu navegador. Faça login, escolha a equipe que o conector deve usar, revise a solicitação de consentimento e aprove o acesso. As solicitações são cobradas da equipe selecionada.

Use os guias específicos para [ChatGPT](/pt-BR/developer-guides/mcp-setup-guides/chatgpt) e [Claude](/pt-BR/developer-guides/mcp-setup-guides/claude-ai), pois as telas de configuração e as regras de espaço de trabalho são diferentes.

<div id="cursor-and-vs-code-redirect-support">
  ### Suporte a redirecionamento para Cursor e VS Code
</div>

Use o endpoint da conta somente quando a versão instalada do cliente conseguir concluir um fluxo OAuth remoto. O Firecrawl aceita URIs de redirecionamento HTTPS e de loopback com `http://localhost`, `http://127.0.0.1` ou `http://[::1]`. Para clientes nativos de loopback HTTP, a porta pode variar a cada execução, mas o host e o caminho registrados devem corresponder à URI de redirecionamento solicitada.

Se o Cursor ou o VS Code não conseguir concluir o OAuth remoto na versão que você usa, configure `https://mcp.firecrawl.dev/v2/mcp` com o cabeçalho `Authorization: Bearer <FIRECRAWL_API_KEY>`. Mantenha a chave de API no ambiente do cliente ou em um armazenamento seguro de segredos; nunca a inclua na URL.

<div id="choose-the-hosted-mode">
  ## Escolha o modo hospedado
</div>

| Endpoint                                 | Use para                                        | Autenticação e conjunto de ferramentas                                                                                                                                                        |
| ---------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `https://mcp.firecrawl.dev/v2/mcp`       | Um teste sem chave ou um processo não assistido | Sem credenciais, expõe apenas Busca, Scraping e Parse quando elegível e sujeito a limites de taxa. Com `Authorization: Bearer <FIRECRAWL_API_KEY>`, expõe o conjunto completo de ferramentas. |
| `https://mcp.firecrawl.dev/v2/mcp-oauth` | Uma conexão interativa de conta via navegador   | Abre o OAuth e expõe o conjunto completo de ferramentas após a autorização. chaves de API também são aceitas por compatibilidade.                                                             |

Para CI, servidores, scripts e outros clientes não assistidos, use `https://mcp.firecrawl.dev/v2/mcp` com um cabeçalho `Authorization: Bearer <FIRECRAWL_API_KEY>` fornecido por uma variável de ambiente. Não coloque uma chave de API em uma URL ou em um arquivo de configuração do projeto.

<div id="manage-a-connection">
  ## Gerencie uma conexão
</div>

Para desconectar um cliente, abra **MCP** nas [configurações do Firecrawl](https://www.firecrawl.dev/app/settings?tab=mcp) e revogue a conexão. A revogação invalida os tokens de acesso e de atualização; reconecte-se pelo cliente para autorizar novamente.

<div id="compatibility-during-migration">
  ## Compatibilidade durante a migração
</div>

* Os tokens OAuth existentes vinculados explicitamente a `/v2/mcp` continuam funcionando em `/v2/mcp`.
* Durante o período de migração, um token compatível existente de `/v2/mcp` também pode ser aceito por `/v2/mcp-oauth`.
* Um novo token emitido para `/v2/mcp-oauth` não é aceito por `/v2/mcp`.
* Tokens com público ausente ou ambíguo falham de forma segura.
* As configurações MCP legadas existentes com chave no caminho continuam funcionando, mas as novas configurações devem usar OAuth ou um cabeçalho Bearer.

<div id="security-properties">
  ## Propriedades de segurança
</div>

* Os tokens de acesso expiram após uma hora.
* Os tokens de atualização são renovados a cada atualização bem-sucedida.
* Cada conexão está vinculada ao respectivo cliente OAuth, usuário, equipe, escopo e recurso MCP.
* Os clientes OAuth usam o fluxo Código de autorização com PKCE e não exigem um segredo de cliente.

<div id="supported-standards">
  ## Padrões compatíveis
</div>

* Código de autorização OAuth 2.0 com PKCE (S256)
* Metadados do servidor de autorização RFC 8414
* Metadados de recurso protegido RFC 9728
* Documentos de metadados de ID do cliente (CIMD)
* Registro Dinâmico de Cliente (DCR) RFC 7591
* Indicadores de recurso RFC 8707

Novas conexões de conta devem usar exatamente este recurso nas solicitações de autorização e token:

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

Os metadados do servidor de autorização estão disponíveis em:

```bash theme={null}
curl -s "https://www.firecrawl.dev/.well-known/oauth-authorization-server" | jq .
```