# Problemas comuns

> O que fazer quando o assistente não conecta, perde a conexão, não mostra uma ferramenta, age na comunidade errada ou recusa uma confirmação de dinheiro, e o que o MCP ainda não faz.

Os problemas mais comuns com o MCP, com a causa e o caminho para resolver. Para o passo a passo de cada assistente, ver [Conectar o Claude](/mcp/conectar-o-claude), [Conectar o ChatGPT](/mcp/conectar-o-chatgpt) e [Conectar o Claude Code e o Cursor](/mcp/conectar-claude-code-e-cursor).

## A conexão

### "Não autorizado", 401 ou "token expirado"

O assistente está sem uma chave válida.

| Causa | O que fazer |
|---|---|
| A autorização não terminou (a janela foi fechada antes do **Permitir**) | Conecte de novo pelo assistente |
| Você desconectou em **Minha Conta › Assistentes de IA**, ou um administrador desconectou em **Configurações** | Conecte de novo, se fizer sentido |
| A conexão ficou mais de 30 dias sem uso | Conecte de novo |
| Você saiu da comunidade | A conexão não serve mais; peça para voltar à comunidade |
| A Memberfy derrubou a conexão por segurança (uma chave já usada apareceu de novo) | Conecte de novo. Se acontecer outra vez, remova o conector e adicione do zero |

A chave de acesso dura 1 hora e é renovada sozinha; se o assistente pedir para conectar de novo com frequência, remova o conector e adicione outra vez.

### *"Este pedido de acesso não é válido"*

A tela de autorização recebeu um pedido incompleto, ou de um endereço de retorno que não confere. Remova o conector no assistente, adicione de novo e conecte.

### A comunidade não aparece na tela de autorização

A conta com que você entrou não participa dela. Saia da Memberfy no navegador e entre com a conta certa antes de conectar.

## As ferramentas

### Uma ferramenta não aparece

