Tutto quello che vedi nell’app, lo puoi chiamare.
Chiavi API con i permessi del contesto, webhook firmati per ogni evento dell’accademia, documentazione con esempi veri e un server MCP che mette corsi, registro e calendario a disposizione degli assistenti AI.
- Chiavi API per accademia o per persona, mostrate una sola volta
- Webhook con eventi a scelta, firma HMAC, retry e log
- Stessa API dell’app: corsi, presenze, studenti, calendario
- Server MCP per Claude, ChatGPT e Cursor
••••••••••••a9F2••••••••••••aZq••••••••••••7kQ1••••••••••••mX4cald_sk_9Kp2mQ4xR7tW1nB8vC3yH6jL0sD5fG2aZqUn’API sola, la stessa dell’app
Il registro elettronico, il CRM, il gestionale e gli assistenti AI parlano con Aladia come fa l’interfaccia: nessuna scorciatoia, nessun dato in più.
Webhook con eventi a scelta
Un endpoint, gli eventi che ti servono: course.published, course.completed, course.installment.paid, organization.member.added. Ogni consegna è firmata; se l’endpoint risponde male, riproviamo cinque volte con attesa crescente e tieni il log.
Payload leggibile, firma verificabile
Ogni evento porta l’id, la risorsa e i dati: titolo del corso, ciclo, materie, chi ha pubblicato. L’header con la firma HMAC ti permette di scartare tutto quello che non arriva da Aladia.
Documentazione con esempi veri
docs.aladia.io descrive ogni endpoint con parametri, esempio di richiesta in cURL, Node e Python e risposta reale: GET /v2/courses/:courseId/attendance-registry restituisce lezioni e righe di presenza con stato, fonte e minuti in aula.
⌘Kapp.aladia.ioServer MCP dell’accademia
Attivi il server, scegli gli ambiti (corsi, studenti e presenze, calendario, chat) e colleghi i client: Claude, ChatGPT, Cursor. Ogni client usa la chiave API di chi lo collega e le sue azioni finiscono nell’Activity log.
courses:readstudents:readcalendar:writechat:writepayments:read"mcpServers": {
"aladia": {
"url": "https://mcp.aladia.io/accademia-leonardo",
"headers": { "apikey": "ald_sk_••••••••aZq" }
}
} La chiave API decide cosa l’assistente può fare; ogni azione finisce nell’Activity log.Un assistente esterno che lavora nell’accademia
"Elenca gli studenti a rischio del Liceo Scientifico e crea una lezione di recupero venerdì alle 15": l’assistente chiama list_students_at_risk, poi create_lecture, e ti mostra chi ha invitato. Con i permessi di chi chiede, non uno di più.
lec_66fa1d…Tre studenti del Liceo Scientifico · 1° anno sono sotto la soglia di presenza del 75 %: Andrea Ricci (68 %), Chiara Colombo (71 %) e Alice Barbieri (74 %).
Ho creato la lezione «Recupero Matematica» venerdì 2 ottobre alle 15:00 con Davide Ricci e ho invitato i tre studenti. La trovi nel calendario dell’accademia.
Come si lavora
- 1
Crea la chiave
Settings › API keys: nome, scadenza, chiave copiata una sola volta. Agisce con i permessi del contesto (accademia o persona).
- 2
Sottoscrivi gli eventi
Settings › Webhook: URL, eventi, test immediato. Il secret firma ogni consegna; il log mostra esito e tentativi.
- 3
Collega gli assistenti
Settings › MCP: attivi il server, scegli gli ambiti, incolli la configurazione in Claude, ChatGPT o Cursor.
Cosa c’è dentro
Domande frequenti
Moduli collegati
Costruisci la tua Academy. Trova la tua Academy.
Unisciti a 194.000+ studenti e a centinaia di insegnanti e organizzazioni già su Aladia.
