Migrar de outra plataforma com a sua IA

Com o servidor MCP da Academy, você pode pedir ao seu assistente de IA (como Claude, Cursor ou ChatGPT) para migrar cursos, alunos, turmas e matrículas vindos de plataformas como Hotmart, Kiwify, Eduzz ou sistemas próprios diretamente para a sua academia.

A migração é projetada para ser segura, idempotente (rodar de novo não duplica dados) e controlada por você em cada etapa.

1. Conectar seu assistente com as permissões certas

1. 1No painel, acesse Configurações → API e MCP e, na aba Conectores, ative o servidor MCP, se ainda não estiver ativo. Siga Conectar assistentes de IA.
2. 2Na aba Chaves, clique em Nova chave e marque MCP (assistentes de IA) em Onde a chave vale.
3. 3Em Permissões, selecione o módulo Migração (escopo de escrita migration_write) e Membros (leitura members_read).
4. 4Se for importar dados como e-mail e telefone de alunos, marque também Dados pessoais sem máscara (pii_read).
5. 5Copie a chave gerada e configure no seu assistente conforme as instruções da tela. Se o conector estiver com Pausar todas as alterações ligado, a migração não grava nada.

2. Passo a passo da migração

Etapa 1: Planejar a migração (`migration_plan`)

Informe à sua IA as contagens da plataforma antiga (alunos, cursos, aulas, turmas). A ferramenta migration_plan analisa os volumes e devolve o roteiro de chamadas, os lotes recomendados e as validações necessárias, sem alterar nada.

> Exemplo de pedido: *"Vou migrar da Hotmart 150 alunos e 2 cursos. Monte o plano de migração usando a ferramenta migration_plan."*

Etapa 2: Criar os cursos e áreas de membros

A ferramenta course_structure_create cria a estrutura completa do curso (curso, módulos e aulas) em uma única chamada a partir de um JSON estruturado.

• Rascunho seguro: Cursos nascem com is_active: false e aulas com is_published: false, para você revisar o conteúdo antes de publicar aos alunos.
• Vídeos: Suporta links diretos/incorporados (YouTube, Vimeo, etc.) ou vídeos da sua biblioteca no Academy Player (Panda).
• Área de membros: Use member_area_create para criar áreas com seções padrão (destaques, vitrine de cursos e continuar assistindo).

Etapa 3: Criar grupos de acesso / turmas

Com access_group_create, crie grupos vinculados aos produtos importados e à sua área de membros.

• É possível definir validade do acesso: vitalício (lifetime), por dias corridos (period) ou até uma data fixa (fixed).
• O parâmetro external_id garante idempotência caso o comando seja executado novamente.

Etapa 4: Importar alunos em lote (`members_import`)

Importe os alunos fornecendo nome, e-mail, telefone opcional, tags e o ID da plataforma anterior.

• Sem e-mails indesejados: O parâmetro send_invite é false por padrão. Nenhum e-mail de boas-vindas sai sem você pedir explicitamente.
• Idempotência: Alunos já existentes na academia têm apenas suas informações e tags atualizadas, sem duplicar contas.
• Teste prévio: Execute com dry_run: true para simular e conferir a lista.

Etapa 5: Conceder matrículas e adicionar aos grupos

• Em lote no grupo: Use access_group_add_members_bulk para vincular os alunos à turma correspondente, liberando os cursos do grupo automaticamente.
• Matrícula direta: Use enrollments_grant para matricular alunos diretamente em produtos específicos.
• Sem cobrança financeira: Matrículas manuais via MCP não geram pedidos, faturas nem transações no checkout.

3. Regras de segurança e limites

• Simulação com `dry_run`: Todas as ferramentas de escrita aceitam dry_run: true.
• Lotes pequenos (até 50 itens): São processados diretamente pela IA.
• Lotes médios (51 a 500 itens): Exigem que a IA envie o parâmetro confirm_count com o número exato de itens, conferido pelo servidor.
• Teto por chamada: Máximo de 500 itens por requisição.
• Isolamento entre academias: IDs pertencentes a outra academia são rejeitados com código 404 (não encontrado).
• Auditoria completa: Toda execução é registrada na Auditoria de chamadas MCP, na aba Conectores, sem gravar dados pessoais sensíveis nos registros.