MCPサーバー
Suorigo Konfigurátor
cz.suorigo.konfigurator/server
このMCPでできること
Supports custom printed apparel purchases by listing products, creating designs, calculating quotes, finding pickup points, creating and managing orders, and providing payment links.
機能
ツール
10
ツール
cancel_order
Stornuje NEZAPLACENOU objednávku, která ještě není ve výrobě — stejně jako tlačítko na stránce stavu (zákazník dostane e-mail o stornu, otevřená platba kartou se zavře). Zaplacenou objednávku stornovat nejde (napiš na potisk@suorigo.cz). Jen se statusToken a jen na výslovný pokyn zákazníka.
破壊的操作あり
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['statusToken'], 'properties': {'statusToken': {'type': 'string', 'description': 'statusToken z create_order (poslední část statusUrl) — plný přístup'}}}
create_design
Zvaliduje a uloží design (logo/text na stranách trička): vrátí vrstvy s nahranými URL pro create_order, orientační příplatek za potisk a previewUrl — odkaz, kde zákazník uvidí návrh na tričku v konfigurátoru (a může ho tam i sám objednat).
入力スキーマ
{'type': 'object', 'required': ['product', 'layers'], 'properties': {'layers': {'type': 'array', 'items': {'type': 'object'}, 'description': "vrstvy: {type:'image'|'text', side:'front'|'back'|'sideLeft'|'sideRight', x,y,width,height v % 0–100, rotation?, src? (https URL nebo data:URL obrázku), text?, fontFamily?, fontSize?, fill?}"}, 'colorId': {'type': 'string'}, 'product': {'type': 'string'}, 'previewBackDataUrl': {'type': 'string'}, 'previewFrontDataUrl': {'type': 'string'}}}
create_order
Založí ZÁVAZNOU objednávku (čeká na platbu). paymentMethod 'bank_transfer' (výchozí) vrátí číslo účtu, variabilní symbol a QR; 'card' vrátí paymentUrl — zabezpečenou stránku Stripe pro tuto objednávku, kde zákazník sám zadá kartu (agent kartu nikdy nezadává ani nevidí; po zaplacení jede faktura a výroba stejně jako u objednávky z webu). Vždy vrátí statusUrl a statusToken (pro get_order_status, get_payment_link, cancel_order) a zákazníkovi pošle e-mail. Volej až po výslovném souhlasu zákazníka s položkami a cenou z quote_order. Povinné: skutečný e-mail (doména musí přijímat poštu, jinak 422), jméno a příjmení, shippingId (+ pickupPointId u výdejního místa, jinak adresa), consent:true; nad 10 000 Kč bez IČO fakturační adresa. Kartou nejméně 15 Kč. Nezaplacená karta propadne po 48 h, převod po 7 dnech. Limity: 3 objednávky / IP / den, 2 nezaplacené a 3 objednávky za 24 h na e-mail (429). Při opakování po timeoutu pošli stejný idempotencyKey.
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['items', 'customer', 'shippingId', 'consent'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['product', 'size', 'quantity'], 'properties': {'size': {'type': 'string', 'description': 'velikost z katalogu, např. M'}, 'layers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'vrstvy z create_design (určují příplatek za potisk)'}, 'colorId': {'type': 'string'}, 'product': {'type': 'string', 'description': 'id nebo slug produktu z list_products'}, 'quantity': {'type': 'integer', 'minimum': 1}, 'colorName': {'type': 'string', 'description': 'název barvy'}, 'printMethod': {'type': 'string'}}}, 'description': 'položky objednávky (každá velikost/barva zvlášť)'}, 'notes': {'type': 'string', 'maxLength': 1000, 'description': 'vzkaz zákazníka k objednávce (co má dílna vědět); uloží se k zakázce jako poznámka od zákazníka, delší text se ořízne'}, 'consent': {'type': 'boolean', 'description': 'souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true'}, 'customer': {'type': 'object', 'required': ['email', 'name'], 'properties': {'dic': {'type': 'string'}, 'ico': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'address': {'type': 'string'}, 'billingZip': {'type': 'string'}, 'billingCity': {'type': 'string'}, 'companyName': {'type': 'string'}, 'deliveryZip': {'type': 'string'}, 'deliveryCity': {'type': 'string'}, 'billingStreet': {'type': 'string'}, 'billingCountry': {'type': 'string'}, 'deliveryStreet': {'type': 'string'}}, 'description': 'zákazník: email (povinné, skutečná doména s poštou), name (povinné — jméno A příjmení, jde na daňový doklad), phone?, address? (doručovací adresa jedním řádkem u doručení na adresu) nebo deliveryStreet/deliveryCity/deliveryZip, firma: companyName?, ico? (doplní se z ARES), dic?, fakturační adresa billingStreet/billingCity/billingZip/billingCountry (nad 10 000 Kč bez IČO povinná)'}, 'promoCode': {'type': 'string', 'description': 'slevový kód; neplatný kód = chyba (nikdy tiše plná cena)'}, 'shippingId': {'enum': ['zasilkovna', 'balikovna', 'ppl-vydejni', 'dpd-vydejni', 'ppl', 'dpd', 'osobni'], 'type': 'string', 'description': 'doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká'}, 'paymentMethod': {'enum': ['bank_transfer', 'card'], 'type': 'string', 'description': 'bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)'}, 'pickupPointId': {'type': 'string', 'description': 'id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)'}, 'idempotencyKey': {'type': 'string', 'maxLength': 128, 'description': 'libovolný unikátní klíč této objednávky (např. UUID); opakované volání se stejným klíčem a obsahem vrátí stejnou objednávku (replayed:true, u karty tentýž platební odkaz), stejný klíč s jiným obsahem = 409'}, 'deliverySpeedId': {'enum': ['d7', 'd14', 'd30'], 'type': 'string', 'description': 'termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)'}, 'pickupPointName': {'type': 'string', 'description': 'název výdejního místa (volitelné, doplní se samo)'}}}
find_pickup_points
Vyhledá výdejní místa dopravce podle města, PSČ, ulice nebo názvu (Zásilkovna vč. Z-BOXů, Balíkovna, PPL ParcelShop, DPD Pickup). Vrácené `id` patří do create_order.pickupPointId.
読み取り専用
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['shippingId', 'query'], 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'počet výsledků (výchozí 10)'}, 'query': {'type': 'string', 'description': 'město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“'}, 'shippingId': {'enum': ['zasilkovna', 'balikovna', 'ppl-vydejni', 'dpd-vydejni'], 'type': 'string'}}}
get_order_status
Stav objednávky: platba (pending/paid/failed/refunded), výroba (new → shipped/delivered, cancelled), očekávaný termín. Se statusToken navíc statusUrl, faktura (PDF po zaplacení) a sledování zásilky. S orderNumber + email jen základní stav (čísla objednávek jsou předvídatelná). Neshoda = found:false.
読み取り専用
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': [], 'properties': {'email': {'type': 'string', 'description': 'e-mail zákazníka z objednávky — jen spolu s orderNumber'}, 'orderNumber': {'type': 'string', 'description': 'číslo objednávky (9 číslic) — jen spolu s e-mailem'}, 'statusToken': {'type': 'string', 'description': 'statusToken z create_order (poslední část statusUrl) — plný přístup'}}}
get_payment_link
Vrátí odkaz na zaplacení existující objednávky kartou (paymentUrl na Stripe) — když zákazník odkaz ztratil nebo vypršel (platí ~24 h). Stejná cesta jako tlačítko „Dokončit platbu kartou“ na webu: otevřenou platbu znovu použije, zaplacenou jen potvrdí, rozpracované ověření v bance nechá doběhnout. Jen pro objednávky kartou (převod má platební údaje v create_order). Autorizace: statusToken → vrátí paymentUrl; orderNumber + email → odkaz NEvrací, pošle ho zákazníkovi na e-mail z objednávky (max 1× / 15 min, 3× / den).
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': [], 'properties': {'email': {'type': 'string', 'description': 'e-mail zákazníka z objednávky — jen spolu s orderNumber'}, 'orderNumber': {'type': 'string', 'description': 'číslo objednávky (9 číslic) — jen spolu s e-mailem'}, 'statusToken': {'type': 'string', 'description': 'statusToken z create_order (poslední část statusUrl) — plný přístup'}}}
get_quote
Rychlý odhad ceny JEDNOHO produktu (vč. DPH) podle množství/velikostí a počtu potištěných stran. Přesnou cenu celé objednávky (doprava, kupón, termín) vrací quote_order.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['product'], 'properties': {'sizes': {'type': 'object', 'description': 'mapování velikost→počet, např. {"M":10,"L":5}'}, 'product': {'type': 'string'}, 'quantity': {'type': 'number'}, 'promoCode': {'type': 'string'}, 'printedSides': {'type': 'number', 'description': 'počet potištěných stran 0–4'}, 'printSideHeightsCm': {'type': 'array', 'items': {'type': 'number'}, 'description': 'výška motivu v cm na každé potištěné straně'}}}
list_products
Vrátí katalog triček/mikin Suorigo (barvy, velikosti, ceny vč. množstevních slev) nebo jeden produkt podle id/slug.
読み取り専用
入力スキーマ
{'type': 'object', 'required': [], 'properties': {'product': {'type': 'string', 'description': 'id nebo slug konkrétního produktu (volitelné)'}}}
lookup_company
Dohledá firmu podle IČO v ARES (název, DIČ, sídlo) — pro nákup na firmu. Vrací pole ve tvaru create_order.customer (companyName, ico, dic, billingStreet…).
読み取り専用
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['ico'], 'properties': {'ico': {'type': 'string', 'description': 'IČO (7–8 číslic)'}}}
quote_order
Přesná cena celé objednávky PŘED založením — stejný výpočet jako create_order (položky, doprava vč. dopravy zdarma od 1 500 Kč, kupón, termín výroby). Vrací totalVat, rozpis, dostupné termíny (deliverySpeeds), ceny dopravy a v `requirements` co ještě chybí k objednání. Nic neukládá.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['product', 'size', 'quantity'], 'properties': {'size': {'type': 'string', 'description': 'velikost z katalogu, např. M'}, 'layers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'vrstvy z create_design (určují příplatek za potisk)'}, 'colorId': {'type': 'string'}, 'product': {'type': 'string', 'description': 'id nebo slug produktu z list_products'}, 'quantity': {'type': 'integer', 'minimum': 1}, 'colorName': {'type': 'string', 'description': 'název barvy'}, 'printMethod': {'type': 'string'}}}, 'description': 'položky objednávky (každá velikost/barva zvlášť)'}, 'customer': {'type': 'object', 'description': 'volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements'}, 'promoCode': {'type': 'string', 'description': 'slevový kód; neplatný kód = chyba (nikdy tiše plná cena)'}, 'shippingId': {'enum': ['zasilkovna', 'balikovna', 'ppl-vydejni', 'dpd-vydejni', 'ppl', 'dpd', 'osobni'], 'type': 'string', 'description': 'doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká'}, 'pickupPointId': {'type': 'string', 'description': 'id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)'}, 'deliverySpeedId': {'enum': ['d7', 'd14', 'd30'], 'type': 'string', 'description': 'termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)'}, 'pickupPointName': {'type': 'string', 'description': 'název výdejního místa (volitelné, doplní se samo)'}}}
履歴
最近のツール変更
変更
create_order
2026年10月1日2:43
変更
quote_order
2026年10月1日2:43
追加
cancel_order
2026年9月25日2:50
変更
get_order_status
2026年9月25日2:50
追加
get_payment_link
2026年9月25日2:50
変更
create_order
2026年9月25日2:50
追加
lookup_company
2026年9月25日2:50
追加
find_pickup_points
2026年9月25日2:50
追加
quote_order
2026年9月25日2:50
変更
create_design
2026年9月25日2:50
変更
get_quote
2026年9月25日2:50
変更
get_order_status
2026年9月23日2:41
変更
create_order
2026年9月23日2:41
追加
get_order_status
2026年9月17日12:38
追加
create_order
2026年9月17日12:38
追加
create_design
2026年9月17日12:38
追加
get_quote
2026年9月17日12:38
追加
list_products
2026年9月17日12:38
関連MCP
類似のMCPサーバー
roastify-mcp
io.github.lonniev/roastify-mcp
Supports a coffee commerce workflow with product and blend catalogs, inventory, coupons, packaging design editing, artwork genera…
YouCam for Beauty & Personal Care
com.makeupar/beauty
Offers image-based beauty and personal-care analysis and virtual try-on tools for makeup, hair, facial features, body reshaping, …
agentee
art.allover/agentee
Searches and purchases all-over print apparel, manages carts, promotions, shipping, checkout, orders, and user-submitted designs.
mu
com.wearmu/mu
Supports AI-assisted print-on-demand product design, storefronts, manufacturing quotes, orders, fulfillment, shipping, sales, and…
studiomcphub
io.github.codex-curator/studiomcphub
Provides image enhancement, background removal, vectorization, color and print preparation, artwork search and analysis, product …
Capucine
fr.scorelook/capucine
Provides sourced personal styling guidance, weather-aware outfit recommendations, apparel shopping criteria, and links to verifie…
YouCam for Fashion & Retail
com.makeupar/fashion
Provides image-based virtual try-on experiences for clothing, accessories, jewelry, watches, makeup, fabric, hats, scarves, and s…
R3PLICA AI Connector
space.r3plica/catalog
Searches and presents premium design-brand products, collections, finishes, specifications, comparisons, images, and catalog link…