Dev okénko: Jak jsme do Circly přidali MCP server a proč teď půjčovnu ovládnete přímo z Claude nebo Cursoru

Když se mluví o umělé inteligenci ve firmách, většina lidí si pořád představí jen chatovací okno, kam zkopírují e-mail od zákazníka a nechají si vygenerovat odpověď. Jenže skutečná úspora času v půjčovně nastává až ve chvíli, kdy AI přestane jen radit a může za vás rovnou udělat práci v systému.
Představte si, že svému AI asistentovi v telefonu nebo počítači napíšete jednu větu a on sám zkontroluje v kalendáři volný vibrační pěch, načte firmu zákazníka z registru ARES, spočítá vratnou kauci a připraví hotovou smlouvu. Přesně proto jsem do Circly naprogramoval plnohodnotný MCP server (Model Context Protocol).
Dříve byla integrace jazykových modelů s firemním softwarem bolestivá. Pokud jste chtěli, aby asistent četl stav skladu nebo zakládal rezervace, museli jste pro každý nástroj psát vlastní API můstky a doufat, že si model nevymyslí neexistující parametry.
Protokol Model Context Protocol (MCP) od Anthropicu tenhle problém vyřešil jednou provždy:
- Jeden otevřený standard: Stejným protokolem dnes mluví Claude Desktop, vývojářský editor Cursor, Antigravity i automatizační nástroje jako n8n nebo Make.
- Samo-popisující nástroje (Self-describing Tools): Jakmile se agent připojí k našemu MCP endpointu, server mu automaticky pošle přesný katalog všech 17 funkcí včetně popisu každého parametru (přes schémata Zod). Agent tak dopředu ví, co ho čeká, jaká data má poslat a co dostane zpět.
- Přímá exekuce místo halucinací: Když se agenta zeptáte, jestli máte na víkend volný autopřepravník, nevymýšlí si odpověď z hlavy. Zavolá nástroj
list_equipment, přečte reálný stav skladu vaší půjčovny a odpoví podle skutečnosti.
MCP server v Circly není žádná oddělená hračka. Volá úplně stejné doménové služby jako naše webová administrace a dělí se do čtyř oblastí:
- Inventář a technika (7 nástrojů):
list_categories,create_category,list_equipment,get_equipment_detail,create_equipment,update_equipmentaadd_equipment_image_from_url(server sám stáhne fotku stroje z adresy URL, převede ji přes knihovnu Sharp do formátu WebP a uloží do galerie). - Zákazníci a ARES (3 nástroje):
search_customers,get_customer_detailacreate_customer(zadáte IČO a systém automaticky dotáhne název firmy, sídlo i DIČ ze státního registru ARES). - Výpůjčky a smlouvy (4 nástroje):
list_rentals,get_rental_detail,create_rental(včetně jednotného číslování dokladůVYP-2026-XXXXa kontroly kolizí v kalendáři) aupdate_rental_status. - Profil půjčovny (3 nástroje):
get_organization_profile,update_organization_profileaupload_organization_logo_from_url.
create_category a create_equipment založí celý sortiment a přes add_equipment_image_from_url k položkám rovnou nahraje fotky.Při návrhu MCP serveru jsem řešil především to, aby agent nikdy nemohl sáhnout na cizí data nebo udělat nepořádek v databázi:
- Žádné ID organizace v parametrech nástrojů: Žádný MCP nástroj nepřijímá
organizationIdod AI modelu. Identita vaší půjčovny je pevně svázaná s vaším přístupovým tokenemcircly_mcp_...přímo na serveru. Agent se fyzicky nemůže dotázat na data jiné firmy. - Osobní tokeny s okamžitým vypnutím: V sekci Nastavení → Model Context Protocol (MCP) si každý správce vygeneruje vlastní token a zkopíruje připravený SSE endpoint
https://www.circly.cz/api/mcp/sse?token=circly_mcp_.... Kdykoliv můžete přístup jedním přepínačem vypnout nebo token zneplatnit. - Ochrana proti podvrženým souborům (SSRF & Sharp): Když agent nahrává obrázek z externí URL adresy, backend zablokuje přístup do interních sítí a každý obrázek převede do čistého WebP souboru.
Vyberte svého AI klienta a zkopírujte si připravenou JSON konfiguraci pro připojení k MCP serveru.
Claude Desktop / Antigravity: Konfiguraci si zkopírujete jedním kliknutím přímo v administraci Circly na kartě Nastavení → MCP.
Zaregistrujte si půjčovnu na 30 dní zdarma, v nastavení si jedním klikem vygenerujte svůj MCP token a propojte Circly s Claude Desktop, Cursorem nebo vlastním agentem.
V nastavení na kartě MCP si vygenerujete token a rovnou zkopírujete hotový JSON pro Claude nebo Cursor.
Agent umí zakládat stroje, nahrávat fotky z URL, ověřovat firmy v ARESu a vystavovat smlouvy VYP-2026-XXXX.
Token je vázaný na váš účet a organizaci. Přístup AI asistentů můžete kdykoliv jedním přepínačem pozastavit.
Prvních 30 dní zdarma bez platební karty, poté od 590 Kč měsíčně.
Vyzkoušet na 30 dní zdarmaOdpovědi na technické i provozní otázky kolem napojení AI agentů: