Suorigo Konfigurátor

Potisk triček a textilu na míru (ČR) — katalog, ceny, příprava designu a objednávky.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
86%
Integridad del esquema
94%
Calidad de los nombres
96%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (2)

  • LOWTool 'get_quote' description lacks action verben get_quote
  • LOWTool 'cancel_order' description lacks action verben cancel_order

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~4,248Tokens (definiciones de herramientas)
~2.2 KBTamaño de respuesta típico
Impacto significativo en la atención (3.32% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "server": {
      "url": "https://konfigurator.suorigo.cz/api/mcp"
    }
  }
}

Puntos de conexión remotos

https://konfigurator.suorigo.cz/api/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (10)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢list_products(product)

Vrátí katalog triček/mikin Suorigo (barvy, velikosti, ceny vč. množstevních slev) nebo jeden produkt podle id/slug.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "id nebo slug konkrétního produktu (volitelné)"
    }
  },
  "required": []
}
🟢get_quote(product, quantity, sizes, printedSides, printSideHeightsCm, ...)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string"
    },
    "quantity": {
      "type": "number"
    },
    "sizes": {
      "type": "object",
      "description": "mapování velikost→počet, např. {\"M\":10,\"L\":5}"
    },
    "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ě"
    },
    "promoCode": {
      "type": "string"
    }
  },
  "required": [
    "product"
  ]
}
🟡create_design(product, colorId, layers, previewFrontDataUrl, previewBackDataUrl)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string"
    },
    "colorId": {
      "type": "string"
    },
    "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?}"
    },
    "previewFrontDataUrl": {
      "type": "string"
    },
    "previewBackDataUrl": {
      "type": "string"
    }
  },
  "required": [
    "product",
    "layers"
  ]
}
🟢quote_order(items, shippingId, pickupPointId, pickupPointName, deliverySpeedId, ...)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string",
            "description": "id nebo slug produktu z list_products"
          },
          "colorId": {
            "type": "string"
          },
          "colorName": {
            "type": "string",
            "description": "název barvy"
          },
          "size": {
            "type": "string",
            "description": "velikost z katalogu, např. M"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1
          },
          "printMethod": {
            "type": "string"
          },
          "layers": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "vrstvy z create_design (určují příplatek za potisk)"
          }
        },
        "required": [
          "product",
          "size",
          "quantity"
        ]
      },
      "description": "položky objednávky (každá velikost/barva zvlášť)"
    },
    "shippingId": {
      "type": "string",
      "enum": [
        "zasilkovna",
        "balikovna",
        "ppl-vydejni",
        "dpd-vydejni",
        "ppl",
        "dpd",
        "osobni"
      ],
      "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)"
    },
    "pickupPointName": {
      "type": "string",
      "description": "název výdejního místa (volitelné, doplní se samo)"
    },
    "deliverySpeedId": {
      "type": "string",
      "enum": [
        "d7",
        "d14",
        "d30"
      ],
      "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)"
    },
    "promoCode": {
      "type": "string",
      "description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)"
    },
    "customer": {
      "type": "object",
      "description": "volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements"
    }
  },
  "required": [
    "items"
  ]
}
🟢find_pickup_points(shippingId, query, limit)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "shippingId": {
      "type": "string",
      "enum": [
        "zasilkovna",
        "balikovna",
        "ppl-vydejni",
        "dpd-vydejni"
      ]
    },
    "query": {
      "type": "string",
      "description": "město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "počet výsledků (výchozí 10)"
    }
  },
  "required": [
    "shippingId",
    "query"
  ]
}
🟢lookup_company(ico)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "ico": {
      "type": "string",
      "description": "IČO (7–8 číslic)"
    }
  },
  "required": [
    "ico"
  ]
}
🔴create_order(items, shippingId, pickupPointId, pickupPointName, deliverySpeedId, ...)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string",
            "description": "id nebo slug produktu z list_products"
          },
          "colorId": {
            "type": "string"
          },
          "colorName": {
            "type": "string",
            "description": "název barvy"
          },
          "size": {
            "type": "string",
            "description": "velikost z katalogu, např. M"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1
          },
          "printMethod": {
            "type": "string"
          },
          "layers": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "vrstvy z create_design (určují příplatek za potisk)"
          }
        },
        "required": [
          "product",
          "size",
          "quantity"
        ]
      },
      "description": "položky objednávky (každá velikost/barva zvlášť)"
    },
    "shippingId": {
      "type": "string",
      "enum": [
        "zasilkovna",
        "balikovna",
        "ppl-vydejni",
        "dpd-vydejni",
        "ppl",
        "dpd",
        "osobni"
      ],
      "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)"
    },
    "pickupPointName": {
      "type": "string",
      "description": "název výdejního místa (volitelné, doplní se samo)"
    },
    "deliverySpeedId": {
      "type": "string",
      "enum": [
        "d7",
        "d14",
        "d30"
      ],
      "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)"
    },
    "promoCode": {
      "type": "string",
      "description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)"
    },
    "customer": {
      "type": "object",
      "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á)",
      "properties": {
        "email": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "deliveryStreet": {
          "type": "string"
        },
        "deliveryCity": {
          "type": "string"
        },
        "deliveryZip": {
          "type": "string"
        },
        "companyName": {
          "type": "string"
        },
        "ico": {
          "type": "string"
        },
        "dic": {
          "type": "string"
        },
        "billingStreet": {
          "type": "string"
        },
        "billingCity": {
          "type": "string"
        },
        "billingZip": {
          "type": "string"
        },
        "billingCountry": {
          "type": "string"
        }
      },
      "required": [
        "email",
        "name"
      ]
    },
    "paymentMethod": {
      "type": "string",
      "enum": [
        "bank_transfer",
        "card"
      ],
      "description": "bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)"
    },
    "consent": {
      "type": "boolean",
      "description": "souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true"
    },
    "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"
    },
    "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"
    }
  },
  "required": [
    "items",
    "customer",
    "shippingId",
    "consent"
  ]
}
🟡get_payment_link(statusToken, orderNumber, email)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "statusToken": {
      "type": "string",
      "description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
    },
    "orderNumber": {
      "type": "string",
      "description": "číslo objednávky (9 číslic) — jen spolu s e-mailem"
    },
    "email": {
      "type": "string",
      "description": "e-mail zákazníka z objednávky — jen spolu s orderNumber"
    }
  },
  "required": []
}
🟢get_order_status(statusToken, orderNumber, email)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "statusToken": {
      "type": "string",
      "description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
    },
    "orderNumber": {
      "type": "string",
      "description": "číslo objednávky (9 číslic) — jen spolu s e-mailem"
    },
    "email": {
      "type": "string",
      "description": "e-mail zákazníka z objednávky — jen spolu s orderNumber"
    }
  },
  "required": []
}
🔴cancel_order(statusToken)

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 [email protected]). Jen se statusToken a jen na výslovný pokyn zákazníka.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "statusToken": {
      "type": "string",
      "description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
    }
  },
  "required": [
    "statusToken"
  ]
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada10 herramientas
verificadoversión no registrada10 herramientas
verificadoversión no registrada5 herramientas