> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://andcze.mintlify.site/pl/developers/mcp.md) (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](https://andcze.mintlify.site/pl/site/workspace.md).

## 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](https://andcze.mintlify.site/pl/site/workspace.md#token-workspace).

**2. Ustaw zmienną środowiskową**

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

```bash theme={null}
export ITEMSHOP_TOKEN=iswt_...
```

**3. Pobierz projekt strony**

W pustym katalogu pobierz aktualny szkic ([CLI](https://andcze.mintlify.site/pl/site/cli.md)):

```bash theme={null}
npx itemshop login --shop <id-sklepu>
npx itemshop pull
```

**4. Dodaj serwer MCP**

Jednym poleceniem:

```bash theme={null}
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**

```bash theme={null}
claude
```

## Plik konfiguracji MCP

```json .mcp.json theme={null}
{
  "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:

```bash theme={null}
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](https://andcze.mintlify.site/pl/developers/agent-skills.md) instalujesz poleceniem (domyślnie do `.claude/skills/`):

```bash theme={null}
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](https://andcze.mintlify.site/pl/site/workspace.md#zasady-publikacji). |

> **[Wszystkie agenty](https://andcze.mintlify.site/pl/site/agents.md)**
>
> Porównanie i wspólne zasady.

> **[MCP](https://andcze.mintlify.site/pl/developers/mcp.md)**
>
> Narzędzia i zakresy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.