Skip to main content

​
Documentazione completa in un file

Per dare a un LLM tutta la documentazione in una sola richiesta, usa:
Il file contiene, in Markdown, il testo integrale di ogni pagina pubblicata: guida all’app, pagine introduttive dell’API (autenticazione, errori, idempotenza, limiti di richiesta), pagine IA e agenti e il riferimento completo dell’API, con tutti gli endpoint, i parametri, i campi del body, le risposte, i codici di errore e gli esempi JSON. Ogni pagina è preceduta da titolo e URL sorgente. Il file viene rigenerato a ogni pubblicazione.

​
Formati disponibili

Una pagina in Markdown si ottiene anche con l’header Accept: text/markdown:
Il menu in cima a ogni pagina offre:

​
Server MCP

Il server MCP espone ricerca e lettura della documentazione a Claude, Cursor, VS Code, ChatGPT e agli altri client MCP.
Il server MCP legge solo la documentazione. Non accede ai dati dei locali e non esegue operazioni. Per leggere e modificare dati serve l’API con una chiave.

​
Specifica OpenAPI

openapi.yaml (OpenAPI 3.1) è la fonte di verità per endpoint, campi e codici di errore. Usi tipici:
  • generazione di un client tipizzato (openapi-generator, openapi-typescript);
  • import in Postman, Insomnia o Bruno;
  • definizione dei tool di un agente.
Prompt pronto per l’integrazione: Prompt per agenti.