AladiaDocs
Integrazioni

ChatGPT, Claude e MCP

Collega ChatGPT, Claude, Claude Code e qualunque client MCP a un workspace Aladia, con i permessi del tuo ruolo.

Collaudato in produzione il 29/09/2026

Come funziona il server MCP di Aladia

ChatGPT, Claude e gli altri assistenti AI si collegano ad Aladia attraverso il server MCP di Aladia (Model Context Protocol):

https://api.aladia.io/mcp
  • Lavora dentro un solo workspace: quello che approvi quando colleghi (un'accademia o il tuo workspace personale). Non vede mai gli altri workspace.
  • Ha i permessi del tuo ruolo in quel workspace: quello che non puoi fare in Aladia, non lo può fare neanche l'assistente.
  • Collegare crea una chiave API chiamata <App> · MCP in Impostazioni → Chiavi API. Elimina la chiave per scollegare: la connessione si ferma subito.
  • Ogni strumento usato dall'assistente compare nel Registro attività con la dicitura via MCP.
  • Un'integrazione risulta Collegata quando ha fatto almeno una richiesta negli ultimi 30 giorni.

Cosa può fare l'assistente:

StrumentoCosa fa
get_workspaceChi è collegato e in quale workspace
list_coursesI corsi che tieni (o che segui)
get_courseDettaglio e indice di un corso
list_course_studentsGli studenti di un corso
list_calendars, list_calendar_eventsCalendari, eventi e lezioni in un intervallo di date
list_grading_queueCompiti e verifiche da correggere
search_documentsRicerca nei documenti che puoi aprire
create_calendar_eventCrea un evento nel tuo calendario — l'unico strumento che modifica i dati; l'assistente chiede prima conferma

Tutto il workspace da Claude o ChatGPT (pilota)

Nei workspace del pilota il server MCP espone gli stessi strumenti di ARIA, l'assistente dentro Aladia: circa 240 strumenti invece dei nove qui sopra, per gestire il workspace da Claude o ChatGPT, Impostazioni comprese.

Area (toolset)Cosa può fare l'assistente
workspaceSpazi e cartelle, elementi fissati nella barra laterale, ricerca di persone, ricerca nella guida di Aladia
coursesBozze e testi dei corsi, capitoli e lezioni, categorie, lingua, impostazioni, edizioni, prezzo, copertina, pubblicazione, esami del corso, compiti da correggere
peopleMembri e ruoli di corsi, spazi e accademia, inviti e link d'invito
calendarCalendari ed eventi, partecipanti, pianificazione settimanale delle lezioni, chiusure, disponibilità su Google Calendar
chatStanze, messaggi, sezioni della barra laterale, thread e posta in arrivo
documentsDocumenti, raccolte di esami ed esami, lavagne
libraryBiblioteche, libri e volumi allegati, membri, libri usati nei corsi
teachingAree disciplinari, materie e livelli, i loro libri e docenti
socialBacheca, post e domande, commenti e reazioni, follower, il tuo profilo, storie e raccolte
brandingNome, colori, mittente e caselle di risposta delle email, vetrina del Marketplace (caroselli, categorie, pubblicazione), aspetto dell'app mobile
domainDominio del sito ed email dal tuo dominio: i record DNS da creare, la verifica, la rimozione
formsModuli (bozza, blocchi, design, pubblicazione, archivio), Richieste in lettura, attributi
accessRuoli personalizzati e i loro permessi, team e membri, SSO del workspace
settingsPiano e utilizzo in sola lettura, stato delle integrazioni, chiavi API, webhook, template email
eventsEventi pubblici: pagina, biglietti gratis o a pagamento, pubblicazione, annullamento, iscritti
academic_yearAnno accademico: creazione, preparazione di edizioni e lezioni, cose da sistemare, pubblicazione, chiusura
  • Gli stessi permessi dell'app: ogni strumento lavora con il tuo ruolo nel workspace. Gli strumenti riservati a un ruolo (per esempio la gestione dei membri dell'accademia) non compaiono nemmeno a chi non ha quel ruolo, e nel workspace personale gli strumenti dell'accademia sono nascosti.
  • Conferme: ogni strumento dice all'assistente se legge soltanto, modifica i dati o è distruttivo (elimina, rimuove, revoca, pubblica, cambia ruoli, permessi, prezzi, dominio o SSO). Claude e ChatGPT chiedono conferma prima delle modifiche; controlla con attenzione quelle distruttive.
  • Piano: una funzione che richiede un piano superiore (dominio del sito, email dal tuo dominio, SSO, app mobile) risponde che serve l'upgrade, con il link a Impostazioni → Piani, come nell'app. Leggere, verificare e togliere un dominio resta sempre possibile.
  • Pagamenti solo su Stripe: piano, prova e consumi si leggono, non si cambiano. Per cambiare piano o pagare l'assistente ti manda a Impostazioni → Fatturazione.
  • Nessun segreto: le chiavi API esistenti compaiono solo con le ultime quattro cifre, dello SSO e degli store dell'app si vede solo se sono collegati, dei webhook mai il segreto di firma. Una chiave API nuova (serve il permesso di crearle) compare una sola volta, nella risposta in cui viene creata: copiala subito.
  • Immagini: logo, copertina, favicon e icone dell'app si caricano da Impostazioni nell'app.
  • Solo alcune aree: tanti strumenti occupano spazio nel contesto dell'assistente. Per collegare solo alcune aree aggiungile all'indirizzo, per esempio https://api.aladia.io/mcp?toolsets=courses,calendar oppure ?toolsets=branding,domain,forms per le sole Impostazioni. Impostazioni → Integrazioni → Aladia MCP elenca gli strumenti che vedi tu, divisi per area.
  • In ARIA: nei workspace del pilota anche ARIA, l'assistente dentro Aladia, ha gli strumenti delle Impostazioni, degli eventi e dell'anno accademico, e chiede conferma prima di ogni modifica.
  • Non disponibili fuori da Aladia: i piani di azioni confermati con un clic, la foto del profilo e le immagini allegate a una conversazione di ARIA (la copertina si può ancora generare con l'AI da update_my_profile). Nell'insieme completo search_documents diventa list_documents.

Per collegare un assistente serve il ruolo Proprietario, Admin o Sviluppatore del workspace (lo stesso permesso per creare una chiave API).

Collegare Claude

Impostazioni → Integrazioni → Claude mostra l'indirizzo del server e questi passi.

Su claude.ai, nell'app desktop e su mobile (piani Free, Pro e Max):

  1. In Claude apri Personalizza → Connettori.
  2. Scegli Aggiungi connettore personalizzato.
  3. Come nome scrivi Aladia e incolla https://api.aladia.io/mcp.
  4. Premi Aggiungi, poi Connetti: si apre Aladia. Accedi, controlla il workspace e premi Consenti.
  5. In una chat apri + → Connettori e attiva Aladia.

Nei piani Team ed Enterprise il connettore lo aggiunge un Owner da Impostazioni organizzazione → Connettori → Aggiungi → Personalizzato → Web; poi ognuno preme Connetti con il proprio account Aladia.

Impostazioni → Integrazioni → Claude: indirizzo del server e passi per Claude e Claude Code La pagina di consenso di Aladia: quale app, dove torna, il workspace e Consenti

Claude Code (terminale):

claude mcp add --transport http aladia https://api.aladia.io/mcp

Il primo /mcp apre l'accesso ad Aladia. Senza OAuth, usa una chiave API: aggiungi --header "Authorization: Bearer <API_KEY>".

Collegare ChatGPT

ChatGPT collega Aladia come app in modalità sviluppatore (Plus, Pro, Business, Enterprise ed Edu, sul web):

  1. Apri Impostazioni → Sicurezza e accesso e attiva la Modalità sviluppatore. Nei workspace Business ed Enterprise la abilita prima un admin.
  2. Vai alle app di ChatGPT e premi + per creare un'app.
  3. Come nome scrivi Aladia, aggiungi una descrizione e, in Connessione, incolla https://api.aladia.io/mcp.
  4. Scegli OAuth, crea l'app e accedi ad Aladia: controlla il workspace e premi Consenti.
  5. In una nuova chat aggiungi Aladia dal menu degli strumenti (Modalità sviluppatore).

ChatGPT chiede conferma prima di ogni strumento che scrive. Quando aggiungiamo strumenti, apri l'app e usa Aggiorna.

Impostazioni → Integrazioni → ChatGPT: indirizzo del server e passi della modalità sviluppatore

Altri client MCP e chiavi API

Impostazioni → Integrazioni → Aladia MCP serve per qualunque altro client (Cursor, agenti tuoi, le API di Anthropic e OpenAI):

  • OAuth 2.1 con registrazione dinamica del client e PKCE: i client che lo supportano si collegano da soli partendo dall'indirizzo.
  • Oppure una chiave API come Bearer token: Authorization: Bearer <API_KEY>. Crea chiave MCP crea una chiave dedicata e la mostra una volta sola: copiala subito.
{
  "mcpServers": {
    "aladia": {
      "url": "https://api.aladia.io/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}
Impostazioni → Integrazioni → Aladia MCP: indirizzo del server, Crea chiave MCP e gli strumenti

Ogni chiave ha un limite di 120 richieste al minuto (20 modifiche al minuto).

In questa pagina