Připojení AI asistenta (MCP)

Jak nechat Claude, ChatGPT nebo jiného agenta pracovat s vaší Norkou přes Model Context Protocol.

Norka mluví protokolem MCP (Model Context Protocol). Jakmile asistenta připojíte, můžete se ho ptát „kdo přijíždí v pátek?“ nebo mu říct „zarezervuj Apartmán 2 Novákovým od 3. do 7. srpna“ a on to udělá, se stejnými pravidly a notifikacemi jako aplikace.

Adresa serveru je pro všechny klienty stejná:

https://mcp.mojenorka.cz/mcp

1. Vytvořte API token

V Norce otevřete Nastavení → API tokeny a klikněte na Vytvořit token.
Pojmenujte ho podle toho, kde ho použijete (například „Claude Desktop“), a zvolte rozsah:

Rozsah	Co asistent smí
čtení	vidět kalendář, pobyty, hosty, nezaplacené pobyty a nastavení
zápis	navíc rezervovat a měnit pobyty, přiřazovat úklid, posílat odkaz na check-in
správa	navíc měnit nastavení: objekty, kódy od dveří, sezóny, feedy

Token se zobrazí jen jednou. Zkopírujte ho; Norka si ukládá pouze jeho otisk. Kdykoli ho můžete zrušit.

Začněte s rozsahem čtení. Zápis nebo správu dejte tokenu, až když víte, k čemu ho asistent používá.

2. Vložte server do svého klienta

Token se posílá jako obyčejná hlavička Authorization: Bearer ….

Claude Desktop

Otevřete Settings → Developer → Edit Config a do souboru přidejte:

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

Claude Desktop restartujte. Norka se objeví mezi nástroji.

Claude Code

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

ChatGPT, Cursor a další

V nastavení klienta přidejte vzdálený MCP server (remote MCP server / connector) s adresou výše a hlavičkou Authorization. Postup se u klientů liší, ale vždy potřebujete jen tyto dva údaje.

Ověření

Zeptejte se asistenta: „Zavolej whoami.“ Odpoví, pro který pracovní prostor token platí a jaké nástroje má k dispozici.

3. Co asistent umí

Nástroje, které asistent vidí, se řídí rozsahem tokenu. Výběr:

Nástroj	Rozsah	Dělá
`get_movements`	čtení	kdo v daný den přijíždí a odjíždí
`check_availability`	čtení	které objekty jsou na termín volné a co stojí v cestě
`search_reservations`	čtení	pobyty podle data, objektu, stavu nebo jména
`get_reservation`	čtení	celý pobyt včetně kódu od dveří
`list_unpaid`	čtení	nezaplacené pobyty
`list_collisions`	čtení	dva pobyty na jeden objekt
`create_reservation`, `update_reservation`	zápis	zarezervuje nebo změní pobyt
`assign_cleaner`, `mark_cleaning_complete`	zápis	úklid po pobytu
`send_checkin_link`	zápis	pošle hostu odkaz na online check-in
`add_note`	zápis	zapíše poznámku do historie pobytu
`create_estate`, `update_season`, `create_pin_code`	správa	mění nastavení objektů, sezón a kódů

Každá odpověď obsahuje odkaz na stránku v aplikaci, ze které pochází, takže si ji můžete ověřit.

Co asistent schválně nemůže

Nic nemaže. Žádné rezervace, objekty, hosty ani členy.
Nevytváří ani neruší tokeny, takže uniklý token sám sebe neprodlouží.
Nespravuje členy a nemaže pracovní prostor. To vyžaduje přihlášení v aplikaci.
Kontakt na hosta dostane jen na výslovnou otázku podle jména; seznamy obsahují jen jména.
Každý nástroj má rozpočet volání. Když se asistent zacyklí, dostane srozumitelnou chybu a nic nerozbije.

Časté otázky

Mohu mít více tokenů? Ano. Doporučujeme jeden token na klienta, aby šel každý zvlášť zrušit.

Funguje token i mimo MCP? Ano, stejný token přijímá i REST API. Rozsah platí stejně: token pro čtení je odmítnut na každém požadavku, který něco mění.

Chci server vyzkoušet bez asistenta. Použijte oficiální MCP Inspector: npx @modelcontextprotocol/inspector, zadejte adresu serveru a hlavičku s tokenem.