Cursor

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

Cursor łą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. Zapisz konfigurację MCP

   Zapisz plik z następnej sekcji w katalogu projektu.

5. Włącz serwer w edytorze

   Otwórz projekt w Cursorze, przejdź do Settings → MCP i włącz serwer itemshop. Potem użyj agenta w panelu czatu.

​

Plik konfiguracji MCP

.cursor/mcp.json

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

Odwołanie do zmiennej ma składnię ${env:ITEMSHOP_TOKEN}. Cursor musi widzieć zmienną — uruchom go z terminala, w którym ją wyeksportowałeś (cursor .), albo ustaw ją w środowisku systemu i uruchom edytor ponownie.

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 cursor

​

Plik instrukcji

Panel generuje też AGENTS.md — plik, który Cursor 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

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, wskazując katalog skilli tego agenta:

npx itemshop skills add itemshop-storefront --dir <katalog-skilli-agenta>

​

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.