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

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

MCP verwenden, wenn:

Ihre Plattform es unterstützt (Retell MCP Nodes, VAPI)
Sie automatische Tool-Erkennung wünschen
Sie einen Integrationspunkt statt vier Endpunkten möchten

REST verwenden, wenn:

Ihre Plattform nur HTTP-Aufrufe unterstützt
Sie detaillierte Kontrolle über einzelne Anfragen benötigen
Sie eine eigene Integration entwickeln