🤖 AI Agent Hub & MCP Server

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:

/llms.txtMarkdown

Strukturovaný souhrn e-shopu, kategorií, parametrů a přehled pravidel pro LLM.

Zobrazit /llms.txt →
/llms-full.txtKompletní katalog

Kompletní katalog se všemi variantami, SKU, technickými specifikacemi a FAQ.

Zobrazit /llms-full.txt →
/.well-known/ai-agent.jsonAgent Manifest

Standardní manifest definující schopnosti, MCP servery, měnu a jurisdikci.

Zobrazit ai-agent.json →
/.well-known/ucpUCP Protocol

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:

Vygenerovaná URL adresa:/kosik?add=var_spinac_atlas_bily&qty=1&coupon=SLEVA10
Otevřít v košíku →

💬 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ů:

RoleNástrojPopis a výstup
Buyersearch_storefront_catalogFulltextové vyhledávání produktů a variant podle klíčových slov a kategorií.
Buyerget_shipping_and_payment_infoPravidla dopravy (Zaslat.cz, limit pro dopravu zdarma 1 500 Kč) a platby (karta, dobírka).
Buyerlookup_company_by_icoOvěření existence a sídla firmy z českého registru ARES pro B2B nákupy.
Buyervalidate_buyer_couponOvěření platnosti slevového kódu a výpočet slevy v CZK.
Buyerstart_buyer_checkoutZávazná objednávka na dobírku (COD) s vrácením čísla objednávky, QR kódu a faktury.
Buyerprepare_cart_handoffVygenerování URL odkazu do košíku pro předání rozpracovaného nákupu člověku.
Sellerget_store_dashboard_summaryManažerský souhrn: tržby, počty objednávek, expedice k vyřízení, otevřené vratky.
Sellerlist_inventory / get_low_stock_itemsPřehled skladových zásob a automatické alerty docházejícího zboží.
Sellermark_order_paidOznačení dobírkové či převodové objednávky za zaplacenou.
Sellerlist_returns / restock_returnKontrola 14denních vratek a naskladnění vráceného zboží zpět do prodeje.