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 (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. Uruchom agenta

   codex
   

​

Plik konfiguracji MCP

.codex/config.toml

[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:

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