O assistente só vê as ferramentas que o seu papel pode usar. Um moderador não vê `create_plan`; um membro não vê `list_members`; o financeiro não vê `request_payout`. Confira o seu papel com *"em que comunidade e com que papel você está?"* e compare com [Ferramentas](/mcp/ferramentas#quantas-cada-papel-ve).

Outras causas:

- A conexão foi autorizada **só para leitura**: as de criação e de dinheiro não aparecem. Conecte de novo com leitura e escrita.
- O conector está desligado na conversa (Claude) ou não foi selecionado (ChatGPT).

### O assistente usa nomes antigos, como `criar_post`

Em 6/10/2026 as ferramentas passaram a ter nomes em inglês (`create_post`, `list_spaces`, `issue_certificate`). Uma conversa aberta antes disso pode continuar com a lista antiga, e a chamada falha porque a ferramenta não existe mais. Abra uma **conversa nova**; se não resolver, conecte o conector de novo. Os nomes atuais estão em [Ferramentas](/mcp/ferramentas).

### Falta uma ferramenta, ou o assistente diz que ela não existe

Alguns assistentes guardam a lista de ferramentas da Memberfy do começo da conversa. Se a Memberfy atualizou o servidor depois disso, o assistente continua com a lista antiga: não vê uma ferramenta nova, ou tenta usar uma que mudou de nome.

1. Abra uma **conversa nova**.
2. Se não resolver, desconecte e conecte de novo o conector da Memberfy no assistente.

Quando o assistente tenta usar uma ferramenta que mudou de nome ou que não está na lista dele, a Memberfy avisa na própria resposta: diz o nome novo, ou pede para abrir uma conversa nova ou reconectar.

O proprietário e os administradores da comunidade conseguem ver qual versão da lista cada conexão recebeu e se ela está em dia. Por enquanto isso fica na API, no [diagnóstico da conexão](/api/referencia/mcp/get-oauth-connections-by-id-diagnostics), ainda sem tela no painel. Ver [Versão do servidor e da lista](/mcp/ferramentas#versao-do-servidor-e-da-lista).

### *"Seu papel (…) não permite esta ação nesta comunidade."*

A ferramenta aparece, mas aquela ação específica é recusada. Exemplos:

- um membro publicando num espaço com **Quem pode postar = Equipe**;
- um moderador usando `create_event` com ingresso, ou sem informar um espaço que já existe;
- uma ação num espaço que o seu papel não vê.

### *"A API recusou (400): …"*

Um valor inválido: um preço zerado, um título curto demais, uma data sem fuso, um id de outra coisa. A mensagem diz qual campo. Peça ao assistente para corrigir e tentar de novo.

### Uma composta falhou no meio

A resposta diz qual passo falhou e que tudo foi desfeito. Corrija a causa (por exemplo, use um espaço do módulo certo) e peça de novo. Se a resposta disser que algo **não** pôde ser desfeito, confira o item listado no painel e apague à mão.

### *"Muitas chamadas em pouco tempo"*

O limite é de 120 chamadas de ferramenta por minuto por conexão. Acontece em pedidos grandes (responder a 200 comentários de uma vez). Espere um minuto, ou peça em partes.

## A comunidade errada

O assistente criou algo na comunidade errada porque estava conectado a ela. Cada conexão é de uma comunidade só.

1. Pergunte: *"em que comunidade você está conectado?"*.
2. Desligue na conversa o conector da comunidade errada e ligue o da certa. Se não houver, crie uma [conexão para a outra comunidade](/mcp/autorizar-e-desconectar#trocar-de-comunidade).
3. Apague pelo painel o que foi criado no lugar errado (não há ferramenta de apagar).

Para evitar: dê nomes claros aos conectores (*Memberfy · Escola*, *Memberfy · Coworking*) e deixe ligado só um por conversa.

## A confirmação de dinheiro e de exclusão

### *"Confirmação inválida, vencida, já usada ou com argumentos diferentes"*

| Causa | O que fazer |
|---|---|
| Passaram mais de 10 minutos entre o resumo e o seu sim | Peça de novo: o assistente gera um resumo novo |
| O assistente mudou algum valor na segunda chamada | Peça de novo; confira se o resumo novo tem os valores certos |
| O código já foi usado (a ação já aconteceu) | Confira no painel antes de pedir de novo, para não duplicar |

### O assistente executou sem perguntar

As ferramentas de dinheiro e de exclusão sempre devolvem um resumo primeiro. Se o assistente seguiu sem mostrar, ele não seguiu as instruções. Confira no painel o que foi feito, desconecte e reconecte, e diga explicitamente no começo da conversa: *"sempre me mostre o resumo antes de confirmar qualquer coisa com dinheiro ou exclusão"*.

Convites, troca de papel, configurações e emissão de certificados **não** pedem a confirmação da Memberfy: rodam na primeira chamada. Se você quer revisar antes, peça *"me mostre antes de fazer"*, e mantenha essas ferramentas como "perguntar antes" nas permissões do assistente.

## O que ainda não dá para fazer

O MCP ainda não cobre tudo o que o painel faz. Estas ficam para depois, e continuam pelo painel:

| Não dá ainda | Por enquanto |
|---|---|
| Gravar o conteúdo de uma aula (texto, vídeo) | O assistente cria a aula com título, tipo e duração; o conteúdo entra pelo painel |
| Editar ou apagar módulo e aula | Pelo painel |
| Agendar um post | O post sai na hora |
| Inscrever quem comprou o ingresso na lista de participantes | A compra libera o espaço; a presença é confirmada pela pessoa |
| Reembolsar | Pelo painel |
| Trocar o plano de outro assinante | Só quem assina muda o próprio plano, pelo [Faturamento](/pagamentos/faturamento-do-membro#mudar-de-plano) ou com `change_my_plan` |
| Moderar vários itens numa chamada só | O assistente modera um item por vez, com `moderate_item` |
| Mudar o domínio, o idioma e as integrações da comunidade | Pelo painel |
| Apagar qualquer coisa | Pelo painel |

## Relacionados

- [Visão geral do MCP](/mcp/o-que-e-o-mcp)
- [Segurança e limites](/mcp/seguranca)
- [Ferramentas](/mcp/ferramentas)