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
- API-Schlüssel anlegen und Module freischalten
- MCP-Client auf
https://gwada.app/api/v1/mcpzeigen - Header:
Authorization: Bearer gwada_sk_live_…,Content-Type: application/json, optionalMCP-Protocol-Version: 2025-06-18 - 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
| Tool | Modul | REST |
|---|---|---|
| get_menu | Speisekarte | GET /api/v1/menu |
| get_reservation_config | Reservierung | GET /api/v1/reservation |
| get_reviews | Bewertungen | GET /api/v1/reviews |
| get_news | News | GET /api/v1/news |
| get_events | Events | GET /api/v1/events |
| get_gallery | Galerie | GET /api/v1/gallery |
| get_opening_hours | Öffnungszeiten | GET /api/v1/opening-hours |
| get_purchase_orders | Bestellungen | GET /api/v1/purchase-orders |
| create_reservation | Reservierung | POST /api/v1/reservation |
| manage_reservation | Reservierung | POST /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, Notificationnotifications/initialized - Rate-Limit und Origin-Allowlist: wie REST
- Öffentliche Module brauchen ein veröffentlichtes Restaurant; Bestellungen (
purchase_orders) sind die Ausnahme