Solução de problemas

Resolva erros comuns de conexão e de ferramentas do MCP do Autentique.

Use estas verificações quando um cliente MCP não conseguir se conectar ao Autentique ou uma ferramenta não funcionar como esperado.

O conector pede para entrar novamente

A autorização pode ter expirado ou sido revogada. Reconecte o servidor MCP e aprove novamente as permissões solicitadas.

A página de autorização não abre

Confirme que o cliente oferece suporte a OAuth para servidores MCP remotos via Streamable HTTP. Remova a conexão, adicione novamente a URL do servidor e reinicie o fluxo de autorização.

O cliente não encontra as ferramentas

Confirme que a URL do servidor é exatamente:

https://api.autentique.com.br/mcp

Não adicione outro caminho nem use o endpoint da API GraphQL. Reinicie o cliente depois de alterar a configuração do MCP.

Um documento ou uma organização não é encontrado

Confirme que o usuário conectado ao Autentique tem acesso ao recurso e que o contexto da organização correta está sendo usado. O servidor MCP não acessa recursos indisponíveis para esse usuário.

Não foi possível criar um documento

Prepare um novo envio e tente novamente de forma consciente. Não reutilize um identificador de envio depois de uma tentativa de criação com falha. Os envios expiram após 15 minutos e ficam vinculados ao usuário autenticado, à organização, ao nome do arquivo, ao tipo de conteúdo e ao tamanho.

Uma ferramenta de escrita não está disponível

O usuário autenticado pode não ter a permissão necessária, o documento pode não ser mais editável ou o cliente MCP pode restringir operações de escrita. Revise a conta conectada, o status do documento e as configurações de aprovação do cliente.

Precisa de ajuda?

Acesse a Central de Ajuda do Autentique e informe o nome do cliente, o horário aproximado da falha e a ação que você tentou executar. Nunca inclua senhas ou tokens OAuth.