Serwer MCP do karuzel w social mediach (Supaslides MCP)

Supaslides ma zdalny serwer MCP pod adresem https://supaslides.app/mcp (Streamable HTTP). Podłączony agent wyciągnie markę z adresu URL, wygeneruje karuzele, wyeksportuje pliki PNG, PDF lub MP4, udostępni karuzele i zaplanuje posty na Instagramie, Facebooku i X. Uwierzytelnia się osobistym kluczem API i jest w każdym planie, także darmowym.

Ta strona to opis techniczny: narzędzia, konfiguracje klientów, typowy ciąg wywołań, limity i bezpieczeństwo. Jeśli wolisz przewodnik zwykłym językiem z gotowymi promptami, przeczytaj jak tworzyć i planować karuzele z poziomu Claude lub ChatGPT. Skrócona konfiguracja jest w dokumentacji MCP.

Co robi serwer

Udostępnia całą pętlę Supaslides jako narzędzia. Marka powstaje ze strony internetowej (prawdziwe kolory, czcionki, logo i ton, ten sam proces co URL do karuzeli w aplikacji). Claude pisze każdą karuzelę w tonie tej marki i dobiera układ do każdego slajdu. Eksport renderuje te same komponenty, które widać w edytorze, a planowanie korzysta z tej samej kolejki publikacji co planer w aplikacji. Każde wywołanie działa jako właściciel klucza API, w ramach planu tego konta.

Narzędzia

Typowy ciąg wywołań

Rzadko wywołujesz je ręcznie. Agent czyta opisy narzędzi i łączy je sam, gdy poprosisz na przykład: „zrób karuzelę z acme.com i opublikuj ją w poniedziałek o 9:00”. W uproszczeniu ciąg wygląda tak:

create_brand       { url: "https://acme.com" }
  → brandId, colors, fonts, voice, starterIdeas
generate_carousel  { brandId, brief: "3 onboarding mistakes", slideCount: 7 }
  → carouselId, caption, slides, editorUrl
export_carousel    { carouselId, format: "video", combine: true }
  → jobId, status: "queued"
check_export       { jobId }
  → status: "done", downloadUrl
list_social_accounts { brandId }
  → socialAccountId (Instagram, Facebook Page, X)
schedule_carousel  { carouselId,
                     targets: [{ socialAccountId, format: "png-set" }],
                     scheduledFor: "2026-10-06T09:00:00-04:00" }
  → groupId, posts[].status: "scheduled"

Dwa szczegóły mają znaczenie. scheduledFor to czas w formacie ISO 8601 z przesunięciem strefy, więc podaj agentowi swoją strefę czasową. A każdy cel publikacji to konto plus format: png-set dla statycznej karuzeli, video-set dla animowanych filmów per slajd na Instagramie albo combined-video dla jednego pliku MP4.

Wgrywanie lokalnych zdjęć

Argumenty MCP to JSON, więc pliki binarne nimi nie przejdą. Klucz API siedzi w konfiguracji klienta, gdzie model go nie widzi, więc agent z samą ścieżką do pliku nie ma czym się uwierzytelnić. Tę lukę zamyka create_image_upload. Zwraca gotowe polecenie curl z linkiem, który sam się autoryzuje, działa tylko dla jednej marki i wygasa po 30 minutach:

create_image_upload { brandId }
  → { curl: "curl -sS -F file=@/ABSOLUTE/PATH/TO/IMAGE.jpg \"https://supaslides.app/api/public/images?ticket=...\"" }

curl -sS -F file=@/Users/me/photo.jpg \
  "https://supaslides.app/api/public/images?ticket=..."
  → { imageId }

Agent uruchamia polecenie w terminalu, więc działa to w klientach z dostępem do powłoki, jak Claude Code czy Cursor. Piszesz własny skrypt? Wyślij to samo żądanie multipart z kluczem API i jawnym identyfikatorem marki:

curl -F file=@photo.jpg -F brandId=YOUR_BRAND_ID \
  -H "Authorization: Bearer sk_YOUR_KEY" \
  https://supaslides.app/api/public/images

JPG, PNG lub WebP, najlepiej poniżej 4 MB. Zdjęcia, które są już w sieci, dodasz przez add_image z ich adresem URL.

Podłączanie klienta

Utwórz klucz w Ustawieniach, w sekcji Klucze API. Pokazuje się tylko raz. Potem dodaj serwer. Claude Code:

claude mcp add --transport http supaslides https://supaslides.app/mcp \
  --header "Authorization: Bearer sk_YOUR_KEY"

Cursor, w .cursor/mcp.json (projekt) albo ~/.cursor/mcp.json (globalnie):

