KI-Assistenten verbinden (MCP)

Norka spricht MCP (das Model Context Protocol). Sobald ein Assistent verbunden ist, können Sie ihn fragen „Wer reist am Freitag an?“ oder ihm sagen „Buche Apartment 2 für die Nováks vom 3. bis 7. August“, und er erledigt das, mit denselben Regeln und Benachrichtigungen wie die App.

Die Serveradresse ist für jeden Client dieselbe:

https://mcp.mojenorka.cz/mcp

1. Einen API-Token erstellen

1. Öffnen Sie in Norka Einstellungen → API-Tokens und klicken Sie auf Token erstellen.
2. Benennen Sie ihn danach, wo Sie ihn verwenden (zum Beispiel „Claude Desktop“), und wählen Sie einen Umfang:

3. Der Token wird nur einmal angezeigt. Kopieren Sie ihn; Norka speichert nur seinen Hash. Sie können ihn jederzeit widerrufen.

Beginnen Sie mit dem Umfang Lesen. Geben Sie einem Token Schreib- oder Verwaltungsrechte erst, wenn Sie wissen, wofür der Assistent ihn nutzt.

2. Den Server in Ihrem Client eintragen

Der Token wird als gewöhnlicher Header Authorization: Bearer … gesendet.

Claude Desktop

Öffnen Sie Settings → Developer → Edit Config und fügen Sie hinzu:

{
  "mcpServers": {
    "norka": {
      "url": "https://mcp.mojenorka.cz/mcp",
      "headers": { "Authorization": "Bearer nrk_…" }
    }
  }
}

Starten Sie Claude Desktop neu. Norka erscheint unter den Tools.

Claude Code

claude mcp add --transport http norka https://mcp.mojenorka.cz/mcp \
  --header "Authorization: Bearer nrk_…"

ChatGPT, Cursor und andere

Fügen Sie in den Einstellungen des Clients einen entfernten MCP-Server hinzu (manchmal Connector genannt), mit der Adresse oben und dem Header Authorization. Die genauen Schritte unterscheiden sich je nach Client, aber mehr als diese beiden Angaben braucht es nicht.

Prüfen, ob es funktioniert

Bitten Sie den Assistenten: „Rufe whoami auf.“ Er antwortet mit dem Arbeitsbereich, für den der Token gilt, und den Tools, die er hat.

3. Was der Assistent kann

Welche Tools ein Assistent sieht, richtet sich nach dem Umfang des Tokens. Eine Auswahl:

Jede Antwort enthält einen Link auf die Seite in der App, aus der sie stammt, sodass Sie sie überprüfen können.

Was der Assistent bewusst nicht kann

• Etwas löschen. Keine Reservierungen, Objekte, Gäste oder Mitglieder.
• Er storniert keine Rechnungen. Eine Stornierung oder Gutschrift erstellen Sie selbst in der App.
• Tokens erstellen oder widerrufen, damit sich ein geleakter Token nicht selbst erneuern kann.
• Mitglieder verwalten oder den Arbeitsbereich löschen. Dafür ist eine angemeldete Sitzung in der App nötig.
• Kontaktdaten von Gästen sehen, außer wenn er gezielt nach einem Gast mit Namen fragt; Listen enthalten nur Namen.
• Außer Kontrolle geraten. Jedes Tool hat ein Aufrufbudget; ein Assistent, der in einer Schleife hängt, erhält eine verständliche Fehlermeldung und macht nichts kaputt.

Häufige Fragen

Kann ich mehrere Tokens haben? Ja. Ein Token pro Client ist eine gute Gewohnheit, damit sich jeder einzeln widerrufen lässt.

Funktioniert der Token auch außerhalb von MCP? Ja, die REST API akzeptiert denselben Token. Der Umfang gilt genauso: Ein Lese-Token wird bei jeder Anfrage abgelehnt, die etwas ändert.

Ich möchte den Server ohne Assistenten ausprobieren. Verwenden Sie den offiziellen MCP Inspector: npx @modelcontextprotocol/inspector, geben Sie die Serveradresse und den Header mit dem Token ein.