Concierge

Entwickler

Verbinden Sie einen KI-Assistenten mit Concierge

Concierge veröffentlicht zwei Server für das offene Model Context Protocol (MCP). Der Business-Server gibt angemeldeten Mitarbeitenden die Werkzeuge, die ihre Rolle erlaubt, geschützt durch OAuth 2.1 mit PKCE; der Gäste-Server veröffentlicht Profil und FAQ eines gelisteten Hauses und, sobald ein Gast seine WhatsApp-Nummer bestätigt hat, dessen eigene Aufenthalte. Jeder für Gäste sichtbare oder zerstörende Schreibvorgang wartet auf die Bestätigung der Person.

  • Zwei MCP-Server
  • OAuth 2.1 mit PKCE
  • Veröffentlichte Metadaten
  • Hinweise „nur lesend“ und „zerstörend“
  • Bestätigung vor Änderungen, die Gäste sehen
Demo buchen Verbindung einrichten

Endpunkte

Zwei MCP-Server: einer für Ihr Team, einer für Gäste

Beide sprechen MCP über Streamable HTTP: ein Endpunkt, jede Operation ein POST. Jeder Server ist sein eigener OAuth-2.1-Autorisierungsserver, mit eigenem Aussteller und eigenem Signaturschlüssel.

Die Endpunkte werden zum Start des Dienstes veröffentlicht

Unten stehen die Pfade, unter denen jeder Server antwortet. Die Hostnamen folgen zum Start des Dienstes; bis dahin fragen Sie uns nach frühem Zugang.

Frühen Zugang anfragen

Business-Server

Für den Assistenten Ihres Teams

Assistant Access Verfügbar

Angemeldete Mitarbeitende erhalten die Werkzeuge, die ihre Rolle erlaubt. Das Token ist kurzlebig und an diesen Server gebunden, und der Platz der Person wird bei jedem Aufruf erneut geprüft.

Host
Wird zum Start des Dienstes veröffentlicht
MCP-Endpunkt
/mcp
Ressourcen-Metadaten · RFC 9728
/.well-known/oauth-protected-resource
Metadaten des Autorisierungsservers · RFC 8414
/.well-known/oauth-authorization-server

Scopes

concierge.read
Posteingang, Eskalationen, Aufenthalte, FAQ, Auswertungen und Berichte lesen
concierge.write
Interne Änderungen: FAQ-Einträge, Eskalationen, Aufenthalte und Entwürfe
concierge.send
Nachrichten, die Gäste auf WhatsApp erreichen
concierge.admin
Die Gruppenkonsole und Vorgänge der Plattform

Gäste-Server

Für die Assistenten Ihrer Gäste

Guest Assistant Auf Anfrage

Der öffentliche Endpunkt braucht keine Anmeldung: Profil, öffentliche Kontakte und FAQ eines gelisteten Hauses. Der persönliche Endpunkt ergänzt die eigenen Aufenthalte und Nachrichten eines Gastes, nachdem er seine WhatsApp-Nummer bestätigt hat.

Host
Wird zum Start des Dienstes veröffentlicht
Öffentlicher Endpunkt · ohne Anmeldung
/mcp
Persönlicher Endpunkt · nach WhatsApp-Bestätigung
/mcp/me
Ressourcen-Metadaten · RFC 9728
/.well-known/oauth-protected-resource

Scopes

guest.read
Eigene Aufenthalte und Unterhaltungen des Gastes und die FAQ des Hauses
guest.message
Dem Hotel schreiben und im Namen des Gastes eine Anfrage stellen
guest.data
Einwilligung, Anzeigename, Verbindungen und Datenanfragen

Anmeldung und Sicherheit

Wie meldet sich ein Assistent an?

Mitarbeitende melden sich mit ihrem normalen Concierge-Login an, Gäste bestätigen ihre WhatsApp-Nummer auf den eigenen Seiten von Concierge, nie im Assistenten. Jeder Aufruf prüft Platz, Haus und Scope der Person erneut.

  • OAuth 2.1 mit PKCE

    Der Authorization-Code-Flow mit PKCE (S256) ist Pflicht, nur für öffentliche Clients. Refresh-Tokens rotieren bei jeder Nutzung, und ein wiederverwendetes widerruft die ganze Kette.

  • Veröffentlichte Metadaten

    Ressourcen-Metadaten nach RFC 9728 und Server-Metadaten nach RFC 8414 sagen einem Client nach einem 401, wo er sich anmeldet. Clients registrieren sich mit einem Metadaten-Dokument oder dynamisch.

  • Ein Hinweis an jedem Werkzeug

    Jedes Werkzeug gibt an, ob es nur liest und ob es zerstörend wirkt, und tools/list zeigt nur, was der Platz der Person und die Scopes des Tokens erlauben.

  • Ein Token, ein Server

    Zugriffstoken sind mit ES256 signiert, gelten sechzig Minuten und nennen den Server, der sie ausgestellt hat. Deshalb lehnt der Gäste-Server ein Token des Business-Servers ab.

