O servidor MCP da academia permite que assistentes de IA como Claude, ChatGPT e Cursor consultem e ajustem dados da sua academia usando uma chave que você controla. Fica em Configurações → API e MCP, que reúne as abas Chaves, Webhooks e Conectores. Pela página IA, o card Conectores também leva até lá.
Ligar o servidor e gerar uma chave
- Abra Configurações → API e MCP e clique na aba Conectores.
- Se aparecer Ativar servidor MCP, clique nele. Só depois dá para gerar uma chave para o MCP.
- Em Servidor MCP Oficial da Academy, clique em Copiar ao lado da URL do Endpoint MCP.
- Abra a aba Chaves e clique em Nova chave. Só o dono da academia cria chaves.
- Dê um Nome, escolha a Validade e, em Onde a chave vale, marque MCP (assistentes de IA).
- Em Permissões, marque Ler pelo MCP ou Alterar pelo MCP em cada módulo. Alterar inclui ler.
- Deixe Dados pessoais sem máscara desligado, a menos que precise. Sem ele, e-mail, telefone e documento chegam mascarados à IA.
- Clique em Criar chave, confirme com o código enviado ao seu e-mail, copie a chave e guarde-a.
Conectar o assistente
Em Como conectar, na aba Conectores, ficam as instruções prontas já com a URL da sua academia. Troque o marcador pela sua chave.
- Claude Code: um comando para executar no terminal.
- Claude Desktop: um trecho para o arquivo de configuração do aplicativo.
- Cursor: um trecho para o arquivo de configuração do editor.
- ChatGPT: uso como ferramenta pela API da OpenAI ou pelo Agents SDK.
Depois, veja o que cada ferramenta faz em Ferramentas e escopos e peça exemplos em Exemplos de pedidos.
Controlar o acesso
- Revogar: na lista de chaves, a chave deixa de funcionar na hora. Não dá para desfazer.
- Rotacionar: sai uma chave nova com as mesmas permissões e a antiga para de valer. Troque a chave no assistente logo depois.
- Pausar todas as alterações: chave no conector. Ligada, nenhuma chave cria, altera ou exclui pelo MCP, mesmo com permissão de alterar.
- Assistente do aluno: o card Dois MCPs, dois públicos mostra se o conector do aluno está ligado. Veja Conectar minha IA aos meus cursos.
Segurança
- Cada chave só enxerga a sua academia.
- Dinheiro é só leitura: nunca há estorno, saque ou transferência.
- Algumas alterações críticas pedem a aprovação de uma pessoa da equipe no painel, na página Aprovar alteração pedida por um aplicativo de IA. O pedido vale por 15 minutos.
- O Growth (contatos, funis, conversas, automações) não entra nesta chave: ele é da chave do Bot externo. Veja Configurar o CRM com sua IA.
- O histórico de chamadas e o consumo ficam em Auditoria de chamadas MCP e no dashboard, na aba Conectores.