Všechny návodyNávod

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

  1. V Norce otevřete Nastavení → AI agent a API a klikněte na Vytvořit token.
  2. Pojmenujte ho podle toho, kde ho použijete (například „Claude Desktop“), a zvolte rozsah:
RozsahCo asistent smí
čtenívidět kalendář, pobyty, hosty, nezaplacené pobyty a nastavení
zápisnavíc rezervovat a měnit pobyty, přiřazovat úklid, posílat odkaz na check-in
správanavíc měnit nastavení: objekty, kódy od dveří, sezóny, feedy
  1. 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ástrojRozsahDě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_guestsčteníkdo je na pobytu
get_guest_bookčteníkniha hostů za období: kdo u vás bydlel a co záznamům chybí (bez adres a čísel dokladů)
get_estate_statisticsčtenítržby a obsazenost objektu po měsících, i rezervované tržby a noci na 12 měsíců dopředu (zaplacené zvlášť) a nezaplacené peníze po pobytech s dnem, kdy mají přijít
get_estate_pricingčteníceník objektu: základní cena, ceny v sezónách, výjimky a rok dopředu noc po noci
get_price_quotečteníkolik stojí pobyt v daném termínu podle ceníku
list_unpaidčtenínezaplacené pobyty včetně po splatnosti
get_attentiončteníco teď řešit: kolize, pobyty po splatnosti, chybějící uklízečky, chyby synchronizace, nevyřízené poptávky, objekty bez kapacity, pobyty s neúplnou knihou hostů
preview_transferčteníco udělá přesun pobytu do jiného objektu
list_collisionsčtenídva pobyty na jeden objekt
list_inquiriesčtenípoptávky z rezervačního widgetu, které čekají na odpověď
list_conversations, get_conversationčtenízprávy od hostů ve schránce prostoru: seznam konverzací a jedna konverzace se všemi zprávami. Jen s funkcí Zprávy
list_booking_widgetsčtenírezervační widgety na vašich webech: co nabízejí, vzhled, povolené weby a kód pro vložení
create_reservation, update_reservationzápiszarezervuje nebo změní pobyt; paid u update_reservation označí pobyt jako zaplacený nebo to vrátí, v kterékoli fázi
block_dateszápiszablokuje termín objektu kvůli údržbě
transfer_reservationzápispřesune pobyt do jiného objektu
resolve_collisionzápisvyřeší kolizi zrušením jedné ze dvou překrývajících se rezervací
update_reservation_estatezápiscena, úklid nebo kód od dveří jednoho objektu pobytu, nebo že se po něm neuklízí
add_guest, update_guestzápishosté na pobytu včetně druhu dokladu; číslo dokladu se přes asistenta nezadává
assign_cleaner, mark_cleaning_completezápisúklid po pobytu
send_checkin_linkzápispošle hostu odkaz na online check-in e-mailem, se zapnutými SMS i SMS
add_notezápiszapíše poznámku do historie pobytu
list_invoicesčtenívšechny faktury a opravné doklady s filtry a celkovým součtem
get_invoicesčteníjestli pobyt potřebuje fakturu, na kolik by byla a co už je vystavené
issue_invoicezápisvystaví fakturu za pobyt na hlavního hosta, s číslem, už bez možnosti úprav
send_invoicezápispošle fakturu hostovi e-mailem i s PDF
accept_inquiry, decline_inquiryzápispřijme poptávku z webu (pobyt se potvrdí a host dostane potvrzení), nebo ji odmítne, uvolní termín a dá hostovi e-mailem vědět
reply_to_conversationzápispošle hostovi e-mailem odpověď jménem prostoru a přidá ji do konverzace. Jen s funkcí Zprávy
start_conversationzápisnapíše hlavnímu hostovi pobytu jako první a založí konverzaci, do které dorazí jeho odpověď. Jen s funkcí Zprávy
update_conversationzápisuzavře nebo znovu otevře konverzaci, přesune ji do jiné složky nebo ji spojí s pobytem; nikomu nic neposílá. Jen s funkcí Zprávy
create_estate, update_season, create_pin_codesprávamění nastavení objektů (nový objekt vyžaduje kapacitu beds a extra_beds), sezón a kódů, včetně úklidového seznamu po místnostech (cleaning_checklist); update_estate umí objekt i vypnout, takže se přestane nabízet a počítat do obsazenosti; nový nebo znovu zapnutý objekt nad limit tarifu prostoru Norka odmítne
list_estate_groupsčtenískupiny objektů, které patří k sobě, třeba chalupa se čtyřmi apartmány
create_estate_group, update_estate_group, delete_estate_groupsprávavytvoří, upraví nebo smaže skupinu včetně adresy a GPS souřadnic (latitude, longitude; odpověď obsahuje odkaz na Mapy.com), které převezmou její objekty a samy je nemění, a celý objekt (whole_house), který nabízejí weby skupiny; objekty po smazání zůstanou. update_estate objekt do skupiny přesune (group_id) nebo z ní vyjme (leave_group)
list_websites, update_website, set_website_estatesčtení / zápisweby prostoru; přejmenování webu nebo změna toho, o čem je (skupina, vybrané objekty, celý prostor); výběr objektů webu. Ostatní nástroje webu berou website_id, když je webů víc
set_season_price, create_rate_rule, update_rate_rulesprávacena objektu za noc v sezóně a pevná cena nebo sleva pro konkrétní termín
create_booking_widget, update_booking_widgetsprávazaloží nebo upraví rezervační widget: nabízené objekty, povolené weby, minimální počet nocí, zobrazení cen a hodnocení, vypnutí, barvy jako hex kód (accent, free, busy), zaoblení a velikost (compact, regular, large); smazání widgetu a obnovení jeho tokenu zůstávají v aplikaci
get_workspace_settings, update_workspace_settingsčtení / správakam chodí upozornění na rezervace a kam odpovědi hostů; zapnutí či vypnutí SMS hostům; adresa schránky a kopie konverzací do e-mailu
list_cleanersčteníuklízečky podle jména, aby šlo některou přiřadit k pobytu
create_ical_import, update_ical_import, run_ical_importsprávapřipojí kalendář portálu k objektu, změní ho nebo pozastaví, případně ho hned načte
list_ical_exports, create_ical_export, update_ical_exportčtení / správaadresy kalendáře, ze kterých portály čtou obsazené termíny; pro každý portál nová

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.
  • Nestornuje faktury. Storno nebo opravný daňový doklad uděláte sami v aplikaci.
  • 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.
  • Čísla dokladů a víz nevidí vůbec, ani zkrácená. Knihu hostů s nimi stáhnete jen sami v aplikaci.
  • 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í. Token přestane fungovat, jakmile člověk, který ho vytvořil, přestane být vlastníkem pracovního prostoru.

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