Sua escola inteira,a uma conversa de distância
O Cademí MCP conecta o Claude e outros assistentes de IA à sua conta. Pergunte por que um aluno não consegue entrar, o que tem num curso, ou mude o que precisa mudar, com as suas permissões e o seu nome em cada ação.
Uma conexão.
A conta inteira.
Cada operação da API v3 é uma ferramenta, gerada do mesmo contrato da referência da API. Por cima delas, ferramentas compostas respondem perguntas inteiras numa única chamada.
- ferramentas
- 396
- ferramentas compostas
- 5
- recursos
- 44
- códigos de erro
- 13
Respostas, não endpoints
As ferramentas compostas juntam de várias operações de uma vez o que uma pergunta de suporte precisa. Cite o aluno pelo e-mail ou nome e o curso pelo título: a ferramenta encontra os dois e pergunta de volta quando um nome bate com mais de um.
- student_access_context
Por que um aluno entra ou não entra
O veredito de acesso, as matrículas naquele produto, o calendário de liberação e o progresso, com um diagnóstico em códigos de motivo, a evidência e o próximo passo.
student_access_contextSó leitura“Por que o João não vê o módulo 3?”- Acesso
- Parcial
- Motivo
CONTENT_PARTIALLY_RELEASED- Evidência
- O módulo 3 libera 14 dias após a matrícula, em 2 de outubro
- Próximo passo
- Esperar a liberação ou conceder uma exceção
- student_context
Tudo sobre um aluno
O perfil, todas as matrículas e o acesso efetivo a cada produto, com um resumo do que está ativo e do que não está.
student_contextSó leitura“A Maria tem acesso a quê?”- Aluna
- Maria Lima
- Matrículas
- 3 ativas · 1 expirada
- Produtos
- 3 com acesso · 1 sem
- Situação
- Ativa
- product_context
Um produto num relance
Detalhes e situação, um resumo do conteúdo, as entregas que vendem ou liberam o produto e as agendas de acesso.
product_contextSó leitura“Como o curso de Marketing é vendido?”- Produto
- Marketing Essencial · publicado
- Conteúdo
- 4 módulos · 18 aulas · 2 rascunhos
- Entregas
- 2 ofertas liberam este produto
- Agendas
- 1 agenda de acesso
- product_structure
A árvore inteira do curso
Cada módulo e cada aula, em ordem, com a situação de publicado ou rascunho e os totais.
product_structureSó leitura“Quais aulas ainda estão em rascunho?”- Módulos
- 4
- Aulas
- 18 · 16 publicadas
- Rascunhos
- Campanhas › Teste A/B, Medindo resultados › Atribuição
- instance_overview
Em qual conta você está
A conta conectada: nome, produção ou sandbox, situação de cobrança e bloqueio, cota de alunos e uso da API nas últimas 24 horas.
instance_overviewSó leitura“Estou em produção ou no sandbox?”- Conta
- Acme Academy
- Ambiente
- Produção
- Alunos
- 8.420 de 10.000
- Uso da API
- 12.380 chamadas em 24 h
- O que cada ferramenta devolve →
- Acesso
- Parcial
- Motivo
CONTENT_PARTIALLY_RELEASED- Evidência
- O módulo 3 libera 14 dias após a matrícula, em 2 de outubro
- Próximo passo
- Esperar a liberação ou conceder uma exceção
Pergunte como perguntaria a um colega
Copie um prompt e teste no seu assistente.
- Diagnosticar acesso
Por que a [email protected] não consegue acessar o curso de Marketing? Me diga o que fazer.
- Auditar um aluno
Audite a experiência da Maria Lima: as matrículas, o progresso e qualquer coisa que a bloqueie.
- Revisar um curso
Me dê a estrutura completa do curso de Marketing e liste as aulas que ainda estão em rascunho.
- Alunos recentes
Liste os 5 alunos mais recentes e os produtos a que cada um tem acesso.
- Situação da conta
Em qual conta estou conectado? É produção ou sandbox, e quanto falta para a cota de alunos?
- Liberar acesso
Matricule o [email protected] no curso de Marketing até 31 de dezembro. Me pergunte antes de fazer.
Feito para o administrador, não em volta dele
O assistente trabalha com a mesma API, as mesmas permissões e o mesmo log de auditoria que todos na sua conta. Como funciona a autorização
- 01
Nenhuma chave para copiar
Você entra com OAuth na própria Cademí e aprova a conexão. Nunca cola uma chave numa conversa.
- 02
Suas permissões, nada além
O assistente age como o administrador que o aprovou, numa conta só. A API confere cada chamada.
- 03
Toda mudança registrada
Cada mudança vai para o log de auditoria da conta, com a credencial própria da conexão e o que mudou.
- 04
Pergunta antes de mudar
Cada ferramenta diz se lê, altera ou remove algo, então o seu cliente pode perguntar antes de uma mudança e avisar antes de uma remoção.
Conecte em um minuto
Adicione um endereço ao seu assistente, entre na Cademí e aprove. Nada para instalar e nenhuma chave para colar.
- 1Abra Configurações e depois Conectores.
- 2Escolha Adicionar conector personalizado e cole o endereço do servidor.
- 3Clique em Conectar, escolha sua conta e entre como administrador.
- 4Aprove a conexão. Depois, faça a primeira pergunta.
Toda ação tem um nome
e um rastro por trás.
O que o seu assistente faz pelo Cademí MCP vai para o mesmo log de auditoria e de requisições que a API e a CLI. Um rastro só, qualquer que seja a porta de entrada, até o campo que mudou.
- Pergunta“Prorrogue o acesso do João ao Marketing Essencial até 31 de dezembro.”
- Cliente
- Claude
- Chamada de ferramentausers_enrollments_update
- ID da chamada
- 3f9c2a1e-7b4d-4c8a-9e21-5d6f0a8b1c34
- Aprovada por
- você, no cliente
- Requisição à APIPATCH /users/usr_1042/enrollments/enr_4821
- Request ID
- 01J8Z3ZQ4H8K2M0T1S9P7YQF5C
- Client request ID
- 3f9c2a1e-7b4d-4c8a-9e21-5d6f0a8b1c34
- Resultado
- succeeded · 200
- Entrada de auditoriaaud_9183
- Operação
- users.enrollments.update
- Autor
- adm_214
- Credencial
- key_01J8Z3M4C2K9
- Client request ID
- 3f9c2a1e-7b4d-4c8a-9e21-5d6f0a8b1c34
- Resultado
- succeeded · 200
- Recurso
- enrollment enr_4821
ends_at− 2026-09-12+ 2026-12-31
Um autor real para cada ação
Cada conexão é uma credencial própria para uma conta, um administrador e um cliente, como "Claude, via Cademí MCP". Ela aparece na tela de chaves de API, e revogar corta o acesso na hora, inclusive tokens já emitidos.
Permissões conferidas a cada chamada
O assistente tem as permissões do administrador, reavaliadas a cada chamada de ferramenta. Tire uma permissão no painel e a próxima chamada já não tem.
Toda mudança, com o diff
Cada escrita, negação e efeito em segundo plano vira uma entrada de auditoria: autor, a credencial usada, resultado, status HTTP, operação, recurso e o que mudou, antes e depois.
Leituras também ficam registradas
Cada requisição autenticada vai para o log de requisições, ligada às entradas de auditoria que gerou.
Rastreável de ponta a ponta
Cada chamada de ferramenta tem um ID que acompanha todas as requisições à API que ela fez. Uma pergunta ao assistente vira uma cadeia que você segue até cada mudança.
Pergunte ao próprio rastro
Com a permissão audit.read, o assistente responde "quem mudou o acesso do João ontem?" lendo as entradas de auditoria e as requisições, com filtro por recurso, ação, resultado, request ID e período.
Três portas, uma API
Perguntas
O que é um servidor MCP?
O Model Context Protocol é um padrão aberto que permite a assistentes de IA usar ferramentas de outros serviços. O Cademí MCP é um servidor MCP remoto: o seu assistente se conecta a ele pela internet e usa as ferramentas dele para ler e alterar a sua conta da Cademí.
Em qual conta o assistente trabalha?
Na que você escolhe ao aprovar a conexão, como o administrador que aprovou. Para trabalhar em outra conta, conecte de novo e escolha a outra.
O assistente pode apagar dados?
Só o que as suas permissões de administrador permitem. As ferramentas que removem ou revogam algo são marcadas como destrutivas, para o seu cliente poder perguntar antes.
Como eu tiro o acesso?
Cada conexão aparece como uma chave de API da sua conta, com o nome do cliente, como "Claude, via Cademí MCP". Revogue na tela de chaves de API e a conexão para de funcionar.
MCP, CLI ou API?
Use o MCP para trabalhar na sua conta numa conversa. Use a CLI para scripts, CI e encaminhamento de eventos local. Use a API para construir a integração nos seus próprios sistemas. As três chegam à mesma API v3.