SHOPZI: založení obchodu
Ceník SHOPZI, volné subdomény, založení nového e-shopu a hledání v dokumentaci. Bez klíče.
我該用這個嗎
品質與安全性
發現項目(2)
- LOW在 shopzi_list_plans 中
- LOW在 shopzi_check_subdomain 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"shopzi-platform": {
"url": "https://shopzi.cz/api/mcp"
}
}
}遠端端點
https://shopzi.cz/api/mcpstreamable-http它能做什麼
工具清單
工具(5)
🟢shopzi_list_plans
Vrátí placené tarify, které jde založit přes MCP, s cenou za měsíc i za rok v haléřích přímo ze Stripe a s limity tarifu. WEBZI s.r.o. není plátcem DPH, ceny jsou konečné. Obchod založený přes MCP má 30 dní zdarma stejně jako obchod z webu: kartu člověk uloží v prohlížeči při zakládání, nic se z ní nestrhne a první platba přijde 31. den.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"plan": {
"type": "string",
"enum": [
"start",
"growth",
"scale",
"pro"
],
"description": "Identifikátor tarifu pro `shopzi_create_store`."
},
"name": {
"type": "string",
"description": "Český název tarifu, jak ho zná ceník."
},
"intervals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"interval": {
"type": "string",
"enum": [
"monthly",
"annual"
]
},
"price_minor": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Cena za jedno období v haléřích, přímo ze Stripe (39000 = 390,00 Kč)."
},
"currency": {
"type": "string"
},
"period": {
"type": "string",
"description": "Za jaké období se platí, česky."
}
},
"required": [
"interval",
"price_minor",
"currency",
"period"
],
"additionalProperties": false
}
},
"limits": {
"type": "object",
"properties": {
"products": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"staff_seats": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"storage_mb": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"api_keys": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"feeds": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"ai_credits_monthly": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"email_sends_monthly": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"b2b_price_lists": {
"type": "boolean"
},
"custom_domain": {
"type": "boolean"
}
},
"required": [
"products",
"staff_seats",
"storage_mb",
"api_keys",
"feeds",
"ai_credits_monthly",
"email_sends_monthly",
"b2b_price_lists",
"custom_domain"
],
"additionalProperties": false
}
},
"required": [
"plan",
"name",
"intervals",
"limits"
],
"additionalProperties": false
}
},
"currency": {
"type": "string"
},
"vat_note": {
"type": "string"
},
"trial_note": {
"type": "string"
},
"prices_checked_at": {
"type": "string",
"description": "Kdy se ceny naposledy ověřily ve Stripe (ISO 8601)."
}
},
"required": [
"plans",
"currency",
"vat_note",
"trial_note",
"prices_checked_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢shopzi_check_subdomain(subdomain)
Ověří, jestli je subdoména pro nový obchod volná (`nazev.shopzi.cz`). Vrátí ano/ne, důvod a volné varianty odvozené z dotazu. Nikdy neprozradí, komu obsazená subdoména patří.
輸入結構描述
{
"type": "object",
"properties": {
"subdomain": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Požadovaná subdoména, například `cerstva-kava` pro cerstva-kava.shopzi.cz. Přípona `.shopzi.cz` se smí uvést."
}
},
"required": [
"subdomain"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"subdomain": {
"type": "string",
"description": "Subdoména po normalizaci, na kterou se odpověď vztahuje."
},
"available": {
"type": "boolean"
},
"reason": {
"type": "string",
"enum": [
"available",
"invalid_format",
"reserved",
"taken"
]
},
"message": {
"type": "string"
},
"suggestions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Volné varianty odvozené z dotazu. Prázdné, když je subdoména volná."
}
},
"required": [
"subdomain",
"available",
"reason",
"message",
"suggestions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡shopzi_create_store(shop_name, subdomain, plan, interval)
Založí KONCEPT nového obchodu a podrží pro něj subdoménu. Obchod ještě nevznikne: člověk otevře `draft_url` v prohlížeči, zadá `pairing_code`, ověří e-mail, přijme podmínky a uloží platební kartu; bez ní obchod nevznikne, 30 dní je zdarma a první platba přijde 31. den. Nástroj nic neúčtuje a neposílá žádný e-mail. Průběh sleduj nástrojem `shopzi_store_creation_status`. API klíč k novému obchodu se v terminálu nikdy neobjeví, ukáže se jednou v prohlížeči.
輸入結構描述
{
"type": "object",
"properties": {
"shop_name": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"description": "Název obchodu, jak ho uvidí zákazníci."
},
"subdomain": {
"type": "string",
"minLength": 3,
"maxLength": 80,
"description": "Subdoména obchodu. Ověř ji napřed nástrojem `shopzi_check_subdomain`."
},
"plan": {
"type": "string",
"enum": [
"start",
"growth",
"scale",
"pro"
],
"description": "Tarif z `shopzi_list_plans`. Přes MCP jde založit jen placený tarif."
},
"interval": {
"type": "string",
"enum": [
"monthly",
"annual"
],
"description": "Měsíční (`monthly`), nebo roční (`annual`) platba."
}
},
"required": [
"shop_name",
"subdomain",
"plan",
"interval"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"draft_url": {
"type": "string",
"description": "Odkaz, který člověk otevře v prohlížeči. Dokončí v něm e-mail, podmínky a platbu."
},
"status_token": {
"type": "string",
"description": "Token pro `shopzi_store_creation_status`. Není to API klíč a nic neotevírá."
},
"pairing_code": {
"type": "string",
"description": "Kód, který člověk zadá v prohlížeči. Ukaž mu ho, stránka ho sama nezobrazí."
},
"expires_at": {
"type": "string",
"description": "Kdy koncept vyprší, když se nedokončí (ISO 8601)."
},
"price_minor": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Cena tarifu za zvolenou periodu v haléřích. Teď se neplatí nic: prvních 30 dní je zdarma a tuhle částku Stripe vyfakturuje 31. den."
},
"currency": {
"type": "string"
},
"shop_name": {
"type": "string"
},
"subdomain": {
"type": "string"
},
"shop_url": {
"type": "string",
"description": "Adresa, na které obchod poběží po uložení platební karty."
},
"plan": {
"type": "string",
"enum": [
"start",
"growth",
"scale",
"pro"
]
},
"plan_name": {
"type": "string",
"description": "Český název tarifu z ceníku (`plan` je jen identifikátor). Pod tímhle názvem tarif zná člověk, který obchod zakládá."
},
"interval": {
"type": "string",
"enum": [
"monthly",
"annual"
]
},
"next_steps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"draft_url",
"status_token",
"pairing_code",
"expires_at",
"price_minor",
"currency",
"shop_name",
"subdomain",
"shop_url",
"plan",
"plan_name",
"interval",
"next_steps"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢shopzi_store_creation_status(status_token)
Řekne, kde zakládání obchodu je: čeká na prohlížeč, na platbu, zakládá se, je hotovo, nebo potřebuje podporu. Po dokončení vrátí adresu obchodu a přihlášení do administrace, nikdy klíč ani přihlašovací token.
輸入結構描述
{
"type": "object",
"properties": {
"status_token": {
"type": "string",
"minLength": 20,
"maxLength": 200,
"description": "`status_token` z výsledku `shopzi_create_store`."
}
},
"required": [
"status_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"waiting_for_browser",
"waiting_for_payment",
"paid_provisioning",
"ready",
"needs_support",
"expired"
]
},
"shop_name": {
"type": "string"
},
"subdomain": {
"type": "string"
},
"plan": {
"type": "string",
"enum": [
"start",
"growth",
"scale",
"pro"
]
},
"plan_name": {
"type": "string",
"description": "Český název tarifu z ceníku (`plan` je jen identifikátor). Pod tímhle názvem tarif zná člověk, který obchod zakládá."
},
"interval": {
"type": "string",
"enum": [
"monthly",
"annual"
]
},
"expires_at": {
"type": "string"
},
"shop_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Adresa obchodu, jakmile existuje. Jinak `null`."
},
"admin_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Přihlášení do administrace, jakmile obchod existuje. Obyčejná adresa, žádný token."
},
"message": {
"type": "string",
"description": "Co se právě děje a co má člověk udělat, česky."
}
},
"required": [
"status",
"shop_name",
"subdomain",
"plan",
"plan_name",
"interval",
"expires_at",
"shop_url",
"admin_url",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢shopzi_docs(mode, query, slug, section, docs, ...)
Hledá a čte oficiální českou dokumentaci SHOPZI, návody k administraci i dokumentaci pro vývojáře (fulltextově, zdarma). `mode: "search"` s `query` vrátí nejvýš 8 úryvků, `mode: "read"` se `slug` z hledání vrátí článek nebo jeho kapitolu. Použij ho, když se člověk ptá, jak se v SHOPZI něco dělá nebo jak se k obchodu připojit.
輸入結構描述
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"search",
"read"
],
"description": "search = najít v návodech (vyžaduje `query`); read = přečíst článek (vyžaduje `slug`)."
},
"query": {
"description": "Jen u `search`: otázka vlastními slovy.",
"type": "string",
"maxLength": 500
},
"slug": {
"description": "Jen u `read`: identifikátor článku z hledání.",
"type": "string",
"maxLength": 120
},
"section": {
"description": "Jen u `search`: zúží hledání na jednu sekci dokumentace.",
"type": "string",
"enum": [
"prehled",
"zaciname",
"produkty",
"objednavky",
"doprava-a-platby",
"marketing",
"vzhled",
"nastaveni",
"vyvojari"
]
},
"docs": {
"description": "Jen u `search`: `uzivatele` = návody k administraci, `vyvojari` = dokumentace pro vývojáře. Vynechané = obě.",
"type": "string",
"enum": [
"uzivatele",
"vyvojari"
]
},
"heading": {
"description": "Jen u `read`: název kapitoly (H2), když stačí její část. Neznámý název vrátí jen nadpisy.",
"type": "string",
"maxLength": 200
}
},
"required": [
"mode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"hits": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"section": {
"type": "string"
},
"title": {
"type": "string"
},
"heading_path": {
"type": "array",
"items": {
"type": "string"
}
},
"snippet": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"section",
"title",
"heading_path",
"snippet",
"url"
],
"additionalProperties": false
}
},
"article": {
"anyOf": [
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"section": {
"type": "string"
},
"title": {
"type": "string"
},
"markdown": {
"type": "string"
},
"headings": {
"type": "array",
"items": {
"type": "string"
}
},
"heading": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"slug",
"section",
"title",
"markdown",
"headings",
"heading",
"url",
"updated_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"suggestions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"slug",
"title"
],
"additionalProperties": false
}
},
"lexical_only": {
"type": "boolean"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"hits",
"article",
"suggestions",
"lexical_only",
"note"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據