Conector de IA (MCP)
O que o Claude (e outros clientes de IA) consegue acessar e fazer no OctaGym pelo servidor MCP — catálogo de ferramentas, permissões e limites.
Conector de IA (MCP)
O OctaGym publica um servidor MCP remoto (Model Context Protocol). Conectando o Claude.ai — ou qualquer cliente compatível, como Claude Code e Cursor — o assistente passa a ler dados reais da sua empresa e executar ações dentro das mesmas regras do dashboard.
https://dashboard.octagym.ai/api/mcp/v1A URL exata está no painel
Copie o endereço em Configurações → Integrações → MCP. Ele é sempre a origem do seu dashboard
/api/mcp/v1.
O que dá para fazer
| Área | Exemplos de pergunta / pedido |
|---|---|
| Gestão do dia | "O que mudou no risco de cancelamento nas últimas 24h?" |
| Retenção | "Quem está prestes a cancelar e por quê? Monte um plano de reativação." |
| Financeiro | "Feche julho: DRE, fluxo de caixa e as divergências com a adquirente." |
| Cobrança | "Quem está inadimplente há mais de 15 dias e quanto isso representa?" |
| Marketing | "Crie uma campanha de e-mail para os alunos inativos há 30 dias." |
| Operação | "Qual a ocupação agora? Quais aulas estão com vaga sobrando amanhã?" |
| Catálogo | "Cadastre esse produto com as variações de sabor e dê entrada no estoque." |
| Portal | "Ajuste a página de planos do site e publique." |
São 151 ferramentas hoje: 80 de leitura e 71 de escrita, além de 2 recursos e 6 prompts prontos.
Conectar
Passo a passo pelo Claude.ai (sem terminal), Claude Code/Cursor e API key.
Permissões e segurança
Escopos, RBAC por usuário, unidade, aprovações, rate limit e auditoria.
Catálogo de ferramentas
As 151 ferramentas por área, com a permissão que cada uma exige.
Prompts e recursos
Roteiros prontos (briefing do dia, auditoria financeira) e recursos por URI.
MCP ou API REST?
As duas superfícies existem e atendem públicos diferentes.
| MCP | API REST v1 | |
|---|---|---|
| Para quem | Assistentes de IA (Claude, Cursor) | Sistemas e integrações próprias |
| Autenticação | OAuth por usuário ou API key | API key |
| Autorização | Permissões do usuário conectado | Acesso total da empresa (service account) |
| Formato | JSON-RPC / MCP sobre HTTP | REST + JSON |
| Cobertura | 151 ferramentas em 13 áreas | Endpoints públicos de alunos, planos, mensalidades, aulas, treinos, acesso e métricas |
| Documentação | esta seção | Referência da API |
Se você está escrevendo código, use a API REST. Se você quer conversar com a operação, use o MCP.
Como o conector se comporta
- Draft-first no marketing. Campanhas de e-mail, notificação e WhatsApp nascem como rascunho.
Nada é disparado sem o
confirm_campaign_send— que é uma ação separada, feita depois de você revisar público e conteúdo. - Aprovação humana no que é irreversível. Estorno, mesclagem de fornecedor, lote de VA/VT e pagamentos acima do limite da empresa viram solicitação no painel de aprovações, não execução.
dry_runno financeiro. Toda escrita financeira aceita simular antes de gravar.- Nada é apagado. Cancelar e desativar mudam status; deletes destrutivos ficaram fora do MCP de propósito e continuam só no dashboard.
O que o conector não faz
- Não exclui registros (produto, evento, template de WhatsApp, título financeiro — tudo é status).
- Não cria funcionário (
create_staffdispara onboarding de conta e ficou fora). - Não estorna pagamento diretamente — abre solicitação de aprovação.
- Não expõe dado sensível de RH (salário, documentos, conta bancária do colaborador) nem credencial de pagamento de fornecedor (dados bancários e chave Pix saem mascarados).
- Não devolve números financeiros para quem não tem
finance:read— a resposta de métricas é redigida.