MCP-Endpunkt

API-Referenz für den FlowCaptain MCP-Endpunkt (Model Context Protocol) zur automatischen Tool-Erkennung.

MCP-Endpunkt

FlowCaptain stellt einen MCP-Endpunkt (Model Context Protocol) bereit, der Voice-Bot-Plattformen ermöglicht, alle Termin-Tools automatisch zu erkennen und zu nutzen.

Endpunkt

POST /mcp

Headers

Authorization: Bearer sk_live_ihr_api_schluessel
Accept: application/json, text/event-stream
Content-Type: application/json

Der Accept-Header muss sowohl application/json als auch text/event-stream enthalten. Voice-Bot-Plattformen wie Retell und VAPI senden dies automatisch.

So funktioniert es

MCP ist ein Protokoll, das die dynamische Erkennung von KI-Tools ermöglicht. Anstatt jeden Endpunkt manuell zu konfigurieren, verbindet sich Ihr Voice Bot einmal mit dem MCP-Endpunkt und sieht automatisch alle verfügbaren Tools:

Die Plattform sendet eine initialize-Anfrage zur Erkennung der Fähigkeiten
Dann sendet sie eine tools/list-Anfrage, um alle verfügbaren Tools zu erhalten
Wenn der Voice Bot Verfügbarkeit prüfen oder einen Termin buchen muss, sendet er eine tools/call-Anfrage

Verfügbare Tools

Tool-Name	Beschreibung
check_availability	Verfügbare Zeitfenster mit natürlicher Sprache prüfen
book_appointment	Termin mit Anruferdaten buchen
cancel_appointment	Bestehenden Termin stornieren
reschedule_appointment	Termin auf neue Zeit umbuchen
request_callback	Rückruf anfordern, wenn der Bot das Anliegen nicht lösen kann

Testen mit curl

curl -X POST https://api.flowcaptain.ai/mcp \
  -H "Authorization: Bearer sk_live_ihr_api_schluessel" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "test", "version": "1.0" }
    }
  }'

Wann MCP vs. REST verwenden

Beide bieten den gleichen Funktionsumfang. MCP erkennt alle Tools automatisch über einen einzigen Endpunkt, während REST separate Endpunkte pro Aktion verwendet. Wir empfehlen MCP, wann immer Ihre Plattform es unterstützt — die Einrichtung ist schneller und neue Tools stehen automatisch zur Verfügung, ohne Ihre Integration anzupassen.