Podłącz klientów AI do swojego workspace

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,
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).

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 (zanfia, wersja 0.25.0) udostępnia pełną powierzchnię Workspace API jako 343 narzędzi, pogrupowanych poniżej według obszaru. Narzędzia odczytujące wymagają odpowiedniego scope'a *:read, zapisujące *:write. Strony, ustawienia witryny i sklep podlegają pod scope pages; społeczności, wydarzenia społeczności, członkowie/role/moderacja i zgłoszenia supportowe pod communities; social media pod social; cała reszta — produkty, oferty, kursy, media, klienci, zamówienia, kampanie, e-maile, statystyki, rabaty, zespół itd. — pod products. Klucz bez danego scope'a po prostu nie widzi jego narzędzi w tools/list.

Narzędzia destrukcyjne lub nieodwracalne mówią o tym wprost w swoich opisach i proszą asystenta o potwierdzenie z Tobą — usuwanie, odbieranie dostępu, operacje masowe na klientach, wszystko, co wysyła prawdziwe e-maile (kampanie, broadcasty do klientów, e-maile odzyskiwania koszyka, zaproszenia do zespołu, testy e-maili systemowych) oraz zmiany całej witryny, jak update-site-slug czy update-site-domains. Dobrze zachowujący się asystent zacytuje dokładny cel i poczeka na Twoją zgodę; kilka narzędzi (np. merge-clients, send-email-campaign, bulk-revoke-filtered-access) dodatkowo wymaga wcześniejszego podglądu lub policzenia zakresu, zanim zapis zostanie przyjęty. 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.

Członkowie społeczności

Ten sam adres akceptuje też klucze API członków społeczności (tworzone przez członka Twojej społeczności w platformie członkowskiej w Ustawienia → Deweloper). Klucz członkowski dostaje osobny, ograniczony zestaw narzędzi (serwer zanfia-member, 23 narzędzia) — MCP-owy odpowiednik Community API: listowanie swoich społeczności i kanałów, czytanie i wyszukiwanie postów, komentarzy i czatu, pisanie postów/komentarzy/wiadomości we własnym imieniu (tylko własne treści) oraz zakładanie i śledzenie własnych zgłoszeń supportowych. Żadne z powyższych narzędzi workspace nie jest dostępne dla kluczy członkowskich.

Narzędzia członkowskie do odczytu: list-my-communities · list-community-channels · list-channel-posts · search-community-posts · list-post-comments · list-channel-messages · get-community-updates · get-my-notifications · list-my-support-tickets · get-support-ticket. Narzędzia członkowskie do zapisu: create-community-post · update-community-post · delete-community-post · create-post-comment · update-post-comment · delete-post-comment · send-channel-message · edit-channel-message · delete-channel-message · mark-notifications-read · create-support-ticket · add-support-ticket-message · update-support-ticket-status.

Dla agentów obserwujących społeczność narzędzie get-community-updates (także GET /v1/communities/:communityId/updates?since=<ISO> w Community API) zwraca w jednym wywołaniu wszystko, co nowe — posty, komentarze i czat — we wszystkich kanałach dostępnych dla wywołującego: przekazuj zwrócone nextSince jako kolejne since, zamiast odpytywać każdy kanał osobno. Aby wiedzieć, kiedy ktoś mówi do Ciebie (odpowiedzi, wzmianki @, reakcje, DM), klucze członkowskie mają też get-my-notifications i mark-notifications-read — własną skrzynkę powiadomień członka, wspólną z dzwoneczkiem w platformie.

Żądania członkowskie podlegają limitom (na minutę, na członka — odpowiedź 429 zawiera Retry-After), a tworzenie treści przyjmuje UUID clientRequestId, dzięki czemu ponowienia nigdy nie duplikują posta, komentarza ani wiadomości.

Dostęp członkowski jest domyślnie wyłączony: działa tylko w społecznościach, w których twórca włączył dostęp API dla członków w ustawieniach społeczności, a wyłączenie ustawienia natychmiast blokuje już wydane klucze członkowskie.

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