Używaj CLI z agentami AI

Daj Claude Code, Cursorowi lub dowolnemu agentowi AI z dostępem do terminala bezpieczny, ograniczony uprawnieniami dostęp do Twojego workspace Zanfii.

4 min czytaniaOstatnia aktualizacja: 9 lip 2026

CLI jest zaprojektowane tak, by mogły nim sterować agenty AI w takim samym stopniu jak ludzie: każda komenda ma tryb --json, błędy niosą maszynowo czytelne powody, a uwierzytelnianie działa ze zmiennej środowiskowej. Agent, który potrafi uruchamiać komendy w terminalu, może obsługiwać cały Twój workspace.

Jeśli Twój klient obsługuje MCP, wybierz MCP

Jeśli Twój klient AI mówi po MCP (Claude, Cursor, VS Code, ChatGPT), połączenie MCP jest bardziej bezpośrednią drogą — typowane narzędzia, bez potrzeby shella. Podejście z CLI opisane poniżej działa wszędzie indziej i jest właściwym wyborem dla skryptowanych pipeline'ów i CI.

Konfiguracja

Utwórz klucz API o ograniczonym zakresie

W panelu: Integracje → API, MCP i CLI → utwórz klucz wyłącznie z uprawnieniami, których agent potrzebuje (zobacz Uwierzytelnianie). Dla agenta pracującego nad treścią to zwykle odczyt/zapis Produktów; Społeczności dodaj tylko wtedy, gdy agent ma publikować posty.

Zainstaluj CLI tam, gdzie działa agent

npm install -g @zanfia-dev/cli
export ZANFIA_API_KEY=YOUR_SCOPED_KEY

Powiedz agentowi, jak z niego korzystać

Wklej instrukcje takie jak blok poniżej do konfiguracji swojego agenta (plik CLAUDE.md, reguły Cursora, system prompt, …).

Blok instrukcji dla Twojego agenta

## Dostęp do workspace Zanfia

Możesz obsługiwać mój workspace Zanfia za pomocą CLI `zanfia` (binarka beta: `zanfia-dev`).
Uwierzytelnianie jest już skonfigurowane przez ZANFIA_API_KEY.

- Zawsze przekazuj `--json` (przed podkomendą) i parsuj wyjście.
- Najpierw ustal id: `products list`, `offers list`, `communities list`.
- Lekcje kursów: `courses get <productId>` dla struktury; treść lekcji to
  Markdown; dla długich treści używaj `--content-file`; nowa treść zaczyna
  jako draft — publikuj jawnie przez `courses publish`.
- Kwoty są w jednostkach podrzędnych (1999 = 19.99).
- Komendy destrukcyjne (`courses lesson delete`, `courses module delete`,
  `pages delete`, `clients revoke`) są trwałe — najpierw potwierdź ze mną.
- Jeśli komenda kończy się błędem `insufficient-scope`, klucz API nie ma
  tego uprawnienia — powiedz mi o tym zamiast ponawiać.

Materiały (pobierz w razie wątpliwości):
- Indeks dokumentacji dla agentów: https://zanfia.com/llms.txt
- Dowolna strona dokumentacji jako surowy Markdown: dodaj `.md` do jej
  URL-a, np. https://zanfia.com/help/developer-cli/commands.md
- Spec OpenAPI Workspace API (wszystkie ścieżki + schematy):
  https://zanfia.com/openapi/workspace-api.json

Dostosuj reguły potwierdzania do własnej tolerancji ryzyka — scope'y klucza są twardą granicą, instrukcje są tą miękką.

Wzorce, które dobrze się sprawdzają

Pipeline'y treści — agent pisze szkice lekcji w plikach Markdown, potem courses lesson update … --content-file, a na końcu człowiek uruchamia courses publish.
Podsumowania społeczności — communities posts --json według harmonogramu, streszczenie i publikacja podsumowania przez communities post create.
Raporty sprzedaży — stats overview --period 7d --json przekazywane do tego, co generuje Twój poniedziałkowy raport.
Operacje masowe — wszystko, co powtarzalne, na id z komendy list; komendy reorder wymagające ścisłej permutacji sprawiają, że zmiany kolejności są bezpieczne w skryptach.

Czy ten artykuł był pomocny?

Powiązane artykuły

Coś się nie zgadza? Napisz do nas na support@zanfia.com.