API di Glissandoo

Un'API in sola lettura per integrare i dati dei tuoi gruppi, eventi e membri. Con OpenAPI, un server MCP e OAuth 2.1.

Riferimento interattivo Specifica OpenAPI

L'API pubblica di Glissandoo consente a integrazioni esterne e agenti IA di interrogare le stesse informazioni che un utente vede nei suoi gruppi, rispettando sempre i suoi permessi. La prima versione (v1) è in sola lettura e condivide contratto, identità e quota tra REST/OpenAPI e MCP.

Cosa puoi interrogare

Gruppi attivi, dati del gruppo, eventi e partecipanti, previsioni e presenze con i motivi di assenza indicati dai membri, membri e strumenti, metriche di presenza e metadati del repertorio visibile.

Autenticazione

Usa OAuth 2.1 con PKCE per collegare client MCP come ChatGPT o Claude, oppure crea una chiave API nella Dashboard (Il mio account → API access) e inviala nell'header x-api-key o Bearer. L'unico scope della v1 è public-api:read.

Per gli agenti IA

Il server MCP remoto espone le stesse query come strumenti, così gli agenti compatibili possono scoprirle ed eseguirle. Trovi un riepilogo per agenti su /llms.txt.

Inizia

GET /v1/openapi.json — il contratto OpenAPI 3.1 completo.
GET /v1/docs — il riferimento web interattivo.
POST /mcp — il server MCP in sola lettura per gli agenti.

Collega Glissandoo a ChatGPT o Claude

Aggiungi Glissandoo come connettore personalizzato e chiedi al tuo assistente di prove, presenze o repertorio. Non ti serve una chiave API: autorizzi la connessione con il tuo account Glissandoo. URL del connettore:

https://api.glissandoo.com/mcp

Claude: vai su Customize → Connectors, scegli Add custom connector e incolla l'URL. Nei piani Team ed Enterprise, prima deve aggiungerlo un owner da Organization settings.
ChatGPT: in Plugins, scegli Add custom MCP server, incolla l'URL e seleziona OAuth come autenticazione. Negli spazi Business ed Enterprise, prima un amministratore deve abilitare i connettori personalizzati.
Accedi a Glissandoo, controlla quale app chiede l'accesso e fai clic su Consenti accesso. L'assistente può solo leggere i dati che vedi già in Glissandoo; non può modificare nulla.

Puoi vedere e scollegare le app autorizzate in qualsiasi momento dalla Dashboard, in Il mio account → App collegate. L'autorizzazione scade dopo 30 giorni; poi l'assistente ti chiederà di ricollegarti.

Riferimento interattivo Gestisci chiavi API e app