Dev okénkov1.12.0Dev okénko6 min čtení11. listopadu 2026

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

Implementovali jsme Model Context Protocol (MCP) přímo do Circly. Podívejte se, jak funguje dálkové ovládání skladu, zákazníků z ARESu a smluv přímo z AI agentů.
Martin AndrášiZakladatel Circly.cz
Propojení AI asistenta Claude a Cursor přes MCP server se skladem a smlouvami půjčovny v Circly
Rychlé shrnutí v kostce
Model Context Protocol (MCP) je otevřený standard, díky kterému se AI asistenti (Claude Desktop, Cursor, Antigravity nebo automatizace v n8n) bezpečně připojí přímo k vaší půjčovně v Circly. Agent má k dispozici 17 typovaných nástrojů s vlastní dokumentací – umí zkontrolovat volné stroje, ověřit firmu v ARESu podle IČO, nahrát fotky z webu nebo vystavit novou smlouvu VYP-2026-XXXX.

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).

Co je to MCP a proč funguje jako USB-C pro umělou inteligenci

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.
17 nástrojů napojených přímo na jádro Circly

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_equipment a add_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_detail a create_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-XXXX a kontroly kolizí v kalendáři) a update_rental_status.
  • Profil půjčovny (3 nástroje): get_organization_profile, update_organization_profile a upload_organization_logo_from_url.
Jak to využijete v praxi: od hlasového výdeje až po CRM a CMS
01. Rychlé odbavení smlouvy ze dvora
Stojíte u vrat, vydáváte techniku a nechcete běžet do kanceláře k počítači. Do mobilního asistenta napojeného na Circly napíšete nebo nadiktujete: „Založ výpůjčku pro firmu Stavby Brno s.r.o., IČO 28364821, na bourací kladivo Hilti od zítřka 8:00 do pátku 16:00, kauce 5 000 Kč.“ Agent ověří firmu v ARESu, pohlídá volný kus a připraví smlouvu k podpisu na pultovém tabletu.
02. Napojení na vaše firemní CRM nebo CMS na webu
Máte hlavní web na WordPressu nebo Webflow a poptávky řešíte v CRM systému? Nemusíte programovat složitou integraci. Agent ve vašem CRM nebo zákaznickém chatu se přes MCP přímo zeptá Circly na volnou kapacitu v kalendáři, odpoví zákazníkovi na dotaz ohledně ceny a kauce a rovnou zapíše rezervaci.
03. Přechod ze starého webu za 2 minuty
Když k nám přechází nová půjčovna přívěsů nebo nářadí, která má na starém webu třicet položek, dřív to znamenalo hodinu ručního přepisování. Dnes agentovi předáme adresu stávajícího webu – agent si projde ceník, přes create_category a create_equipment založí celý sortiment a přes add_equipment_image_from_url k položkám rovnou nahraje fotky.
Bezpečnost: Izolace dat půjčovny a osobní tokeny

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á organizationId od AI modelu. Identita vaší půjčovny je pevně svázaná s vaším přístupovým tokenem circly_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.
Ukázky konfigurace a zapojení

Vyberte svého AI klienta a zkopírujte si připravenou JSON konfiguraci pro připojení k MCP serveru.

7 řádků
1{
2 "mcpServers": {
3 "circly-moje-pujcovna": {
4 "url": "https://www.circly.cz/api/mcp/sse?token=circly_mcp_vas_pristupovy_token"
5 }
6 }
7}

Claude Desktop / Antigravity: Konfiguraci si zkopírujete jedním kliknutím přímo v administraci Circly na kartě Nastavení → MCP.

Vyzkoušejte si ovládání půjčovny přes AI v Circly

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.

01.
Zapnutí v administraci na 1 klik

V nastavení na kartě MCP si vygenerujete token a rovnou zkopírujete hotový JSON pro Claude nebo Cursor.

02.
17 typovaných nástrojů s ARESem

Agent umí zakládat stroje, nahrávat fotky z URL, ověřovat firmy v ARESu a vystavovat smlouvy VYP-2026-XXXX.

03.
Plná kontrola a okamžité odvolání tokenu

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í zdarma
Časté dotazy k MCP serveru v Circly

Odpovědi na technické i provozní otázky kolem napojení AI agentů: