Vai al contenuto
MCP

La documentazione ADITUS, dentro il tuo assistente di programmazione.

Un server MCP pubblico, in sola lettura, sulla documentazione API e sulla guida Micro Frontend. Nessun account, nessuna chiave: attivalo da una directory senza alcuna configurazione, oppure aggiungi un URL, e Claude, Cursor, Copilot o ChatGPT consultano il contratto reale invece di tirare a indovinare.

https://developers.aditus.com/api/mcp

Disponibile in …

Il server è pubblicato in queste directory. Attivalo lì con un clic, senza file di configurazione.

  • Claude

    Attivalo direttamente come connettore in Claude: un clic, nessuno snippet necessario.

    Apri in Claude
  • Official MCP Registry

    La voce ufficiale del server (com.aditus.developers/developer-portal) importata dai client compatibili con il registro.

    Apri la scheda
  • Glama

    Pagina del connettore con panoramica degli strumenti e ispettore nel browser.

    Apri la scheda
  • Smithery

    Scheda con comandi di installazione per molti client e un playground ospitato.

    Apri la scheda

Configurazione manuale

Necessaria solo se il tuo client non supporta una directory. Streamable HTTP, nessuna autenticazione, nessuno stato di sessione. Scegli il tuo client:

Claude Code: esegui questo comando una volta nel terminale; il server sarà poi disponibile in ogni sessione.

Claude Code
claude mcp add --transport http aditus-docs https://developers.aditus.com/api/mcp

Cursor: inserisci questo contenuto in .cursor/mcp.json nella cartella del progetto (o in ~/.cursor/mcp.json per tutti i progetti).

Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "aditus-docs": {
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

VS Code con Copilot: inserisci questo contenuto in .vscode/mcp.json nella cartella del progetto o aggiungilo alle impostazioni utente tramite “MCP: Add Server”.

VS Code / Copilot · .vscode/mcp.json
{
  "servers": {
    "aditus-docs": {
      "type": "http",
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

Claude Desktop: apri Impostazioni → Sviluppatore → Modifica configurazione, incolla questo in claude_desktop_config.json e riavvia l'app.

Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "aditus-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://developers.aditus.com/api/mcp"]
    }
  }
}

ChatGPT: in Impostazioni → Connettori, aggiungi un connettore personalizzato con l'URL dell'endpoint qui sopra; nessuno snippet necessario. Per provare il server senza client, esegui questo in un terminale:

curl
curl -s https://developers.aditus.com/api/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_docs","arguments":{"query":"create cart"}}}'

I client che leggono le server card trovano lo stesso server su /.well-known/mcp/server-card.json.

Strumenti

Cinque strumenti in sola lettura. I contenuti provengono dallo stesso snapshot redatto della collection usato dalla documentazione API e dai mirror Markdown sotto /ai, quindi i tre sono sempre allineati.

ToolArgomentiRestituisce
search_docsquery, limit?Ricerca full-text ordinata per rilevanza tra moduli, endpoint e guide.
list_modules–Tutti i moduli API con direzione, numero di endpoint e link, più le guide.
list_endpointsmoduleTutti gli endpoint di un modulo con metodo, percorso e breve riepilogo.
get_endpointendpointContratto completo: parametri, header, corpo della richiesta e risposte di esempio.
get_guideguide, section?Markdown delle guide Micro Frontend (guida per agenti, documentazione completa, panoramica), delle Guidelines o dei Webhooks, intera o per sezione.

Esempi di richieste

Tre domande tipiche e cosa succede dopo averle poste.

  1. “Come creo un carrello e aggiungo un biglietto con la Shop API di ADITUS?”

    L'assistente chiama search_docs("create cart add item"), poi get_endpoint per i due endpoint trovati, e risponde con l'ordine delle richieste, header e campi obbligatori e una risposta di esempio.

  2. “Come verifico la firma di un webhook ADITUS?”

    L'assistente chiama get_guide("webhooks", "signature") e restituisce il nome esatto dell'header, l'algoritmo di firma e uno snippet di verifica nel tuo linguaggio, citando la sezione della guida.

  3. “Quali API ADITUS esistono per il controllo accessi e quale endpoint legge la cronologia delle scansioni di un biglietto?”

    L'assistente chiama list_modules, sceglie il modulo accessi, chiama list_endpoints per esso e poi get_endpoint per l'endpoint della cronologia scansioni, e risponde con la panoramica del modulo e i parametri e campi di risposta dell'endpoint.

Dati e privacy

Nessun account, nessuna chiave, e la tua conversazione non raggiunge mai il server: il tuo assistente invia solo il nome dello strumento e i suoi argomenti (termine di ricerca, modulo, endpoint o id della guida). Per l'esercizio, ogni richiesta viene registrata con il metodo JSON-RPC, il nome dello strumento, tali argomenti (ciascuno troncato a 200 caratteri), lo stato HTTP, il motivo di errore o rifiuto, il numero di risultati, la durata, nome, versione e versione di protocollo del client dall'initialize, lo user-agent del client e un breve hash con chiave (HMAC) dell'indirizzo IP; l'indirizzo stesso non viene mai conservato. Le righe di log vengono cancellate dopo 90 giorni (pulizia all'avvio e ogni sei ore), restano presso ADITUS e non vengono condivise con terzi. Le risposte provengono esclusivamente dalla documentazione pubblica. Domande: Contatti · Informativa sulla privacy