> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/autentique-mcp/solucao-de-problemas.md).

# 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](https://ajuda.autentique.com.br/pt-BR/) 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.