Podłącz klientów AI do swojego workspace

Dodaj Zanfię jako serwer MCP w Claude, Cursorze lub dowolnym kliencie obsługującym MCP i pozwól mu czytać Twój workspace oraz nim zarządzać.

4 min czytaniaOstatnia aktualizacja: 9 lip 2026

Zanfia udostępnia hostowany serwer Model Context Protocol. Dodaj go do dowolnego klienta AI obsługującego MCP — Claude Code, Claude Desktop, Cursor, VS Code, Codex — a asystent dostanie typowane narzędzia do odczytu i działania w Twoim workspace: wylistuje produkty, napisze lekcje kursu, utworzy oferty, opublikuje post w Twojej społeczności, pobierze statystyki sprzedaży.

Podłącz mój workspace Zanfia jako serwer MCP. Zanfia = platforma do
sprzedaży produktów cyfrowych (kursy, społeczności, strony).

Zanim skonfigurujesz, pytaj mnie po jednym pytaniu i czekaj na
odpowiedzi:

1. Który klient? (opcje: "claude-code", "cursor", "vscode",
   "claude-desktop", "codex")
2. Mój klucz API Zanfia? (tworzę go w Dashboard → Integracje →
   API, MCP i CLI;
   scope'y tylko do odczytu do analiz, scope'y zapisu tylko jeśli
   asystent ma tworzyć treści)

Serwer: typ "http" (Streamable HTTP), URL https://app.zanfia.com/mcp
(endpoint beta), nagłówek "Authorization: Bearer <API_KEY>".

claude-code → uruchom:
  claude mcp add zanfia --transport http https://app.zanfia.com/mcp \
    --header "Authorization: Bearer <API_KEY>"
codex → dodaj do ~/.codex/config.toml (i wyeksportuj ZANFIA_API_KEY):
  [mcp_servers.zanfia]
  url = "https://app.zanfia.com/mcp"
  bearer_token_env_var = "ZANFIA_API_KEY"
inne klienty → dodaj do pliku konfiguracji MCP (JSON):
  { "mcpServers": { "zanfia": { "type": "http",
    "url": "https://app.zanfia.com/mcp",
    "headers": { "Authorization": "Bearer <API_KEY>" } } } }

Zweryfikuj, wywołując narzędzie list-products. Narzędzia podążają za
scope'ami klucza: *:read dla odczytów, *:write dla zapisów;
insufficient-scope = klucz nie ma tego uprawnienia. Lista narzędzi:
https://zanfia.com/help/developer-mcp/connect.md
Jeśli narzędzia czegoś nie pokrywają, pełny spec REST API jest pod
https://zanfia.com/openapi/workspace-api.json (dokumentacja:
https://zanfia.com/llms.txt).

Endpoint w wersji beta

W okresie beta serwer działa pod adresem https://app.zanfia.com/mcp (transport Streamable HTTP). URL produkcyjny zostanie ogłoszony przed ogólną dostępnością.

Uwierzytelnianie

Serwer uwierzytelnia się tymi samymi tokenami bearer co API: utwórz klucz API z odpowiednim zakresem uprawnień i wysyłaj go w nagłówku Authorization: Bearer. Dostęp do narzędzi podąża za scope'ami klucza — narzędzia odczytujące wymagają pasującego scope'a *:read, zapisujące *:write.

Dodaj serwer w swoim kliencie

Claude Code:

claude mcp add zanfia --transport http https://app.zanfia.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor / VS Code / Claude Desktop (konfiguracja MCP w JSON):

