Solução de problemas do MCP: 401, 403, ferramentas ausentes
A maioria dos problemas do MCP do LanaChat vem do token: errado, expirado ou sem uma caixa. Encontre o erro que você vê na tabela e depois os detalhes abaixo.
| O que você vê | Causa provável | Correção |
|---|---|---|
401, "unauthorized" | token errado, expirado, revogado ou rotacionado | copie-o de novo ou use Rotate, confira o Bearer |
403, "permission", "requires …" | o token não tem uma caixa | use Edit no token, marque a caixa, reinicie |
| "tool not found" | caixa desmarcada, nome inventado, servidor não adicionado | marque a caixa, confira o /mcp |
409, "revision" ou "hash" | o item mudou nesse meio-tempo | leia-o de novo e refaça a alteração |
| "request too large" | mais de 4 MiB em uma requisição | envie os arquivos ao Vault ou pelo Drive |
| sem resposta | rede ou uma reinicialização curta | tente de novo em alguns minutos |
401: unauthorized #
O servidor não aceitou o token.
- O token foi copiado com um caractere faltando ou sobrando. Copie-o de novo, do lugar onde você o guardou.
- O cabeçalho deve ser exatamente
Authorization: Bearerseguido do token. A palavraBearere o espaço são obrigatórios. - O token foi revogado, ou rotacionado (o antigo morre na hora). Em Users › API & MCP, confira o status dele.
- O token expirou: os tokens duram 365 dias. Clique em Rotate (ou Renew) e coloque o novo no seu assistente.
- Você usou uma chave de funcionário (Team Management) ou uma senha da Console. O MCP aceita somente um token de API & MCP.
403: forbidden, ou "permission" #
O token é válido, mas não tem uma caixa para esta ação.
- Em Users › API & MCP, clique em Edit no token.
- Marque a caixa de que a ação precisa (veja a tabela em Crie seu token MCP).
- Salve, depois feche e reinicie o seu assistente.
Dois casos especiais:
- Atribuir uma licença é recusado: o token não tem Spend the balance on licences (ele exige também Read sales, e só o titular do workspace pode marcá-la), ou o Daily limit for licences foi atingido (0 significa nenhuma licença). A recusa diz qual é o caso. Corrija com Edit no token, ou atribua a licença na Console, em Billing › Licences.
- Playground recusado: as respostas do Playground exigem saldo positivo. Recarregue em Billing › Top up, ou pule o teste.
Uma ferramenta está ausente, ou "tool not found" #
- Sem Configure agency AI, o assistente recebe apenas as ferramentas de configuração 132, de fãs e de vendas: nenhuma ferramenta de AI Brain, Playground ou publicação. Marque a caixa e reinicie.
- Uma ferramenta que aparece na lista mas recusa ("requires can_generate", "requires the owner's can_publish permission") indica uma caixa ausente no token. Marque-a com Edit e reinicie.
- O assistente inventou um nome. Peça a ele: "List the tools of lanachat." Os nomes reais estão na referência das ferramentas.
- O servidor não está conectado: no Claude Code ou no Codex digite
/mcp; em um editor, confira as configurações de MCP dele.
409, "revision" ou "hash" alterado #
Alguém (ou o próprio assistente) alterou a mesma coisa nesse meio-tempo. Peça ao assistente que leia o item de novo e refaça a alteração com a revisão atual. Nada foi perdido.
Requisição grande demais #
Uma requisição MCP é limitada a 4 MiB. Fotos e vídeos não passam pelo chat: envie-os ao Vault, ou informe o link de uma pasta pública do Google Drive e deixe o assistente importá-la.
O servidor não responde #
- Confira a sua conexão com a internet.
- Tente de novo em alguns minutos: o servidor pode ter uma reinicialização curta.
- Continua fora do ar após 15 minutos: escreva para nós pela Console (Support) com o horário e o nome da ferramenta. Nunca envie o token.
Dica Depois de qualquer alteração em um token (Edit, Rotate), reinicie o assistente. Ele só lê a lista de ferramentas quando se conecta.
FAQ #
Por que uma ferramenta aparece na lista mas se recusa a rodar? #
Todas as ferramentas da família são listadas, e as caixas são verificadas a cada chamada. Uma recusa que cita uma permissão significa que o token não tem aquela caixa.
Meu token funcionava ontem. Por que 401 hoje? #
Ele foi rotacionado, revogado ou expirou (365 dias). Confira o status dele em Users › API & MCP e coloque o novo token no seu assistente.
Preciso reiniciar o assistente depois de editar o token? #
Sim. O assistente só lê a lista de ferramentas quando se conecta.