Skip to main content

​
Conectar-se com OAuth

https://mcp.firecrawl.dev/v2/mcp-oauth é uma URL de servidor para seu cliente MCP. Não é uma página para abrir diretamente no navegador. Seu cliente inicia o fluxo de login no navegador.
Use OAuth quando houver uma pessoa disponível para fazer login, escolher uma equipe do Firecrawl e aprovar o acesso. O cliente recebe tokens para essa conexão, em vez de solicitar que você copie uma chave de API do Firecrawl para a conversa. A página de login pede que você escolha uma equipe e aprove a conexão. Se o cliente solicitar um ID do cliente ou segredo do cliente do OAuth, deixe ambos em branco. Clientes compatíveis se identificam automaticamente. As solicitações feitas por essa conexão usam a equipe selecionada. Você pode revisar ou revogar a conexão nas configurações do MCP. Precisa de uma conexão não assistida? Use a configuração com chave de API. Não cole a chave em uma conversa com um agente nem a inclua na URL do MCP.

​
Verifique a conexão

Inicie uma nova sessão do cliente e tente:
Se nenhuma ferramenta do Firecrawl for exibida, abra o status do MCP do cliente, confirme que firecrawl está autenticado e verifique se há apenas uma entrada de servidor Firecrawl ativa.

​
Altere uma conexão keyless existente

Atualize ou substitua o servidor firecrawl existente pela URL do servidor OAuth. Não adicione uma segunda entrada do Firecrawl. Após a alteração, inicie uma nova sessão do cliente antes de tentar a solicitação novamente.

​
Codex

Execute:
O Codex substitui o servidor existente com o mesmo nome. Digite /mcp e confirme que o firecrawl está conectado.

​
Claude Code

O Claude Code não substitui um servidor existente com o mesmo nome. Remova a entrada atual e adicione a entrada OAuth:
Abra /mcp no Claude Code e faça login no navegador.

​
Outros clientes

Edite o servidor firecrawl existente e defina o URL como:
Salve a configuração, conclua o login iniciado pelo cliente e abra uma nova sessão no cliente.

​
Detalhes de compatibilidade e segurança

Os tokens OAuth existentes emitidos para /v2/mcp continuam sendo aceitos nesse endpoint. Novas conexões interativas usam /v2/mcp-oauth, e os tokens emitidos para esse recurso de conta não são aceitos por /v2/mcp.
O Firecrawl usa o fluxo OAuth de Código de autorização com PKCE. Clientes compatíveis podem se identificar com um Documento de metadados de ID do cliente ou Registro dinâmico de cliente, dispensando um segredo do cliente.O Firecrawl aceita URLs de redirecionamento HTTPS e redirecionamentos de loopback em localhost, 127.0.0.1 ou [::1]. Para clientes nativos que usam redirecionamento de loopback, a porta pode mudar entre execuções. O restante da URL de redirecionamento registrada deve corresponder exatamente.
Os tokens de acesso expiram após uma hora. Os tokens de atualização são rotacionados após uma atualização bem-sucedida. Cada conexão está vinculada ao cliente OAuth, usuário, equipe, escopo e recurso MCP.Um novo token emitido para /v2/mcp-oauth não é aceito por /v2/mcp. Tokens com público ausente ou ambíguo são rejeitados.
Abra MCP nas Configurações do Firecrawl e revogue a conexão. A revogação invalida os tokens de acesso e atualização da conexão. Reconecte-se pelo cliente para autorizá-lo novamente.
As solicitações feitas por uma conexão consomem os créditos da equipe selecionada durante o login, de acordo com o plano dessa equipe. Cada conexão é listada nas configurações de MCP, onde pode ser revisada e revogada a qualquer momento. Para controles de SSO e para toda a organização, consulte Enterprise.

​
Mais recursos

Compare as opções de conexão

Volte ao seletor de configuração do MCP.

Escolha uma ferramenta

Conheça o conjunto de ferramentas do Firecrawl MCP.