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-ai", "chatgpt", "claude-code",
   "cursor", "vscode", "claude-desktop", "codex")
2. Tylko dla cursor / vscode / codex / claude-desktop-json: 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). claude-ai, chatgpt i claude-code
   używają OAuth: bez klucza, loguję się i zatwierdzam dostęp
   w przeglądarce.

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

claude-ai → Settings → Connectors → Add custom connector, URL
  https://app.zanfia.com/mcp, puste client ID/secret, Connect.
chatgpt → Settings → Connectors → Create (włączony Developer mode),
  URL https://app.zanfia.com/mcp, auth OAuth, dokończ logowanie.
claude-code → uruchom (OAuth, przy pierwszym użyciu otwiera przeglądarkę):
  claude mcp add zanfia --transport http https://app.zanfia.com/mcp
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

Dwie drogi, te same narzędzia:

• OAuth (claude.ai, ChatGPT, Claude Code i inne klienty z konektorami) — dodaj https://app.zanfia.com/mcp jako własny konektor (custom connector), a klient przeprowadzi Cię przez logowanie w przeglądarce: Zanfia pokaże ekran zgody (workspace, uprawnienia, aplikacja, która prosi o dostęp), zatwierdzasz i gotowe. Nie kopiujesz żadnego klucza. Serwer implementuje OAuth 2.1 z PKCE, dynamiczną rejestrację klientów i discovery metadanych, więc każdy zgodny ze specyfikacją klient MCP podłącza się bez konfiguracji.
• Klucz API (Cursor, VS Code, Codex, skrypty) — utwórz klucz API z odpowiednim zakresem i wysyłaj go w nagłówku Authorization: Bearer.

Dostęp do narzędzi w obu przypadkach podąża za nadanymi scope'ami — narzędzia odczytujące wymagają pasującego *:read, zapisujące *:write. Połączenie OAuth otrzymuje wszystkie scope'y, o które prosi aplikacja (domyślnie wszystkie) i pojawia się jako token z etykietą Konektor w Integracje → API, MCP i CLI; usuń go tam, aby odłączyć aplikację. Połączenie działa 90 dni, potem klient poprosi o ponowne logowanie.

Dodaj serwer w swoim kliencie

claude.ai / Claude Desktop (konektor): Settings → Connectors → Add custom connector, wklej https://app.zanfia.com/mcp, zostaw puste pola OAuth client ID i secret i kliknij Add. Kliknij Connect i zatwierdź dostęp na ekranie zgody Zanfii.

ChatGPT (konektor / Apps): Settings → Connectors → Create, wklej https://app.zanfia.com/mcp, uwierzytelnianie OAuth, i dokończ logowanie, gdy ChatGPT je otworzy. Własne konektory MCP wymagają włączonego trybu deweloperskiego w Twoim planie ChatGPT.

Claude Code (OAuth, bez klucza):

claude mcp add zanfia --transport http https://app.zanfia.com/mcp

Przy pierwszym użyciu Claude Code otworzy przeglądarkę z ekranem zgody. Z kluczem API zamiast tego:

Claude Code (klucz API):

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.35.0) udostępnia pełną powierzchnię Workspace API jako 416 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, osobiste e-maile do klientów przez send-client-email, broadcasty do klientów, e-maile odzyskiwania koszyka, zaproszenia do zespołu, testy e-maili systemowych), kampanie SMS (send-sms-campaign wysyła prawdziwe SMS-y, za które płacisz na swoim koncie u dostawcy SMS), masowe zmiany subskrypcji mailingu / SMS (zgoda marketingowa — zapisanie wymaga podania podstawy zgody), publikacja automatyzacji (publish-automation uruchamia automatyzację na żywo: od tej chwili prawdziwe e-maile, SMS-y i webhooki trafiają do prawdziwych klientów; zmiana opóźnienia lub treści e-maila w już opublikowanej automatyzacji także od razu działa na żywo), usunięcie tagu (delete-client-tag zdejmuje tag ze wszystkich klientów, a segmenty i automatyzacje, które z niego korzystają, nie są aktualizowane) 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ć.