Integrare · AI

HoReCaOS în Claude (conector MCP)

HoReCaOS e primul sistem HoReCa din România pregătit pentru agenți AI (agentic-ready). Are un server MCP (Model Context Protocol) cu autentificare OAuth 2.1, pe care îl adaugi ca conector în Claude sau în orice client compatibil MCP. Pui întrebări despre restaurant în limbaj obișnuit: cât ai vândut ieri pe canale, ce produse sunt sub stocul minim, care e food cost-ul. Folosești abonamentul tău de AI; HoReCaOS dă datele, cu drepturile tale.

Ce face concret

• Citiri: vânzări pe zi, pe oră, pe canal și pe metodă de plată, produsele de top, anulările, închiderile de zi, food cost-ul, stocul scăzut, valoarea și mișcările stocului, pierderile, recepțiile recente, datoriile la furnizori, creanțele de la clienți, rezervările, meniul și rețetele, locațiile.
• Acțiuni: crearea și anularea unei rezervări și marcarea unui produs ca disponibil sau epuizat. Fiecare acțiune cere un scop OAuth pe care îl bifezi explicit la conectare și permisiunea ta din aplicație.
• Agentul vede doar firma ta și doar ce permite rolul tău. Fiecare acțiune intră în jurnalul de audit.

Cum o pornești

1. Adresa conectorului este https://app.horecaos.org/api/mcp (o găsești și în aplicație, la Instrumente → API).
2. În Claude (desktop, web sau mobil): Setări → Connectors → Add custom connector, lipești adresa.
3. Ești trimis în HoReCaOS, te autentifici și alegi ce permiți (OAuth). Conexiunea apare la Aplicații conectate.
4. Conexiunea se revocă oricând din aplicație.

Limite și ce să știi

• Acțiunile de back-office (NIR, stoc, comenzi la furnizori, ture, prețuri) nu sunt încă disponibile prin conector.
• Recomandăm Claude. Orice alt client care suportă conectori MCP la distanță cu OAuth poate folosi aceeași adresă.
• Abonamentul la clientul AI e al tău; HoReCaOS nu îl include.
• Dacă nu revii în HoReCaOS să aprobi accesul, conexiunea nu se finalizează.

Detalii tehnice: ghidul API & Webhooks. Despre agenții AI din aplicație: Agenți AI.

Întrebări frecvente

Poate agentul AI să modifice date în HoReCaOS?

Doar prin acțiunile pe care le aprobi explicit la conectare (de exemplu crearea sau anularea unei rezervări, disponibilitatea unui produs) și numai cât îți permite rolul tău în aplicație. Fiecare acțiune intră în jurnalul de audit.

Trebuie să știu programare?

Nu. Adaugi adresa conectorului în Claude și aprobi accesul în HoReCaOS.

Cine plătește modelul AI?

Tu, prin abonamentul tău la Claude sau la alt client MCP. HoReCaOS nu îl include.