Gemini CLI

Podłącz Gemini CLI do sklepu przez hostowany serwer MCP: token, konfiguracja, plik instrukcji i pierwsza zmiana.

Gemini 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. Dodaj serwer MCP

   Jednym poleceniem:

   gemini mcp add --transport http --scope project --header 'Authorization: Bearer ${ITEMSHOP_TOKEN}' itemshop https://itemshop.dev/api/v2/mcp
   

   albo zapisz plik z następnej sekcji.

5. Uruchom agenta

   gemini
   

​

Plik konfiguracji MCP

.gemini/settings.json

{
  "mcpServers": {
    "itemshop": {
      "httpUrl": "https://itemshop.dev/api/v2/mcp",
      "headers": { "Authorization": "Bearer ${ITEMSHOP_TOKEN}" }
    }
  }
}

Pole httpUrl oznacza transport Streamable HTTP (zwykłe url oznaczałoby SSE). Apostrofy wokół nagłówka chronią zmienną przed rozwinięciem przez powłokę — Gemini CLI rozwija ją sam.

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 gemini

​

Plik instrukcji

Panel generuje też GEMINI.md — plik, który Gemini 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 gemini 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.