ADITUS Developer Portal

npx add-mcp 'https://developers.aditus.com/api/mcp'

Einrichtung

Streamable HTTP, keine Authentifizierung, kein Sitzungszustand. Wähle deinen Client:

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

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

VS Code / Copilot ·.vscode/mcp.json

{
  "servers": {
    "aditus-docs": {
      "type": "http",
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

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

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

Clients, die Server Cards lesen, finden denselben Server unter /.well-known/mcp/server-card.json.

Werkzeuge

Fünf rein lesende Werkzeuge. Die Inhalte stammen aus demselben bereinigten Collection-Snapshot wie die API-Referenz und die Markdown-Spiegel unter /ai, alle drei stimmen also immer überein.

Tool	Argumente	Liefert
search_docs	query, limit?	Gewichtete Volltextsuche über Module, Endpunkte und Leitfäden.
list_modules	–	Alle API-Module mit Richtung, Endpunktzahl und Links, dazu die Leitfäden.
list_endpoints	module	Alle Endpunkte eines Moduls mit Methode, Pfad und Kurzbeschreibung.
get_endpoint	endpoint	Vollständiger Vertrag: Parameter, Header, Request-Body und Beispielantworten.
get_guide	guide, section?	Markdown des Micro-Frontend-Leitfadens, der Guidelines oder Webhooks, ganz oder als Abschnitt.

Beispiel-Prompts

Drei typische Fragen und was nach dem Absenden passiert.

1. „Wie lege ich über die ADITUS Shop-API einen Warenkorb an und füge ein Ticket hinzu?“ Der Assistent ruft search_docs("create cart add item") auf, danach get_endpoint für die beiden passenden Endpunkte, und antwortet mit Reihenfolge der Requests, Pflicht-Headern und Body-Feldern sowie einer Beispielantwort.
2. „Wie prüfe ich die Signatur eines ADITUS-Webhooks?“ Der Assistent ruft get_guide("webhooks", "signature") auf und liefert den genauen Header-Namen, den Signaturalgorithmus und ein Prüf-Snippet in deiner Sprache, mit Verweis auf den Abschnitt im Leitfaden.
3. „Welche ADITUS-APIs gibt es für die Zutrittskontrolle, und welcher Endpunkt liest die Scan-Historie eines Tickets?“ Der Assistent ruft list_modules auf, wählt das Zutrittsmodul, ruft dafür list_endpoints und dann get_endpoint für den Scan-Historie-Endpunkt auf, und antwortet mit der Modulübersicht sowie Parametern und Antwortfeldern des Endpunkts.

Daten und Datenschutz

Kein Konto, kein Schlüssel, und deine Unterhaltung erreicht den Server nie: Dein Assistent schickt nur den Werkzeugnamen und seine Argumente (Suchbegriff, Modul, Endpunkt oder Leitfaden-ID). Für den Betrieb wird jede Anfrage protokolliert mit JSON-RPC-Methode, Werkzeugname, diesen Argumenten (je auf 200 Zeichen gekürzt), HTTP-Status, Fehler- oder Ablehnungsgrund, Trefferzahl, Dauer, Client-Name, Version und Protokollversion aus dem Initialize, User-Agent des Clients und einem kurzen schlüsselbasierten Hash (HMAC) der IP-Adresse; die Adresse selbst wird nie gespeichert. Protokollzeilen werden nach 90 Tagen gelöscht (Bereinigung beim Start und alle sechs Stunden), bleiben bei ADITUS und werden nicht an Dritte weitergegeben. Antworten stammen ausschließlich aus der öffentlichen Dokumentation. Fragen: Kontakt · Datenschutzerklärung