Claude Code

Podłącz Claude Code do sklepu przez hostowany serwer MCP: token, konfiguracja, plik instrukcji i pierwsza zmiana.

Claude Code łączy się z ItemShop przez serwer MCP (Streamable HTTP, nagłówek Authorization: Bearer). Dostaje narzędzia do plików strony, buildów, katalogu i — jeśli je włączysz — zamówień i rabatów. Wszystkie jego zmiany trafiają do szkicu w Workspace.

​

Krok po kroku

1. Utwórz token workspace

   W Workspace → MCP → Nowy token wybierz najmniejszy sensowny zestaw zakresów — zwykle site:write i catalog:read. Token (iswt_…) zobaczysz tylko raz. Zakresy opisuje strona AI Workspace.

2. Ustaw zmienną środowiskową

   Konfiguracja nigdy nie zawiera tokenu — odwołuje się do zmiennej ITEMSHOP_TOKEN.

   export ITEMSHOP_TOKEN=iswt_...
   
3. Pobierz projekt strony

   W pustym katalogu pobierz aktualny szkic (CLI):

   npx itemshop login --shop <id-sklepu>
   npx itemshop pull
   
4. Dodaj serwer MCP

   Jednym poleceniem:

   claude mcp add --transport http --scope project itemshop https://itemshop.dev/api/v2/mcp --header 'Authorization: Bearer ${ITEMSHOP_TOKEN}'
   

   albo zapisz plik z następnej sekcji.

5. Uruchom agenta

   claude
   

​

Plik konfiguracji MCP

.mcp.json

{
  "mcpServers": {
    "itemshop": {
      "type": "http",
      "url": "https://itemshop.dev/api/v2/mcp",
      "headers": { "Authorization": "Bearer ${ITEMSHOP_TOKEN}" }
    }
  }
}

type: "http" jest wymagane. Zmienna ${ITEMSHOP_TOKEN} jest rozwijana przez Claude Code przy starcie — token nie trafia do pliku, więc .mcp.json możesz commitować.

W Workspace → Agent wybierz ten sam agent, a panel pokaże gotowe polecenia, pliki i paczkę zip dla Twojego sklepu. Offline wygenerujesz je poleceniem:

npx itemshop mcp config --agent claude-code

​

Plik instrukcji

Panel generuje też CLAUDE.md — plik, który Claude Code czyta na starcie. Zawiera kontekst Twojego sklepu (nazwę, id, adres API i panelu), listę włączonych grup narzędzi MCP oraz zasady projektu: nie usuwaj itemshop.site.json, dane tylko przez SDK, kasa przez przekierowanie z dwiema zgodami, żadnych sekretów w kodzie, limity builda i plików, polityka publikacji. Skopiuj go do korzenia projektu.

​

Sprawdź połączenie

W agencie uruchom /mcp — serwer itemshop powinien być połączony. Możesz też kliknąć Testuj połączenie w Workspace → MCP. Pierwszą prośbę zacznij od czegoś bezpiecznego, np. „Pokaż kontekst sklepu i listę plików strony”. Wywołania narzędzi widać potem w logu MCP i na osi aktywności (źródło mcp).

​

Skille

Skille agentowe instalujesz poleceniem (domyślnie do .claude/skills/):

npx itemshop skills add itemshop-storefront itemshop-theme

​

Gdy coś nie działa

Objaw	Przyczyna
401 przy połączeniu	Zmienna ITEMSHOP_TOKEN jest pusta w środowisku agenta albo token został unieważniony.
Agent nie widzi narzędzi sklepu	Grupa jest wyłączona w Workspace → MCP albo token nie ma potrzebnego zakresu.
403 przy zapisie	Token ma tylko site:read, albo Twoje konto straciło uprawnienie site:write.
Zmiana nie trafia na produkcję	Produkcję zatwierdzasz sam — zobacz zasady publikacji.

Wszystkie agenty

Porównanie i wspólne zasady.

MCP

Narzędzia i zakresy.