Jeder für Gäste sichtbare oder zerstörende Schreibvorgang wartet auf Bestätigung

Ein Client mit der Protokollrevision 2026-07-28 zeigt die Zusammenfassung von Concierge als Formular im Assistenten. Jeder andere Client erhält einen Link zu einer Bestätigungsseite von Concierge und ruft das Werkzeug erneut auf, sobald die Person freigegeben hat.

  1. Der Assistent fragt an

    Er ruft ein schreibendes Werkzeug wie conversation_reply auf. Noch ist nichts passiert.

  2. Concierge schreibt die Zusammenfassung

    Der Server, nicht der Assistent, sagt, was passieren wird. Die Person gibt frei oder lehnt ab.

  3. Es läuft einmal und wird festgehalten

    Die Freigabe gilt nur einmal, ist an Person, Werkzeug und Argumente gebunden und verfällt nach fünf Minuten. Das Audit-Protokoll nennt die Person und den Assistenten.

Verbinden

Fügen Sie Concierge Ihrem Assistenten hinzu

Assistenten, die MCP unterstützen, verbinden sich auf die gleiche Weise, zum Beispiel Claude von Anthropic, ChatGPT von OpenAI und Microsoft Copilot. Ihre Gruppenadministration entscheidet, welche davon Ihre Mitarbeitenden verbinden dürfen; Gäste wählen ihren eigenen.

  1. Server-URL eintragen

    Fügen Sie den Business- oder den Gäste-Endpunkt dort ein, wo Ihr Assistent einen benutzerdefinierten Connector oder MCP-Server hinzufügt.

  2. Anmelden, wenn danach gefragt wird

    Der erste Aufruf antwortet mit 401 und der Adresse der Metadaten. Mitarbeitende nutzen ihr Concierge-Login; Gäste bestätigen ihre WhatsApp-Nummer.

  3. Verbindung erlauben

    Sie erlauben sie einmal, für ein Haus. Für Mitarbeitende muss der Assistent auf der Liste stehen, die Ihre Gruppenadministration freigegeben hat; sie beginnt leer.

mcp.json Beispielkonfiguration für einen Client 
{
  "mcpServers": {
    "concierge": {
      "type": "http",
      "url": "https://<business-host>/mcp"
    },
    "concierge-guest": {
      "type": "http",
      "url": "https://<guest-host>/mcp/me"
    }
  }
}

Die beiden Hostnamen erhalten Sie mit dem frühen Zugang.

Der erste Aufruf, vor der Anmeldung

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="mcp",
  resource_metadata="…/.well-known/oauth-protected-resource"

Werkzeuge

Was kann ein Assistent tun?

