Zum Inhalt springen
PRÜFSTOFF

PRÜFSTOFF

MCP- und API-Referenz

MCP- und API-Referenz: Endpunkte, Authentifizierung, Diagnose und technische Datenverarbeitung.

Der Regelserver auf https://mcp.agent-services.at liefert die Prüfregeln des PRÜFSTOFF Aussagenchecks (report-intake, report-classify, report-compose und weitere Schritte) an angebundene KI-Anwendungen aus. Diese Seiten dokumentieren die Zugriffswege öffentlich, auch ohne Zugriff auf das zugrunde liegende Repository.

  • MCP-API: POST https://mcp.agent-services.at/pruefstoff-aussagencheck (optional mit Plattform-Pfad /pruefstoff-aussagencheck/<plattform>), Streamable HTTP/JSON-RPC 2.0; Zugang des Plugins und des Agenten für Microsoft 365 Copilot
  • Diagnose: die Diagnose des Plugins (Fähigkeiten, Verbindung, Versionen, Ablauf): Inhalt des Berichts, Umfang, Aufruf und einfügbarer Text für den Fall, dass sich das Plugin nicht ausführen lässt
  • REST-API: GET /pruefstoff-aussagencheck/steps/<plattform>/<step>, Action-Zugang eines OpenAI Custom GPT
  • Plugin-Archiv (GET /downloads/pruefstoff-aussagencheck-plugin.zip auf diesem Host): das Plugin als Rückfall zur Installation über den Marketplace; es enthält die Verbindung zur MCP-API und die Anweisung, die Regeln abzurufen, keine Regeln selbst. Die Einrichtung beschreibt die Schritte.

Plattform

<plattform> im Pfad ist chatgpt, claude oder m365-copilot und wählt die für das jeweilige Werkzeug angepassten Regeln. Ohne Plattform-Pfad (/pruefstoff-aussagencheck, /pruefstoff-aussagencheck/steps/<step>) gelten die allgemeinen Regeln; eine unbekannte Plattform ergibt 404.

Zugang

Entweder mit einem Token, den der Serverbetreiber für eine Kunden-Instanz ausstellt, oder – nur über die MCP-API – mit einer Lizenz: Der MCP-Connector meldet sich dann mit dem gekauften Lizenzschlüssel an (OAuth). Einzelheiten stehen in der MCP-API.

Versionen und Umstellung

Jede Schrittantwort nennt im Frontmatter die Version der Regeln. Ein Plugin, das älter ist als die Regeln, erhält mit seinem Einstiegsschritt einen Hinweis auf die Aktualisierung. Verbindungen über die abgelöste Adresse claims.agent-services.at erhalten statt der Regeln eine reguläre Schrittantwort (HTTP 200) mit code: UPDATE_REQUIRED im Frontmatter und dem Link auf die Umstellung.

Technische Datenverarbeitung

Der Regelserver verarbeitet Anfragen zum Abruf der Regeln und zur Anmeldung. Das Werkzeug fetch_agent_step nimmt nur die Kennung eines Schritts und optional eine Plattform entgegen; geprüfte Texte und Ergebnisse sind keine Parameter der Schnittstelle und werden in der KI-Anwendung verarbeitet, deren Datenschutzbedingungen zusätzlich gelten.

  • Zugriffsprotokoll: Zeitpunkt, Pfad, Host, Plattform, Statuscode, abgerufener Schritt und Umfang der Antwort, Kennung der Anfrage, Kunden-Instanz oder Lizenz (deren interne Nummer, nie der Lizenzschlüssel), ein nicht umkehrbares Kürzel des Tokens, Produktkennung und Version des Clients sowie MCP-Protokoll und -Methode. Aufbewahrung 90 Tage.
  • Lizenzen: Der Lizenzschlüssel ist als Hash und verschlüsselt gespeichert; der Anmeldedienst (Stytch) erhält nur eine zufällige Kennung der Lizenz.

Die vollständige Datenschutzerklärung nennt Verantwortliche, Rechtsgrundlagen und Rechte.