Concierge

Dezvoltatori

Conectați un asistent AI la Concierge

Concierge publică două servere pentru protocolul deschis Model Context Protocol (MCP). Serverul pentru hotel îi oferă unui membru al personalului autentificat instrumentele permise de rolul său, prin OAuth 2.1 cu PKCE; serverul pentru oaspeți publică profilul și FAQ-ul unei proprietăți listate și, după ce oaspetele își verifică numărul de WhatsApp, propriile lui sejururi. Orice scriere vizibilă pentru oaspeți sau distructivă așteaptă confirmarea persoanei.

  • Două servere MCP
  • OAuth 2.1 cu PKCE
  • Metadate publicate
  • Indicii „doar citire” și „distructiv”
  • Confirmare înaintea scrierilor vizibile pentru oaspeți
Programați o demonstrație Cum vă conectați

Endpoint-uri

Două servere MCP: unul pentru echipă, unul pentru oaspeți

Ambele vorbesc MCP prin Streamable HTTP: un singur endpoint, fiecare operație un POST. Fiecare server este propriul server de autorizare OAuth 2.1, cu propriul emitent și propria cheie de semnare.

Endpoint-urile se publică la deschiderea serviciului

Mai jos sunt căile la care răspunde fiecare server. Numele gazdelor urmează la deschiderea serviciului; până atunci, cereți-ne acces anticipat.

Cereți acces anticipat

Serverul pentru hotel

Pentru asistentul echipei dumneavoastră

Assistant Access Disponibil

Un membru al personalului autentificat primește instrumentele permise de rolul său. Tokenul are durată scurtă și este legat de acest server, iar locul persoanei este verificat din nou la fiecare apel.

Gazdă
Se publică la deschiderea serviciului
Endpoint MCP
/mcp
Metadatele resursei · RFC 9728
/.well-known/oauth-protected-resource
Metadatele serverului de autorizare · RFC 8414
/.well-known/oauth-authorization-server

Scope-uri

concierge.read
Citirea inbox-ului, escaladărilor, sejururilor, FAQ-ului, analizelor și rapoartelor
concierge.write
Modificări interne: intrări FAQ, escaladări, sejururi și ciorne
concierge.send
Mesaje care ajung la oaspeți pe WhatsApp
concierge.admin
Consola grupului și operațiunile platformei

Serverul pentru oaspeți

Pentru asistenții oaspeților dumneavoastră

Guest Assistant La cerere

Endpoint-ul public nu cere autentificare: profilul, contactele publice și FAQ-ul unei proprietăți listate. Endpoint-ul personal adaugă sejururile și mesajele oaspetelui, după ce acesta își verifică numărul de WhatsApp.

Gazdă
Se publică la deschiderea serviciului
Endpoint public · fără autentificare
/mcp
Endpoint personal · după verificarea WhatsApp
/mcp/me
Metadatele resursei · RFC 9728
/.well-known/oauth-protected-resource

Scope-uri

guest.read
Sejururile și conversațiile oaspetelui și FAQ-ul proprietății
guest.message
Mesaje către hotel și cereri în numele oaspetelui
guest.data
Consimțământ, nume afișat, conexiuni și cereri privind datele

Autentificare și siguranță

Cum se autentifică un asistent?

Personalul se autentifică cu contul obișnuit de Concierge, iar oaspeții își dovedesc numărul de WhatsApp pe paginile Concierge, niciodată în asistent. Fiecare apel verifică din nou locul persoanei, proprietatea și scope-ul.

  • OAuth 2.1 cu PKCE

    Fluxul cu cod de autorizare și PKCE (S256) este obligatoriu, doar pentru clienți publici. Tokenurile de reîmprospătare se schimbă la fiecare folosire, iar unul refolosit revocă întregul lanț.

  • Metadate publicate

    Metadatele resursei (RFC 9728) și ale serverului (RFC 8414) îi arată clientului unde să se autentifice după un 401. Clienții se înregistrează cu un document de metadate sau dinamic.

  • Un indiciu pe fiecare instrument

    Fiecare instrument spune dacă doar citește și dacă este distructiv, iar tools/list arată doar ce permit locul persoanei și scope-urile tokenului.

  • Un token, un server

    Tokenurile de acces sunt semnate ES256, sunt valabile șaizeci de minute și numesc serverul care le-a emis, așa că serverul pentru oaspeți refuză un token al serverului pentru hotel.

