Podłączanie agentów

Pracuj nad sklepem z Claude Code, Codex, OpenCode, Gemini CLI, Cursor i innymi agentami podłączonymi przez MCP.

Poza wbudowanym AI edytorem możesz używać agenta, którego znasz. ItemShop udostępnia hostowany serwer MCP — agent dostaje narzędzia do plików strony, buildów, produktów i rabatów, a wszystkie jego zmiany trafiają do szkicu w Workspace.

Parametr	Wartość
Adres	https://itemshop.dev/api/v2/mcp
Transport	Streamable HTTP (bezstanowy)
Uwierzytelnianie	Authorization: Bearer <token workspace> (iswt_…)
Zmienna środowiskowa	ITEMSHOP_TOKEN

​

Obsługiwani agenci

Claude Code

claude mcp add albo .mcp.json.

OpenAI Codex CLI

.codex/config.toml.

OpenCode

opencode.json.

Gemini CLI

gemini mcp add albo .gemini/settings.json.

Cursor

.cursor/mcp.json.

Wbudowany agent

W chmurze, bez instalacji.

Agent	Typ	Plik MCP	Plik instrukcji
Wbudowany agent ItemShop	w chmurze	—	—
Claude Code	terminal	.mcp.json	CLAUDE.md
OpenAI Codex CLI	terminal	.codex/config.toml	AGENTS.md
OpenCode	terminal	opencode.json	AGENTS.md
Gemini CLI	terminal	.gemini/settings.json	GEMINI.md
Cursor	edytor	.cursor/mcp.json	AGENTS.md
Windsurf	edytor	~/.codeium/windsurf/mcp_config.json (globalny, pole serverUrl)	AGENTS.md
Aider	terminal	brak natywnego MCP	CONVENTIONS.md
Inny klient MCP	—	.mcp.json jak w Claude Code	AGENTS.md

Windsurf: w Cascade → MCP → „Open MCP config file” wklej konfigurację (serverUrl + nagłówek Authorization: Bearer ${env:ITEMSHOP_TOKEN}); Windsurf musi widzieć zmienną ITEMSHOP_TOKEN.

Aider nie obsługuje MCP. Pracuje na plikach lokalnie: uruchom go z zasadami projektu (aider --read CONVENTIONS.md, a plik .aider.conf.yml z read: [CONVENTIONS.md] robi to za Ciebie) i wysyłaj zmiany przez npx itemshop deploy.

​

Podłączenie krok po kroku

1. Wybierz agenta

   Workspace → Agent → wybierz agenta z listy. Panel pokaże kroki, pliki i polecenia dla niego.

2. Utwórz token

   W Workspace → MCP (albo w zakładce Agent) utwórz token z potrzebnymi zakresami, np. site:write i catalog:read. Token zobaczysz tylko raz.

3. Skopiuj konfigurację

   Panel generuje gotową komendę lub plik w formacie Twojego agenta oraz plik instrukcji. Możesz też pobrać wszystko jako paczkę zip (konfiguracja, instrukcje, .env.itemshop.example i ITEMSHOP-SETUP.md).

4. Pobierz projekt i zacznij

   export ITEMSHOP_TOKEN=iswt_...
   npx itemshop login --shop <id-sklepu>
   npx itemshop pull
   

   Uruchom agenta w tym katalogu i opisz zadanie.

Token nigdy nie trafia do wygenerowanych plików. Każdy format odwołuje się do zmiennej ITEMSHOP_TOKEN składnią swojego narzędzia (${ITEMSHOP_TOKEN}, ${env:ITEMSHOP_TOKEN}, {env:ITEMSHOP_TOKEN}, bearer_token_env_var), więc pliki możesz commitować.

Konfigurację bez panelu wygeneruje też CLI:

npx itemshop mcp config --agent claude-code   # claude-code | codex | opencode | cursor | gemini

Po zalogowaniu (itemshop login) CLI pobiera konfigurację z Twojego workspace; bez logowania wypisuje wersję offline z domyślnym adresem MCP. --token <t> wstawia literalny token zamiast odwołania do zmiennej.

​

Bezpieczeństwo

• Agent widzi tylko narzędzia z grup, które włączyłeś w Workspace → MCP, i tylko w zakresie tokenu (odczyt lub zapis).
• Zamówienia są dostępne wyłącznie do odczytu i domyślnie wyłączone.
• Zmiany plików lądują w szkicu — na produkcję trafiają po Twoim zatwierdzeniu (chyba że zmienisz zasady publikacji).
• Każde wywołanie narzędzia jest widoczne w logu MCP i na osi aktywności. Token możesz unieważnić w każdej chwili, a przestaje działać także wtedy, gdy twórca straci uprawnienia.

MCP

Narzędzia, zakresy i most stdio.

Skille agentowe

Gotowa wiedza o ItemShop dla agenta.