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í → AI agent a API 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_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_reservation | zápis | zarezervuje nebo změní pobyt; paid u update_reservation označí pobyt jako zaplacený nebo to vrátí, v kterékoli fázi |
block_dates | zápis | zablokuje termín objektu kvůli údržbě |
transfer_reservation | zápis | přesune pobyt do jiného objektu |
resolve_collision | zápis | vyřeší kolizi zrušením jedné ze dvou překrývajících se rezervací |
update_reservation_estate | zápis | cena, úklid nebo kód od dveří jednoho objektu pobytu, nebo že se po něm neuklízí |
add_guest, update_guest | zápis | hosté na pobytu včetně druhu dokladu; číslo dokladu se přes asistenta nezadává |
assign_cleaner, mark_cleaning_complete | zápis | úklid po pobytu |
send_checkin_link | zápis | pošle hostu odkaz na online check-in e-mailem, se zapnutými SMS i SMS |
add_note | zápis | zapíš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_invoice | zápis | vystaví fakturu za pobyt na hlavního hosta, s číslem, už bez možnosti úprav |
send_invoice | zápis | pošle fakturu hostovi e-mailem i s PDF |
accept_inquiry, decline_inquiry | zápis | př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_conversation | zápis | pošle hostovi e-mailem odpověď jménem prostoru a přidá ji do konverzace. Jen s funkcí Zprávy |
start_conversation | zápis | napíše hlavnímu hostovi pobytu jako první a založí konverzaci, do které dorazí jeho odpověď. Jen s funkcí Zprávy |
update_conversation | zápis | uzavř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_code | správa | mě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_group | správa | vytvoří, 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ápis | weby 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_rule | správa | cena objektu za noc v sezóně a pevná cena nebo sleva pro konkrétní termín |
create_booking_widget, update_booking_widget | správa | založí 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áva | kam 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_import | správa | př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áva | adresy 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.