{
  "mcpServers": {
    "zanfia": {
      "type": "http",
      "url": "https://app.zanfia.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex (OpenAI Codex CLI) — dodaj do ~/.codex/config.toml (albo do projektowego .codex/config.toml), z kluczem API wyeksportowanym jako zmienna środowiskowa:

[mcp_servers.zanfia]
url = "https://app.zanfia.com/mcp"
bearer_token_env_var = "ZANFIA_API_KEY"

export ZANFIA_API_KEY="YOUR_API_KEY"

Wpisem możesz też zarządzać z terminala podkomendą codex mcp (codex mcp list, codex mcp add, …) zamiast ręcznie edytować TOML.

Dostępne narzędzia

Serwer udostępnia pełną powierzchnię Workspace API jako ~90 narzędzi. Narzędzia odczytujące wymagają odpowiedniego scope'a *:read, zapisujące *:write — produkty, oferty, kursy, media, klienci, zamówienia, statystyki i rabaty podlegają pod scope products; strony i społeczności pod własne.

Obszar	Narzędzia odczytujące	Narzędzia zapisujące
Produkty	`list-products`	`create-product` · `update-product-info` · `update-product-status`
Oferty i ceny	`list-checkouts` · `get-checkout` · `list-product-prices`	`create-checkout` · `update-checkout` · `publish-checkout` · `duplicate-checkout` · `set-default-checkout` · `add-checkout-price` · `update-checkout-price` · `delete-checkout-price` · `reorder-checkout-prices`
Order bumpy	`list-order-bumps`	`create-order-bump` · `update-order-bump` · `delete-order-bump` · `attach-order-bump` · `detach-order-bump`
Kursy i quizy	`get-course-content` · `get-course-lesson` · `list-quiz-questions`	`add-course-module` · `update-course-module` · `delete-course-module` · `add-course-lesson` · `update-course-lesson` · `update-lesson-content` · `delete-course-lesson` · `set-course-lessons-status` · `reorder-course-modules` · `reorder-module-lessons` · `add-quiz-question` · `update-quiz-question` · `delete-quiz-question` · `reorder-quiz-questions` · `update-quiz-settings`
Biblioteka mediów	`list-media` · `get-media` · `list-media-folders`	`delete-media` · `create-media-folder` · `delete-media-folder`
Strony	`list-pages` · `get-page`	`create-page` · `update-page` · `publish-page` · `delete-page` · `set-main-page`
Społeczności	`list-communities` · `list-community-channels` · `list-channel-posts` · `list-channel-messages` · `list-post-comments`	`create-community-post` · `create-post-comment` · `create-channel` · `update-channel` · `delete-channel` · `create-community-group` · `update-community-group` · `delete-community-group` · `move-community-node`
Klienci i zamówienia	`list-clients` · `get-client` · `list-orders` · `get-order`	`create-client` · `update-client` · `change-client-email` · `grant-client-access` · `revoke-client-access` · `change-client-access-period`
Statystyki	`get-stats-overview` · `get-recurring-report` · `get-mrr-history` · `get-funnel-report` · `get-traffic-report` · `get-sessions-report` · `get-product-stats`	—
Rabaty	`list-discounts`	`create-discount` · `update-discount` · `archive-discount` · `delete-discount`

Narzędzia destrukcyjne (usuwanie, odbieranie dostępu) mówią o tym wprost w swoich opisach, więc dobrze zachowujący się asystent zapyta przed ich użyciem. Przesyłanie plików i wideo celowo nie jest narzędziem MCP — binarne dane nie pasują do wywołań narzędzi; użyj CLI lub API do uploadu, a potem odwołuj się do id mediów z MCP.

Dopasuj zakres klucza do zadania

Asystent może zrobić wszystko, na co pozwala jego klucz. Asystentom, które tylko analizują i podsumowują, daj klucz tylko do odczytu (products:read, communities:read), a scope'y zapisu zarezerwuj dla asystentów, których pracę aktywnie nadzorujesz.

MCP, CLI czy surowe API?

MCP — najlepsze, gdy człowiek rozmawia z klientem AI i chce, by ten działał w workspace bezpośrednio.
CLI — najlepsze dla agentów terminalowych, skryptów i CI; to także droga do przesyłania plików i wideo, czego MCP celowo nie robi.
Surowe API — najlepsze dla Twoich własnych integracji i backendów.

Cała trójka to ta sama platforma z tym samym modelem uprawnień, więc możesz je swobodnie łączyć.

Czy ten artykuł był pomocny?

Powiązane artykuły

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