Der MCP-Endpunkt

Der MCP-Endpunkt ist der Weg, über den Tool-nutzende Assistenten (claude.ai-Konnektoren, ChatGPT und andere MCP-Clients) mit einer Praxis sprechen:

POST /api/a2a/{public-token}/mcp

Transport ist Streamable HTTP, zustandslos, nur JSON-Antworten. Das Token steht in der URL, weil mehrere Assistenten-Plattformen beim Hinzufügen eines Konnektors keine eigenen Header setzen können.

Live-Demo-Konnektor, direkt zum Einfügen in jeden MCP-Client:

https://founderexecute.com/api/a2a/a2a_4adce6dd8c149abd94d885bbe7a32323cfc9745edfa53b8e/mcp

Ein Tool: reception_message

Der verbundene Assistent sieht genau ein Tool:

{
  "name": "reception_message",
  "inputSchema": {
    "message": "string — Ihre Nachricht an die Rezeption, Klartext",
    "conversation_id": "uuid, optional — aus dem vorherigen Ergebnis; nur bei der ersten Nachricht weglassen"
  }
}

Jeder Aufruf liefert:

{
  "reply": "Am Donnerstag habe ich 14:30 oder 16:00 bei Frau Weber. Was passt?",
  "conversation_id": "0d7c…",
  "status": "ok"
}

Der Gesprächsvertrag

1. Der Assistent schickt Nachrichten, die Rezeption antwortet, und der Assistent gibt conversation_id bei jedem Zug zurück. Diese ID ist der gesamte Sitzungszustand; es gibt keine Server-Sessions.
2. Wenn die Rezeption den Patienten verifizieren muss, wird status zu "awaiting_input": Der Patient hat gerade einen 6-stelligen SMS-Code bekommen, der Assistent fragt seinen Nutzer danach und gibt ihn wörtlich weiter.
3. Bevor etwas final ist, liest die Rezeption die Buchung vor und bittet um Bestätigung.
4. Ist ein Gespräch abgelaufen, trägt die nächste Antwort "conversation_reset": true und eine frische ID. Der Assistent fasst das Anliegen kurz zusammen und macht weiter.

Diese Regeln werden dem Assistenten im MCP-Feld instructions mitgegeben; gut erzogene Clients folgen ihnen ohne Zusatzarbeit auf Ihrer Seite.

Limits

Pro Token: 30 Anfragen pro Minute, plus eine tägliche, in der Datenbank gezählte Gesprächsobergrenze. Genug für echte Patienten, langweilig für Schleifen.

Dasselbe Gespräch über A2A

Agenten, die das A2A-Protokoll sprechen, senden stattdessen JSON-RPC an /api/a2a/{public-token}: message/send mit Text-Parts und optionaler contextId (gleiche Kontinuitätsidee), dazu tasks/get zum erneuten Lesen des letzten Tasks. Antworten sind A2A-Task-Objekte mit Status completed oder input-required (der SMS-Schritt). Streaming gibt es auf keinem der beiden Transporte.