{
  "mcpServers": {
    "supaslides": {
      "url": "https://supaslides.app/mcp",
      "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
    }
  }
}

Inne klienty, które wysyłają własne nagłówki, też powinny działać. Poniższe konfiguracje trzymają się schematów z dokumentacji każdego z nich. VS Code, w .vscode/mcp.json:

{
  "servers": {
    "supaslides": {
      "type": "http",
      "url": "https://supaslides.app/mcp",
      "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
    }
  }
}

Codex CLI od OpenAI, w ~/.codex/config.toml, z kluczem w zmiennej środowiskowej SUPASLIDES_API_KEY:

[mcp_servers.supaslides]
url = "https://supaslides.app/mcp"
bearer_token_env_var = "SUPASLIDES_API_KEY"
tool_timeout_sec = 180

Responses API od OpenAI, jako wpis w tablicy tools Twojego żądania. OpenAI nie przechowuje wartości nagłówków między żądaniami, więc wysyłaj klucz za każdym razem:

{
  "type": "mcp",
  "server_label": "supaslides",
  "server_url": "https://supaslides.app/mcp",
  "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
}

Jeszcze nieobsługiwane: własne konektory w claude.ai i aplikacjach Claude oraz aplikacja ChatGPT. Obie logują się przez OAuth, a serwer przyjmuje dziś tylko klucze API. OAuth jest w planach.

Limity i czasy oczekiwania

• Czas trwania. create_brand od 60 do 120 s, generate_carousel od 15 do 40 s, eksport PNG od 30 do 90 s. Eksport wideo trwa kilka minut, więc odpytuj check_export. Formaty statyczne w schedule_carousel renderują się, zanim wywołanie wróci (od 30 do 90 s).
• Limity czasu w klientach. Aktualne wersje Claude Code domyślnie czekają wystarczająco długo. Jeśli ustawiasz MCP_TOOL_TIMEOUT, trzymaj go na 180000 lub wyżej. Codex CLI ma domyślnie 60 sekund, stąd tool_timeout_sec = 180 powyżej.
• Limity planu. Takie same jak w aplikacji: marki (1, 3 lub 10), karuzele miesięcznie (3, 20 lub 80), rozmiar biblioteki zdjęć (10, 50 lub 200) i zaplanowane posty miesięcznie (0, 60 lub 200) w planach Free, Pro i Studio. Free eksportuje rozmiary Instagram i TikTok ze znakiem wodnym. Błąd mówi, który limit się wyczerpał. Zobacz cennik.
• Limity dzienne. Wyciąganie marek i generowanie mają dzienne limity na konto, niezależne od limitu miesięcznego, a linków do udostępnienia można utworzyć 200 dziennie.
• Pobieranie. Link do eksportu PNG działa 60 minut, a check_export wydaje świeży link ważny 10 minut. Pliki są usuwane po 48 godzinach.

Bezpieczeństwo

• Klucze API. Klucz to sk_ i 40 losowych znaków. Przechowujemy tylko jego skrót SHA-256, pełny klucz widzisz raz, a w Ustawieniach możesz go w każdej chwili odwołać, co odłącza wszystko, co z niego korzysta. Osobny klucz dla każdego klienta ułatwia odwoływanie.
• Model nigdy nie widzi klucza. Klucz siedzi w konfiguracji klienta jako nagłówek, a nie w rozmowie ani w argumentach narzędzi.
• Linki do wgrywania. Linki z create_image_upload są podpisane, działają dla jednej marki, pozwalają tylko wgrywać zdjęcia i wygasają po 30 minutach.
• Zakres konta. Każde wywołanie działa jako właściciel klucza i sięga tylko do marek, karuzel, zdjęć i podłączonych kont tego konta.
• Publiczne z założenia. Linki do udostępnienia to publiczne strony. revoke_share wyłącza link. Planowanie publikuje na prawdziwych kontach, więc rozważ zostawienie w kliencie zatwierdzania wywołań dla narzędzi do planowania.

Sposoby automatyzacji karuzel w porównaniu

Serwer MCP to jedna z trzech popularnych dróg. Każda pasuje do czego innego:

Praktyczna różnica: API do szablonów renderuje projekt, który już masz, a droga przez MCP robi też wyciąganie marki i pisanie. Jeśli Twój wygląd jest zamknięty w szablonie i potrzebujesz tylko skali, API do szablonów dobrze się sprawdzi. Jeśli chcesz, żeby agent przeszedł od adresu URL do opublikowanej karuzeli, do tego służy serwer MCP.

Wypróbuj

Nie masz konta? Zrób karuzelę bez rejestracji, potem załóż darmowe konto i utwórz klucz API. Konfiguracja w Claude Code to jedno polecenie.