AI Workspace

Centrum pracy nad stroną sklepu: stan strony, agenci AI, MCP, skille, zmiany i publikacje w jednym miejscu.

Workspace to sekcja panelu, w której pracujesz nad stroną sklepu — sam, z wbudowanym agentem ItemShop albo z własnym agentem AI (Claude Code, Codex, Cursor i inne). Każda zmiana, niezależnie od źródła, trafia do jednego szkicu i przechodzi tę samą drogę do publikacji.

​

Siedem zakładek

Zakładka	Co tam zrobisz
Przegląd	Stan strony: co jest na produkcji, ostatni build, ile zmian czeka w szkicu i od kogo, aktywny agent, ostatnie wywołanie MCP. Szybkie akcje (poproś AI o zmianę, podłącz agenta, wgraj stronę, nowy token MCP) i oś aktywności.
Agent	Wybór agenta, z którym pracujesz, i gotowa konfiguracja: kroki, plik MCP, plik instrukcji, paczka zip. Zobacz Podłączanie agentów.
MCP	Adres serwera MCP, test połączenia, przełączniki grup narzędzi, tokeny workspace i log wywołań. Zobacz MCP.
Skille	Katalog skilli agentowych: włącz, wyłącz, skopiuj polecenie instalacji.
Zmiany	Zmienione pliki szkicu z autorem i diffem; zatwierdź szkic jako rewizję, odrzuć wszystko albo cofnij pojedynczy plik; historia rewizji; przesyłanie zmian przez GitHub, CLI lub zip (Własny kod).
Publikacje	Buildy z logiem, podglądy i produkcja, promowanie i przywracanie, zasady publikacji. Zobacz Build i hosting.
Agent AI	Czat z wbudowanym agentem i podgląd strony na żywo obok (komputer / telefon), wybór modelu i licznik tokenów.

​

Token workspace

Agent łączy się z ItemShop tokenem workspace (prefiks iswt_). To klucz API sklepu z listą zakresów, tworzony w Workspace → MCP → Nowy token albo w zakładce Agent. Token widzisz tylko raz — potem możesz go jedynie unieważnić.

Zakres	Co pozwala
site:read	Odczyt plików, rewizji, buildów i wdrożeń strony.
site:write	Edycja plików, buildy i podglądy (obejmuje site:read).
catalog:read	Odczyt produktów, kategorii i serwerów.
catalog:write	Tworzenie i edycja produktów (obejmuje catalog:read).
orders:read	Odczyt zamówień.
discounts:write	Zarządzanie rabatami i voucherami.
stats:read	Odczyt statystyk.

Token nigdy nie ma więcej uprawnień niż Ty: jeśli stracisz uprawnienie albo dostęp do sklepu, tokeny utworzone przez Ciebie przestają działać. Konfigurację Workspace, tokeny i połączenie z GitHub zmienisz tylko w panelu — token nie wystawia innych tokenów ani nie podnosi własnych uprawnień.

​

Grupy narzędzi MCP

W Workspace → MCP ustawiasz dla każdej grupy sufit: Wył., Odczyt albo Zapis. Agent dostaje najmniejszy z dwóch poziomów: sufitu grupy i zakresów swojego tokenu.

Grupa	Domyślnie	Wymagany zakres (odczyt / zapis)
Pliki strony	zapis	site:read / site:write
Buildy i publikacje	zapis	site:read / site:write
Katalog produktów	odczyt	catalog:read / catalog:write
Zamówienia	wyłączone, tylko odczyt	orders:read
Rabaty i vouchery	wyłączone	discounts:write
Statystyki	odczyt, tylko odczyt	stats:read
Wygląd (site.config)	zapis	site:read / site:write

Zamówienia zawierają dane kupujących, więc grupa jest domyślnie wyłączona i nie ma trybu zapisu.

​

Zasady publikacji

W Workspace → Publikacje wybierasz, jak zmiany trafiają do graczy:

Ustawienie	Domyślnie	Działanie
Podgląd przy każdym commicie	włączone	Każda nowa rewizja dostaje build i adres podglądu.
Produkcja wymaga zatwierdzenia	włączone	Agenci (MCP, CLI, AI) nie promują na produkcję — robisz to Ty w panelu.
Auto-deploy z gałęzi git	wyłączone	Zielony build z połączonej gałęzi GitHub trafia od razu na produkcję. Wymaga wyłączenia zatwierdzania produkcji.

​

Oś aktywności

Każde działanie na stronie jest zapisywane ze źródłem i autorem. Wpisy przechowujemy 90 dni.

Źródło	Przykład
panel	Ręczna edycja pliku w panelu.
ai	Wbudowany agent zmienił src/App.tsx.
mcp	Claude Code przez MCP zaktualizował site.config.ts.
cli	itemshop deploy z komputera członka zespołu.
git	Synchronizacja z gałęzią GitHub.
upload	Wgrany plik zip.
system	Zdarzenie platformy, np. odłączenie repozytorium.

​

Kto ma dostęp

Workspace widzą członkowie zespołu z uprawnieniem site:read; zmieniać i publikować mogą osoby z site:write. Zobacz Zespół.

Podłączanie agentów

Claude Code, Codex, OpenCode, Gemini CLI, Cursor.

AI edytor

Wbudowany agent ItemShop.