# Solução de problemas do MCP: 401, 403, ferramentas ausentes

_Conectar Claude / Codex · Leitura de 3 min · Atualizado 2026-11-08 · https://lanachat.ai/guides/pt/ai-troubleshooting/_

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: Bearer ` seguido do token. A palavra `Bearer` e 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.

1. Em **Users › API & MCP**, clique em **Edit** no token.
2. Marque a caixa de que a ação precisa (veja a tabela em [Crie seu token MCP](https://lanachat.ai/guides/pt/ai-create-mcp-token/)).
3. 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](https://lanachat.ai/guides/mcp-tool-reference/).
- 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.

> Tip: 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.

## Artigos relacionados

- [Proteja seu token](https://lanachat.ai/guides/pt/ai-security/)
- [MCP tool reference: every tool, by screen](https://lanachat.ai/guides/mcp-tool-reference/)
- [API & MCP: conecte um assistente de IA](https://lanachat.ai/guides/pt/api-mcp/)