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

# 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](https://andcze.mintlify.site/pl/site/agents.md). |
| **MCP** | Adres serwera MCP, test połączenia, przełączniki grup narzędzi, tokeny workspace i log wywołań. Zobacz [MCP](https://andcze.mintlify.site/pl/developers/mcp.md). |
| **Skille** | Katalog [skilli agentowych](https://andcze.mintlify.site/pl/developers/agent-skills.md): 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](https://andcze.mintlify.site/pl/site/custom-code.md)). |
| **Publikacje** | Buildy z logiem, podglądy i produkcja, promowanie i przywracanie, zasady publikacji. Zobacz [Build i hosting](https://andcze.mintlify.site/pl/site/build-hosting.md). |
| **Agent AI** | Czat z [wbudowanym agentem](https://andcze.mintlify.site/pl/site/ai-editor.md) 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ół](https://andcze.mintlify.site/pl/shop/team.md).

> **[Podłączanie agentów](https://andcze.mintlify.site/pl/site/agents.md)**
>
> Claude Code, Codex, OpenCode, Gemini CLI, Cursor.

> **[AI edytor](https://andcze.mintlify.site/pl/site/ai-editor.md)**
>
> Wbudowany agent ItemShop.


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