Orice scriere vizibilă pentru oaspeți sau distructivă așteaptă confirmarea persoanei

Un client pe revizia de protocol 2026-07-28 afișează rezumatul Concierge ca formular în asistent. Orice alt client primește un link către o pagină de confirmare Concierge și apelează instrumentul din nou după ce persoana a aprobat.

  1. Asistentul cere

    Apelează un instrument de scriere, de exemplu conversation_reply. Încă nu s-a întâmplat nimic.

  2. Concierge scrie rezumatul

    Serverul, nu asistentul, spune ce se va întâmpla. Persoana aprobă sau refuză.

  3. Rulează o singură dată și se înregistrează

    Aprobarea este de unică folosință, legată de persoană, de instrument și de argumentele lui, și expiră după cinci minute. Jurnalul de audit numește persoana și asistentul.

Conectare

Adăugați Concierge în asistentul dumneavoastră

Asistenții care acceptă MCP se conectează la fel, de exemplu Claude de la Anthropic, ChatGPT de la OpenAI și Microsoft Copilot. Administratorul de grup decide pe care îi poate conecta personalul; oaspeții își aleg singuri asistentul.

  1. Adăugați adresa serverului

    Lipiți endpoint-ul pentru hotel sau pe cel pentru oaspeți acolo unde asistentul adaugă un conector personalizat sau un server MCP.

  2. Autentificați-vă când vi se cere

    Primul apel răspunde cu 401 și adresa metadatelor. Personalul folosește contul Concierge; oaspeții își verifică numărul de WhatsApp.

  3. Permiteți conexiunea

    O permiteți o singură dată, pentru o proprietate. Pentru personal, asistentul trebuie să fie pe lista permisă de administratorul de grup, care la început este goală.

mcp.json Exemplu de configurare a clientului 
{
  "mcpServers": {
    "concierge": {
      "type": "http",
      "url": "https://<business-host>/mcp"
    },
    "concierge-guest": {
      "type": "http",
      "url": "https://<guest-host>/mcp/me"
    }
  }
}

Numele celor două gazde le primiți odată cu accesul anticipat.

Primul apel, înainte de autentificare

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

Instrumente

Ce poate face un asistent?