Eine Auswahl aus beiden Servern. Welche Liste ein Assistent sieht, hängt von Person und Verbindung ab: Ein Werkzeug, das der Platz der Person nie öffnen könnte, fehlt, ebenso ein Schreibvorgang, für den das Token keinen Scope hat.

  • inbox_list Nur lesend

    Der Posteingang, seitenweise und gefiltert, mit maskierten Telefonnummern.

    Server
    Business
    Scope
    concierge.read
    Bestätigung
    Ohne Bestätigung
  • conversation_get Nur lesend

    Eine Unterhaltung mit ihren Nachrichten, dem Namen des Gastes und dem verknüpften Aufenthalt.

    Server
    Business
    Scope
    concierge.read
    Bestätigung
    Ohne Bestätigung
  • broadcast_preview Nur lesend

    Ein Probelauf einer Kampagne: wen sie erreicht und wer übersprungen wird. Sendet nichts.

    Server
    Business
    Scope
    concierge.read
    Bestätigung
    Ohne Bestätigung
  • faq_create Schreibend

    Fügt eine Sprachfassung einer FAQ-Frage hinzu. Gilt sofort.

    Server
    Business
    Scope
    concierge.write
    Bestätigung
    Ohne Bestätigung
  • conversation_reply Zerstörend

    Stellt eine Antwort des Teams auf WhatsApp in die Warteschlange, nachdem die Person den genauen Text bestätigt hat.

    Server
    Business
    Scope
    concierge.send
    Bestätigung
    Mit Bestätigung
  • stay_checkout Zerstörend

    Checkt einen Aufenthalt aus: Der Aufenthalts-QR-Code funktioniert nicht mehr, und die Unterhaltung wird geschlossen.

    Server
    Business
    Scope
    concierge.write
    Bestätigung
    Mit Bestätigung
  • broadcast_send Zerstörend

    Stellt eine Kampagne in die Warteschlange, nachdem die Person bestätigt hat, wie viele Gäste sie erreicht und wie viele übersprungen werden.

    Server
    Business
    Scope
    concierge.send
    Bestätigung
    Mit Bestätigung
  • search_faq Nur lesend

    Gereihte Antworten aus den Live-FAQ eines gelisteten Hauses auf die Frage eines Gastes.

    Server
    Gäste · öffentlich
    Scope
    Ohne Anmeldung
    Bestätigung
    Ohne Bestätigung
  • get_property Nur lesend

    Das öffentliche Profil eines gelisteten Hauses. Nie seine WhatsApp-Nummer.

    Server
    Gäste · öffentlich
    Scope
    Ohne Anmeldung
    Bestätigung
    Ohne Bestätigung
  • my_stays Nur lesend

    Die eigenen Aufenthalte des Gastes. Nie ein Check-in-Code oder ein Aufenthalts-QR-Link.

    Server
    Gäste · persönlich
    Scope
    guest.read
    Bestätigung
    Ohne Bestätigung
  • message_hotel Schreibend

    Stellt die Nachricht des Gastes in seine Unterhaltung; die Antwort aus den FAQ geht an den Assistenten zurück.

    Server
    Gäste · persönlich
    Scope
    guest.message
    Bestätigung
    Mit Bestätigung
  • request_data_deletion Zerstörend

    Bittet die Hotelgruppe, die Daten des Gastes zu löschen, fällig innerhalb von dreißig Tagen.

    Server
    Gäste · persönlich
    Scope
    guest.data
    Bestätigung
    Mit Bestätigung

tools/list liefert Ihrem Assistenten die vollständige Liste für die angemeldete Person.

Ablehnungen sind Werkzeugfehler

Eine Ablehnung kommt als Werkzeugfehler zurück, dessen Text mit einem maschinenlesbaren Code beginnt, damit der Assistent sagen kann, was schiefging. Ein unbekanntes Haus und eines, auf das Sie keinen Zugriff haben, antworten beide mit not_found.

  • unauthorized
  • no_property
  • not_found
  • forbidden
  • module_not_entitled
  • invalid_argument
  • insufficient_scope
  • conflict
  • unavailable
  • confirmation_required
  • declined
  • expired
  • not_approved

Was ein Assistent nie bekommt

  • Die vollständige Telefonnummer eines Gastes: Sie ist in jedem Ergebnis und Export maskiert.
  • Die WhatsApp-Nummer, das Konto oder das Routing eines Hauses.
  • Check-in-Codes oder Aufenthalts-QR-Links.
  • Ein Passwort: Kein Werkzeug nimmt eines als Argument an.
  • Von Gästen geschriebenen Text als Anweisung: Jedes Ergebnis kennzeichnet ihn als Daten.

Dokumentation

Die Details nachlesen

Die Server beschreiben sich selbst in ihren veröffentlichten Metadaten, und diese Website veröffentlicht eine Zusammenfassung im Klartext für KI-Assistenten und Antwortmaschinen.

  • llms.txt

    Eine Zusammenfassung von Concierge im Klartext für KI-Assistenten und Antwortmaschinen, mit einem Link auf den vollständigen Text der Website.

    llms.txt öffnen

  • Server-Metadaten

    Jeder Server veröffentlicht Ressourcen-Metadaten nach RFC 9728 und Metadaten des Autorisierungsservers nach RFC 8414: die Ressource, die Scopes und wo die Schlüssel liegen.

    Wird zum Start des Dienstes veröffentlicht

    Frühen Zugang anfragen

  • Sicherheit und Datenschutz

    Hosting in der EU, die Daten jedes Hotels getrennt von denen anderer, Maskierung, Einwilligung, das Audit-Protokoll und wo unsere Kontrollen enden.

    Zur Sicherheitsseite

  • Eine Schwachstelle melden

    Unser Sicherheitskontakt, maschinenlesbar nach RFC 9116. Bitte informieren Sie uns vertraulich, bevor Sie etwas veröffentlichen.

    security.txt öffnen

Buchen Sie eine Demo oder fragen Sie uns alles

Erzählen Sie uns von Ihrem Haus, und wir zeigen Concierge an Ihren eigenen Fragen. Wir antworten innerhalb eines Werktags.

Demo buchen