Zum Hauptinhalt springen
Agentifizierung LogoAgentifizierung

Maschinenlesbare Schnittstellen

Diese Seite richtet sich an Agenten und an Menschen, die welche bauen. Sie beschreibt, wie sich der Inhalt von agentifizierung.de ohne HTML-Parsing lesen lässt und wie eine Anfrage an das Team übergeben wird. Dokumentation und lesende Tools sind öffentlich. Schreibende MCP-Buchungstools benötigen einen gesonderten Schlüssel für vertrauenswürdige Integrationen.

MCP und WebMCP

Der Endpunkt /mcp verwendet Streamable HTTP mit JSON-Antworten. Verbundene MCP-Clients können Leistungen, Buchungsstatus, Terminarten und freie Termine lesen. Für Vorbereitung, E-Mail-Code und bestätigte Buchung muss ein vertrauenswürdiger Client den gesonderten MCP-Token als Bearer-Token senden. Dieser Token gehört ausschließlich in dessen Secret-Store.

Auf der Website registriert document.modelContext dieselben vier lesenden Tools und open_booking_form. Ohne native Browser-Unterstützung wird ein lokal gebündelter Polyfill verwendet. Die Buchung erfolgt auf der Buchungsseite nach Prüfung der Angaben, E-Mail-Verifizierung und ausdrücklicher Bestätigung. Ein Polyfill allein verbindet keinen externen Chat-Assistenten.

Ob echte Buchungen aktuell aktiviert sind, liefert get_booking_status. Eine Vorbereitung reserviert keinen Termin. Bei unklarem Buchungsausgang niemals automatisch erneut buchen; eine ausstehende Gastgeber-Bestätigung (PENDING) ist noch keine bestätigte Buchung.

Dateien

  • MCP server card

    Discovery-Konvention für den MCP-Endpunkt unter /mcp. Lesende Tools sind öffentlich; schreibende Buchungstools benötigen einen gesonderten Bearer-Token für vertrauenswürdige Integrationen.

  • WebMCP manifest

    Discovery-Konvention für die im Browser registrierten Tools. Kein Bestandteil des WebMCP-Standards und keine Zusage einer automatischen ChatGPT-Anbindung.

  • llms.txt

    Kurzfassung der Site: wofür Agentifizierung zuständig ist, wofür nicht, Kernaussagen, Seitenindex und Kontaktwege.

  • llms-full.txt

    Der Text aller Kernseiten in einer Datei, beim Abruf aus den ausgelieferten Seiten erzeugt. Blogbeiträge stehen als Index am Ende.

  • sitemap.xml

    Alle indexierbaren URLs inklusive Änderungsdatum.

  • agent-card.json

    A2A Agent Card: Skills, Beispielanfragen und die Adresse des Endpunkts unten.

  • openapi.json

    OpenAPI 3.0.3 aller öffentlichen Operationen, mit operationId, Antwortschemas und Fehlermodell nach RFC 9457.

  • api-catalog

    Linkset nach RFC 9727: verweist auf Spezifikation, Dokumentation und Agent Card, für Agenten, die die Domain noch nicht kennen.

Jede Seite als Markdown

Jede Seite gibt es zusätzlich als Markdown — entweder über Inhaltsaushandlung auf derselben URL oder direkt über /index.md. Die Markdown-Fassung wird aus der ausgelieferten Seite erzeugt; sie kann also nicht etwas anderes behaupten als die Seite selbst.

# Aushandlung über den Accept-Header
curl -H "Accept: text/markdown" https://www.agentifizierung.de/warum-agenten

# oder direkt
curl https://www.agentifizierung.de/warum-agenten/index.md

Markdown wird nur ausgeliefert, wenn text/markdown ausdrücklich im Accept-Header steht. Ein Accept mit Wildcard bekommt weiterhin HTML — sonst würden Browser und Suchmaschinen-Crawler die falsche Variante sehen.

A2A-Endpunkt

Unter https://www.agentifizierung.de/a2a/v1 liegt ein Agent-to-Agent-Endpunkt nach dem HTTP+JSON-Binding. Er ordnet eine Anfrage ein, benennt die fehlenden Angaben und gibt den Weg zu einem Menschen zurück. Er ist regelbasiert: kein Modellaufruf, keine Speicherung, gleiche Eingabe also immer gleiche Antwort. Umgesetzt wird anschließend von Menschen — der Endpunkt vermittelt, er baut nichts.

# Service-Index
curl https://www.agentifizierung.de/a2a/v1

# Anfrage senden
curl -X POST https://www.agentifizierung.de/a2a/v1/message:send \
  -H "Content-Type: application/json" \
  -d '{"message":{"role":"user","kind":"message","messageId":"m1",
       "parts":[{"kind":"text","text":"Wir bekommen 4000 Serviceanfragen im Monat in Zendesk und wollen die Erstqualifizierung automatisieren."}]}}'

JSON-RPC 2.0 mit der Methode message/send wird an der Basis-URL ebenfalls angenommen. Fehler kommen als application/problem+json nach RFC 9457 zurück — mit Code, Beschreibung und einem Hinweis, wie der Aufruf richtig aussieht. Antworten sind A2A-Messages mit einem Text- und einem Datenteil; der Datenteil enthält Einschätzung, erkannte Angaben, fehlende Angaben und die Kontaktwege.

Was ein Agent mitschicken sollte

Nichts davon ist Pflicht. Je mehr davon in der Anfrage steht, desto belastbarer ist die Einschätzung, die zurückkommt:

  • Der konkrete Prozess, um den es geht — nicht „KI im Unternehmen“, sondern die Aufgabe
  • Die Systeme, in denen der Agent arbeiten müsste: CRM, ERP, Ticketsystem, Telefonie, Microsoft 365
  • Ungefähres Volumen pro Monat: Anfragen, Tickets, Anrufe, Belege
  • Ob es einen Datenzugang gibt — API, Export oder Systemzugang
  • Wer intern entscheidet und wie schnell diese Entscheidung realistisch kommt

WebMCP

Die Schnittstellen auf dieser Seite beschreiben Inhalte und nehmen eine Anfrage entgegen. Der andere Weg — eine Seite reicht dem Agenten im Browser benannte, typisierte Funktionen statt eines DOM zum Raten — heißt WebMCP und steckt Stand August 2026 in einem Chrome-Origin-Trial. Funktionsweise, Abgrenzung zu MCP und Browser-Automation sowie das Sicherheitsmodell stehen unter WebMCP.

Kontakt

Für alles, was ein Endpunkt nicht klären kann: info@agentifizierung.de oder +49 30 754 202 99. Wer lieber strukturiert einsteigt, nutzt den Agentifizierungs-Check.