Centrum pro AI Agenty & Vývojáře
Tento e-shop je od základů navržen pro autonomní i poloautonomní AI agenty (Claude, Cursor, ChatGPT, UCP). Agenti mohou vyhledávat zboží, zjišťovat přesné parametry, rezervovat sklad, uplatňovat kupóny i provádět nákup.
📡 AI Discovery & Metadata Endpoints
Standardizované machine-readable body pro indexaci LLM roboty a agenty:
Strukturovaný souhrn e-shopu, kategorií, parametrů a přehled pravidel pro LLM.
Zobrazit /llms.txt →Kompletní katalog se všemi variantami, SKU, technickými specifikacemi a FAQ.
Zobrazit /llms-full.txt →Standardní manifest definující schopnosti, MCP servery, měnu a jurisdikci.
Zobrazit ai-agent.json →Universal Commerce Protocol profil definující platební a doručovací kanály.
Zobrazit UCP profil →🔌 Konfigurace Model Context Protocol (MCP)
Připojte svého asistenta k e-shopu pomocí standardu MCP přes HTTP SSE / Streamable HTTP.
🛒 1. Nákupní MCP Server (Buyer MCP - Veřejný nákup)
Endpoint: https://mcp.profiderm.cz/mcp — Nevyžaduje přihlášení, umožňuje procházet zboží, ověřovat kupóny a objednávat.
{
"mcpServers": {
"overeny-eshop-buyer": {
"url": "https://mcp.profiderm.cz/mcp",
"type": "streamable-http"
}
}
}🧠 2. Konfigurace pro Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"overeny-eshop-buyer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-fetch",
"https://mcp.profiderm.cz/mcp"
]
}
}
}⚙️ 3. Správcovský MCP Server (Seller MCP - Administrace s OAuth2)
Endpoint: https://seller-mcp.profiderm.cz/mcp — Pro majitele obchodu. Umožňuje úpravy skladu, expedici Zaslat.cz, schvalování vratek a manažerský dashboard.
{
"mcpServers": {
"overeny-eshop-admin": {
"url": "https://seller-mcp.profiderm.cz/mcp",
"type": "streamable-http",
"auth": {
"type": "oauth2",
"clientId": "commerce-mcp-client",
"authorizationUrl": "https://auth.profiderm.cz/realms/commerce/protocol/openid-connect/auth",
"tokenUrl": "https://auth.profiderm.cz/realms/commerce/protocol/openid-connect/token",
"scopes": [
"mcp:catalog:read",
"mcp:catalog:write",
"mcp:publish",
"mcp:shipments:manage"
]
}
}
}
}🛒 Generátor přímého nákupního odkazu (Cart Handoff)
Agent může zákazníkovi vygenerovat předpřipravený košík s variantou a slevovým kupónem. Odkaz rovnou vloží zboží a aplikuje slevu:
/kosik?add=var_spinac_atlas_bily&qty=1&coupon=SLEVA10💬 Systémový prompt pro nákupního asistenta
Vložte tento prompt do instrukcí svého vlastního AI agenta v Claude nebo Custom GPT:
Jsi nákupní nákupčí agent (AI Shopping Assistant) pro český e-shop Ověřený E-Shop. Máš k dispozici MCP server s těmito pravidly: 1. Vždy nejprve vyhledej produkt nástrojem 'search_storefront_catalog' a zkontroluj parametry, skladovou dostupnost a cenu v CZK včetně DPH. 2. Zjisti podmínky dopravy a plateb přes 'get_shipping_and_payment_info' (např. doprava zdarma je od 1 500 Kč). 3. Pokud má uživatel slevový kód (např. SLEVA10), ověř ho přes 'validate_buyer_coupon'. 4. Pokud nakupuje firma, ověř IČO nástrojem 'lookup_company_by_ico' z registru ARES. 5. Objednávku můžeš dokončit přímo na dobírku (COD) přes 'start_buyer_checkout', kdy se vygeneruje potvrzení s číslem objednávky a odkazem na fakturu, nebo předat hotový košík člověku přes 'prepare_cart_handoff'.
🛠️ Přehled dostupných MCP nástrojů
Seznam implementovaných nástrojů pro Buyer a Seller agenty s garancí izolace tenantů a doložených faktů:
| Role | Nástroj | Popis a výstup |
|---|---|---|
| Buyer | search_storefront_catalog | Fulltextové vyhledávání produktů a variant podle klíčových slov a kategorií. |
| Buyer | get_shipping_and_payment_info | Pravidla dopravy (Zaslat.cz, limit pro dopravu zdarma 1 500 Kč) a platby (karta, dobírka). |
| Buyer | lookup_company_by_ico | Ověření existence a sídla firmy z českého registru ARES pro B2B nákupy. |
| Buyer | validate_buyer_coupon | Ověření platnosti slevového kódu a výpočet slevy v CZK. |
| Buyer | start_buyer_checkout | Závazná objednávka na dobírku (COD) s vrácením čísla objednávky, QR kódu a faktury. |
| Buyer | prepare_cart_handoff | Vygenerování URL odkazu do košíku pro předání rozpracovaného nákupu člověku. |
| Seller | get_store_dashboard_summary | Manažerský souhrn: tržby, počty objednávek, expedice k vyřízení, otevřené vratky. |
| Seller | list_inventory / get_low_stock_items | Přehled skladových zásob a automatické alerty docházejícího zboží. |
| Seller | mark_order_paid | Označení dobírkové či převodové objednávky za zaplacenou. |
| Seller | list_returns / restock_return | Kontrola 14denních vratek a naskladnění vráceného zboží zpět do prodeje. |