Az MCP (Model Context Protocol) egy nyílt szabvány, amelyen keresztül az olyan AI asszisztensek mint a Claude Desktop vagy a Claude Code közvetlenül elérhetik a Bokko foglalási adatait. A Bokko MCP szerver a fiókodhoz kötött, a Public API v1 fölött dolgozik, és lehetővé teszi, hogy a Claude a nevedben szolgáltatásokat, munkatársakat, elérhető idősávokat olvasson, illetve foglalásokat hozzon létre, listázzon vagy mondjon le.
InformációAz MCP hozzáférés Business csomagban érhető el. Az alacsonyabb csomagokban az MCP szerver nem fut, és a feature-gate (
mcpAccess) önállóan, az API kulcsokétól (apiAccess) elkülönülten kezeli a hozzáférést.Mire használhatod?
- A Claude megnézi az aktuális elérhető idősávokat egy adott szolgáltatáshoz, ha egy vendéggel együtt tervezel időpontot.
- Foglalási adatokat olvasol fel természetes nyelven, például "Listázd a holnapi foglalásokat Annánál".
- Új foglalást rögzítesz egy ismétlődő vendégnek anélkül, hogy a dashboardon kellene végigkattintanod.
- Egy meglévő foglalás eseménytörténetét visszakeresed audit vagy ügyfélszolgálati ügy miatt.
Előfeltételek
- Aktív Business előfizetés.
- Egy érvényes Bokko API kulcs
availability.read,services.read,staff.read,booking.read,booking.createésbooking.canceljogosultságokkal. A kulcs létrehozását a [API kulcsok kezelése](api-kulcsok) cikk írja le. - A salonod publikus slug-ja (megtalálod a publikus foglalási oldalad URL-jében).
- Telepített Node.js környezet (v22 vagy újabb) és Claude Desktop vagy Claude Code kliens.
Környezeti változók
| Változó | Kötelező | Leírás |
|---|---|---|
| BOKKO_API_KEY | Igen | A Bokko API kulcs (Bearer token, bk_live_… vagy bk_test_… előtaggal). |
| BOKKO_SALON_SLUG | Igen | A salonod publikus slug-ja. Az MCP szerver minden hívásnál automatikusan beilleszti. |
| BOKKO_API_BASE_URL | Nem | A Public API alap URL-je. Alapértelmezett: https://europe-west1-bokko-5bb2d.cloudfunctions.net/publicApiV1. |
FigyelemAz API kulcsot kezeld titokként. Soha ne commitold publikus repóba, és ne oszd meg chatben vagy képernyőképen. Ha gyanús a kulcs használata, a dashboard API kulcsok szekciójában azonnal vissza tudod vonni.
Beállítás Claude Desktopban
- Hozz létre egy API kulcsot Tulajdonos integráció fajtával a [API kulcsok kezelése](api-kulcsok) cikk lépései szerint, és mentsd el biztonságos helyre.
- Telepítsd a Bokko MCP szervert a fejlesztői dokumentációban szereplő
npm installésnpm run buildlépésekkel. - Nyisd meg a Claude Desktop konfigurációs fájlt (
claude_desktop_config.json). - Vedd fel a
bokkoMCP szervert amcpServersblokkba, és add meg aBOKKO_API_KEYésBOKKO_SALON_SLUGváltozókat. - Indítsd újra a Claude Desktopot, és próbáld ki egy egyszerű kéréssel, például "Listázd a Bokko szolgáltatásokat".
InformációA teljes konfigurációs példák és a tool-referenciák a fejlesztői dokumentációban érhetők el. A Bokko MCP szerver jelenleg 8 toolt biztosít: szolgáltatás- és munkatárs-listázás, elérhetőség-keresés, foglalás létrehozás, lekérés, listázás, lemondás és eseménytörténet.
Biztonsági szempontok
- Az MCP szerver a saját gépeden fut, és a Claude csak a
stdiocsatornán keresztül beszél vele. Az API kulcs nem hagyja el a gépedet, csak a Bokko Public API felé megy ki. - A salon scope a
BOKKO_SALON_SLUGváltozóval rögzítve van: a Claude más fiók adataihoz nem fér hozzá ezzel a konfigurációval. - Minden API hívás ugyanazon a hitelesítési rétegen megy át, mint a saját integrációid: lejárt vagy visszavont kulcs azonnal letiltja a Claude hozzáférését is.
- A foglalás-létrehozó és -lemondó toolok éles foglalásokat módosítanak, ezért éles használat előtt érdemes egy
bk_test_…előtagú kulccsal próbálni.
Hibakeresés
- A Claude nem látja a Bokko toolokat: ellenőrizd, hogy a
claude_desktop_config.jsonérvényes JSON-e, és újraindítottad-e a Claude Desktopot. - A hívás 401-gyel elesik: valószínűleg lejárt vagy hibásan másolt API kulcs. A dashboard API kulcsok listájában nézd meg a kulcs állapotát.
- A hívás 403-mal elesik: a kulcsnak nincs meg a kéréshez szükséges jogosultsága, vagy a fiókod nincs Business csomagban.
- Üres találatok: ellenőrizd, hogy a
BOKKO_SALON_SLUGpontosan a saját salonod publikus slug-ja-e.
InformációFejlesztői dokumentáció: A Bokko MCP szerver részletes telepítési útmutatója, a tool-referenciák és a kódpéldák a Bokko fejlesztői dokumentációban találhatók.