> ## 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.

# OpenAI Codex CLI

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

OpenAI Codex CLI łą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. Zapisz konfigurację MCP**

Zapisz plik z następnej sekcji w katalogu projektu.

**5. Uruchom agenta**

```bash theme={null}
codex
```

## Plik konfiguracji MCP

```toml .codex/config.toml theme={null}
[mcp_servers.itemshop]
url = "https://itemshop.dev/api/v2/mcp"
bearer_token_env_var = "ITEMSHOP_TOKEN"
```

Konfiguracja projektowa `.codex/config.toml` działa w projektach oznaczonych jako zaufane. Wolisz ustawienia globalne? Dopisz tę samą sekcję do `~/.codex/config.toml`. `bearer_token_env_var` wskazuje nazwę zmiennej, nie sam token.

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 codex
```

## Plik instrukcji

Panel generuje też `AGENTS.md` — plik, który OpenAI Codex CLI 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 `codex mcp list` — 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, wskazując katalog skilli tego agenta:

```bash theme={null}
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](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.