API da Glissandoo

Uma API só de leitura para integrar os dados dos seus grupos, eventos e membros. Com OpenAPI, servidor MCP e OAuth 2.1.

Referência interativa Especificação OpenAPI

A API pública da Glissandoo permite que integrações externas e agentes de IA consultem a mesma informação que um utilizador vê nos seus grupos, respeitando sempre as suas permissões. A primeira versão (v1) é só de leitura e partilha contrato, identidade e quota entre REST/OpenAPI e MCP.

O que pode consultar

Grupos ativos, dados do grupo, eventos e participantes, previsão e assiduidade com os motivos de ausência indicados pelos membros, membros e instrumentos, métricas de assiduidade e metadados do repertório visível.

Autenticação

Usa OAuth 2.1 com PKCE para ligar clientes MCP como o ChatGPT ou o Claude, ou cria uma API key no Dashboard (Minha conta → API access) e envia-a no cabeçalho x-api-key ou Bearer. O único scope da v1 é public-api:read.

Para agentes de IA

O servidor MCP remoto expõe as mesmas consultas como ferramentas, para que os agentes compatíveis as descubram e executem. Encontre um resumo para agentes em /llms.txt.

Começar

GET /v1/openapi.json — o contrato OpenAPI 3.1 completo.
GET /v1/docs — a referência web interativa.
POST /mcp — o servidor MCP só de leitura para agentes.

Liga o Glissandoo ao ChatGPT ou ao Claude

Adiciona o Glissandoo como conector personalizado e pergunta ao teu assistente pelos ensaios, pela assiduidade ou pelo repertório. Não precisas de API key: autorizas a ligação com a tua conta Glissandoo. URL do conector:

https://api.glissandoo.com/mcp

Claude: vai a Customize → Connectors, escolhe Add custom connector e cola o URL. Nos planos Team e Enterprise, primeiro um owner tem de o adicionar em Organization settings.
ChatGPT: em Plugins, escolhe Add custom MCP server, cola o URL e seleciona OAuth como autenticação. Nos espaços Business e Enterprise, primeiro um administrador tem de ativar os conectores personalizados.
Inicia sessão no Glissandoo, verifica que aplicação pede acesso e carrega em Permitir acesso. O assistente só pode ler os dados que já vês no Glissandoo; não pode alterar nada.

Podes ver e desligar as aplicações autorizadas quando quiseres no Dashboard, em Minha conta → Aplicações ligadas. A autorização expira ao fim de 30 dias; depois o assistente vai pedir-te para voltares a ligar.

Referência interativa Gerir API keys e aplicações