← gwada.app

Dokumentation

Anmelden

Restaurant MCP

Model Context Protocol über Streamable HTTP — gleiche Schlüssel und Modul-Scopes wie die Public API.

Endpunkt: POST https://gwada.app/api/v1/mcp

Externe KI-Agenten (Claude Desktop, Cursor, Custom Hosts) können Tools entdecken und aufrufen, ohne REST-Endpunkte manuell zu orchestrieren. Auth und Freigaben sind identisch zur Public API: Bearer gwada_sk_live_…, Module pro Key unter Einstellungen → API.

Schnellstart

  1. API-Schlüssel anlegen und Module freischalten
  2. MCP-Client auf https://gwada.app/api/v1/mcp zeigen
  3. Header: Authorization: Bearer gwada_sk_live_…, Content-Type: application/json, optional MCP-Protocol-Version: 2025-06-18
  4. JSON-RPC: initialize → notifications/initialized → tools/list → tools/call

Beispiel: Tool-Discovery

curl -s -X POST "https://gwada.app/api/v1/mcp" \
  -H "Authorization: Bearer gwada_sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Antwort: result.tools[] mit name, description, inputSchema — nur freigeschaltete Module.

Beispiel: Tool aufrufen

curl -s -X POST "https://gwada.app/api/v1/mcp" \
  -H "Authorization: Bearer gwada_sk_live_…" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_menu",
      "arguments": {}
    }
  }'

Erfolg liefert MCP-Content mit JSON unter data (gleiche Payloads wie GET /api/v1/…). Fehler im Tool: isError: true und error-Code (z. B. module_not_enabled, restaurant_not_published).

Tools

ToolModulREST
get_menuSpeisekarteGET /api/v1/menu
get_reservation_configReservierungGET /api/v1/reservation
get_reviewsBewertungenGET /api/v1/reviews
get_newsNewsGET /api/v1/news
get_eventsEventsGET /api/v1/events
get_galleryGalerieGET /api/v1/gallery
get_opening_hoursÖffnungszeitenGET /api/v1/opening-hours
get_purchase_ordersBestellungenGET /api/v1/purchase-orders
create_reservationReservierungPOST /api/v1/reservation
manage_reservationReservierungPOST /api/v1/reservation/manage

Protokoll

  • Transport: Streamable HTTP (JSON-Antworten; kein SSE nötig für die aktuellen Tools)
  • Unterstützte Versionen: 2025-06-18, 2025-03-26
  • Methoden: initialize, ping, tools/list, tools/call, Notification notifications/initialized
  • Rate-Limit und Origin-Allowlist: wie REST
  • Öffentliche Module brauchen ein veröffentlichtes Restaurant; Bestellungen (purchase_orders) sind die Ausnahme

Nächste Schritte