Tudo o que você precisa para usar o alinaflow fora do app: chaves com permissões limitadas ao que quem chama pode fazer, um servidor MCP para que um agente de IA opere a escola por você, e a referência REST completa.
Como começar com o Portal do Desenvolvedor
O Portal do Desenvolvedor serve para conectar outros sistemas à sua escola: os seus próprios scripts, uma integração que o seu desenvolvedor web prepare ou um agente de IA como o Claude ou o ChatGPT por meio de MCP. Crie uma chave em API / MCP, cole na ferramenta que você está conectando e ela vai agir com o seu próprio papel, então nunca vai poder fazer mais do que você. Revogue a chave ali mesmo quando não precisar mais dela.
O alinaflow tem quatro portais, cada um para um público diferente. O Portal de Matrículas é público, para quem ainda não estuda com você. O Portal das Famílias é onde as famílias da sua escola entram com login. O Portal dos Professores é onde os seus Professores organizam o dia. O Portal do Desenvolvedor serve para conectar outros sistemas e agentes de IA à sua escola. Os três primeiros compartilham o mesmo link: um visitante vê o seu Portal de Matrículas, e uma família ou um Professor que entra com login vê o próprio Portal.
API / MCP
Acesso programático à sua Escola de Música
Crie chaves de API para conectar o Claude, o ChatGPT ou qualquer cliente MCP à sua Escola de Música, ou para chamar a API da alinaflow diretamente. As chaves são pessoais: agem com a sua própria função, então nunca podem fazer mais do que você, e você pode revogá-las quando quiser.
A tela API / MCP no alinaflow
Chaves de acesso programático, incluindo o servidor MCP que permite a outros agentes de IA operarem a sua escola. Uma chave carrega exatamente o papel da pessoa a quem pertence e nunca pode exceder isso, então uma chave Viewer é recusada em qualquer escrita. Emita chaves com o acesso que você daria a uma pessoa fazendo o mesmo trabalho, e revogue aqui quando não forem mais necessárias.
Seções desta tela
Esta tela é dividida em seções: Nova chave. Cada uma faz parte da mesma tela, não é uma página separada.
Nova chave
Dê à chave um nome que diga onde ela será usada, como "Claude no notebook" ou "Integração Zapier". Assim fica fácil saber qual é qual e revogar a certa quando precisar. A data de validade é opcional, mas vale definir uma para testes rápidos ou para chaves entregues a alguém de fora da escola. A chave funciona com o seu próprio papel, então nunca terá mais acesso do que você.
Aba Nova chave
Campos principais
Chaves de API - Tokens pessoais para acesso programático. Crie uma, copie-a uma única vez (ela é exibida uma só vez) e cole no seu cliente. Você pode revogá-la quando quiser.
Função - Uma chave age com a sua função e acesso às unidades atuais, então nunca pode fazer mais do que você. Se a sua função mudar, a chave acompanha.
Desativação - Se a sua conta for desativada, todas as suas chaves param de funcionar imediatamente.
Servidor MCP - Aponte o Claude, o ChatGPT ou qualquer cliente MCP para a URL do MCP e autentique com uma chave para que ele leia e grave os dados da sua Escola de Música em seu nome.
Documentação da API - Cada endpoint com a sua descrição e a função necessária. Baixe a especificação OpenAPI (MCP ou v1) para gerar um cliente.
Documentação da API
A referência REST completa: cada endpoint, seus parâmetros e suas respostas, com os esquemas gerados a partir da própria API para que nunca fiquem defasados.