O selecție din ambele servere. Lista pe care o vede un asistent depinde de persoană și de conexiune: lipsește un instrument pe care locul persoanei nu l-ar putea deschide niciodată, la fel și o scriere pentru care tokenul nu are scope.

  • inbox_list Doar citire

    Inbox-ul, paginat și filtrat, cu numerele de telefon mascate.

    Server
    Hotel
    Scope
    concierge.read
    Confirmare
    Fără confirmare
  • conversation_get Doar citire

    O conversație cu mesajele ei, numele oaspetelui și sejurul asociat.

    Server
    Hotel
    Scope
    concierge.read
    Confirmare
    Fără confirmare
  • broadcast_preview Doar citire

    O simulare a unei campanii: pe cine atinge și pe cine omite. Nu trimite nimic.

    Server
    Hotel
    Scope
    concierge.read
    Confirmare
    Fără confirmare
  • faq_create Scriere

    Adaugă versiunea într-o limbă a unei întrebări FAQ. Se aplică imediat.

    Server
    Hotel
    Scope
    concierge.write
    Confirmare
    Fără confirmare
  • conversation_reply Distructiv

    Pune în coadă un răspuns al personalului pe WhatsApp, după ce persoana confirmă textul exact.

    Server
    Hotel
    Scope
    concierge.send
    Confirmare
    Cere confirmare
  • stay_checkout Distructiv

    Face check-out pentru un sejur: codul QR de sejur nu mai funcționează, iar conversația se închide.

    Server
    Hotel
    Scope
    concierge.write
    Confirmare
    Cere confirmare
  • broadcast_send Distructiv

    Pune în coadă o campanie, după ce persoana confirmă câți oaspeți atinge și câți sunt omiși.

    Server
    Hotel
    Scope
    concierge.send
    Confirmare
    Cere confirmare
  • search_faq Doar citire

    Răspunsuri ordonate din FAQ-ul live al unei proprietăți listate, pentru întrebarea unui oaspete.

    Server
    Oaspeți · public
    Scope
    Fără autentificare
    Confirmare
    Fără confirmare
  • get_property Doar citire

    Profilul public al unei proprietăți listate. Niciodată numărul ei de WhatsApp.

    Server
    Oaspeți · public
    Scope
    Fără autentificare
    Confirmare
    Fără confirmare
  • my_stays Doar citire

    Sejururile oaspetelui. Niciodată un cod de check-in sau un link QR de sejur.

    Server
    Oaspeți · personal
    Scope
    guest.read
    Confirmare
    Fără confirmare
  • message_hotel Scriere

    Pune mesajul oaspetelui în conversația lui; răspunsul din FAQ se întoarce la asistent.

    Server
    Oaspeți · personal
    Scope
    guest.message
    Confirmare
    Cere confirmare
  • request_data_deletion Distructiv

    Cere grupului hotelier să șteargă datele oaspetelui, cu termen de treizeci de zile.

    Server
    Oaspeți · personal
    Scope
    guest.data
    Confirmare
    Cere confirmare

tools/list îi returnează asistentului lista completă pentru persoana autentificată.

Refuzurile sunt erori de instrument

Un refuz vine ca eroare de instrument al cărei text începe cu un cod lizibil automat, astfel încât asistentul poate spune ce nu a mers. O proprietate necunoscută și una la care nu aveți acces răspund amândouă not_found.

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

Ce nu primește niciodată un asistent

  • Numărul complet de telefon al unui oaspete: este mascat în fiecare rezultat și export.
  • Numărul de WhatsApp, contul sau rutarea unei proprietăți.
  • Coduri de check-in sau linkuri QR de sejur.
  • O parolă: niciun instrument nu primește una ca argument.
  • Textul scris de oaspeți ca instrucțiuni: fiecare rezultat îl marchează ca date.

Documentație

Citiți detaliile

Serverele se descriu singure în metadatele publicate, iar acest site publică un rezumat în text simplu pentru asistenți AI și motoare de răspuns.

  • llms.txt

    Un rezumat în text simplu al Concierge pentru asistenți AI și motoare de răspuns, cu un link către tot textul site-ului.

    Deschideți llms.txt

  • Metadatele serverelor

    Fiecare server publică metadatele resursei (RFC 9728) și ale serverului de autorizare (RFC 8414): resursa, scope-urile și locul cheilor.

    Se publică la deschiderea serviciului

    Cereți acces anticipat

  • Securitate și confidențialitate

    Găzduire în UE, datele unui hotel separate de ale altuia, mascare, consimțământ, jurnalul de audit și limitele controalelor noastre.

    Citiți pagina de securitate

  • Raportați o vulnerabilitate

    Contactul nostru de securitate, în format automat conform RFC 9116. Vă rugăm să ne anunțați în privat înainte să publicați ceva.

    Deschideți security.txt

Programați o demonstrație sau întrebați-ne orice

Povestiți-ne despre proprietatea dumneavoastră și vă arătăm Concierge pe propriile întrebări. Răspundem într-o zi lucrătoare.

Programați o demonstrație