ChatGPT, Claude e MCP

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:

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.

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.

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>" }
    }
  }
}

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