storefront.js
Čeština
Přihlásit seZačít zdarma
Čeština

Pro vývojáře / MCP

Řiďte svůj obchod z libovolného AI asistenta.

Dva servery Model Context Protocol přinášejí storefront.js do Claude, Cursoru, VS Code a každého dalšího MCP klienta. Admin server pracuje s vaším obchodem v rámci oprávnění, která už máte; server obchodu umožní asistentovi procházet obchod a plnit košík. Seznam nástrojů na této stránce se načítá živě z běžících serverů.

Admin nástroje
Nástroje obchodu
Připojit klientaProcházet nástroje
Ukázková konverzace
Vy

Vraťte za objednávku 1042 celou částku. Dorazila poškozená.

get_orderJen čtenícanViewOrders
orderId: "1042"
refund_orderNevratnécanRefundOrders
orderId: "1042", refundedAmountMinor: "4800", refundedCurrency: "USD"
Asistent

Vráceno 48,00 USD na původní platební metodu. Objednávka 1042 je nyní vedená jako vrácená.

Připojení klienta

Vyberte server a zkopírujte nastavení pro svého klienta. Vzdálené servery vás přihlásí přes prohlížeč, takže není potřeba vkládat žádný token.

Terminál
claude mcp add --transport http storefront-admin https://mcp.storefrontjs.com/admin/mcp

Pak v Claude Code spusťte /mcp a vyberte server; přihlásíte se v prohlížeči.

Claude Desktop a claude.ai: otevřete Nastavení, pak Konektory, přidejte vlastní konektor a vložte adresu serveru.

Přihlášení a oprávnění

Admin server používá OAuth 2.1 s dynamickou registrací klientů. Celý průběh obstará váš klient; vy se jen přihlásíte a vyberete obchod.

Co se děje při připojení

  1. Klient si přečte metadata serveru a zjistí, kde se přihlásit.

    https://mcp.storefrontjs.com/.well-known/oauth-protected-resource

  2. Načte metadata autorizačního serveru: kde se registrovat, kde autorizovat a kde získat tokeny.

    https://api.storefrontjs.com/.well-known/oauth-authorization-server

  3. Zaregistruje se a otevře prohlížeč, kde se přihlásíte a vyberete, který obchod připojit.

  4. Vaše schválení vymění za token a posílá ho s každým požadavkem. S tokenem sami nikdy nepracujete.

Asistent nesmí víc než vy

  • Každý nástroj uvádí týmové oprávnění, které potřebuje. Pokud ho vaše role nemá, server volání odmítne, ať asistent žádá o cokoli.
  • Připojení se při každém volání ověřuje proti vašemu členství v týmu. Odeberte oprávnění v administraci a další volání bude odmítnuto.
  • Nástroje, které mění data, jsou tak označené, aby se vás klient mohl před spuštěním zeptat. Nevratné akce, jako vrácení peněz nebo mazání, mají vlastní označení.

Přehled nástrojů

Všechny nástroje obou serverů, seskupené podle toho, s čím pracují. Každá skupina je sada nástrojů: přidejte k adrese admin serveru ?toolsets= s jejím identifikátorem a připojí se jen tyto nástroje. Otevřete nástroj a uvidíte jeho úplný popis a argumenty.

Načítání seznamu nástrojů z MCP serverů…