Problemas comuns

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, Conectar o ChatGPT e Conectar o Claude Code e o Cursor.

#A conexão

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

O assistente está sem uma chave válida.

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.

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.

#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, ainda sem tela no painel. Ver Versão 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.
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"

#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:

#Relacionados

• Visão geral do MCP
• Segurança e limites
• Ferramentas