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

# 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](https://andcze.mintlify.site/pl/site/ai-editor.md) 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](https://andcze.mintlify.site/pl/site/workspace.md).

| 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](https://andcze.mintlify.site/pl/site/agents/claude-code.md)**
>
> `claude mcp add` albo `.mcp.json`.

> **[OpenAI Codex CLI](https://andcze.mintlify.site/pl/site/agents/codex.md)**
>
> `.codex/config.toml`.

> **[OpenCode](https://andcze.mintlify.site/pl/site/agents/opencode.md)**
>
> `opencode.json`.

> **[Gemini CLI](https://andcze.mintlify.site/pl/site/agents/gemini-cli.md)**
>
> `gemini mcp add` albo `.gemini/settings.json`.

> **[Cursor](https://andcze.mintlify.site/pl/site/agents/cursor.md)**
>
> `.cursor/mcp.json`.

> **[Wbudowany agent](https://andcze.mintlify.site/pl/site/ai-editor.md)**
>
> W chmurze, bez instalacji.

| Agent | Typ | Plik MCP | Plik instrukcji |
| - | - | - | - |
| Wbudowany agent ItemShop | w chmurze | — | — |
| [Claude Code](https://andcze.mintlify.site/pl/site/agents/claude-code.md) | terminal | `.mcp.json` | `CLAUDE.md` |
| [OpenAI Codex CLI](https://andcze.mintlify.site/pl/site/agents/codex.md) | terminal | `.codex/config.toml` | `AGENTS.md` |
| [OpenCode](https://andcze.mintlify.site/pl/site/agents/opencode.md) | terminal | `opencode.json` | `AGENTS.md` |
| [Gemini CLI](https://andcze.mintlify.site/pl/site/agents/gemini-cli.md) | terminal | `.gemini/settings.json` | `GEMINI.md` |
| [Cursor](https://andcze.mintlify.site/pl/site/agents/cursor.md) | 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**

```bash theme={null}
export ITEMSHOP_TOKEN=iswt_...
npx itemshop login --shop <id-sklepu>
npx itemshop pull
```

Uruchom agenta w tym katalogu i opisz zadanie.

> [!NOTE]
>
> **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:

```bash theme={null}
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](https://andcze.mintlify.site/pl/site/workspace.md#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](https://andcze.mintlify.site/pl/developers/mcp.md)**
>
> Narzędzia, zakresy i most stdio.

> **[Skille agentowe](https://andcze.mintlify.site/pl/developers/agent-skills.md)**
>
> Gotowa wiedza o ItemShop dla agenta.


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