Jak używać Claude Code z serwerem MCP 2Slides (przewodnik 2026)

Szybka odpowiedź (≤60 słów): Claude Code potrafi generować prawdziwe pliki PowerPoint po połączeniu z serwerem MCP 2Slides. Zdobądź klucz API na 2slides.com/api, a następnie uruchom

claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

dla lokalnego stdio lub

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY

dla zdalnego Streamable HTTP. Potem po prostu poproś Claude Code o zbudowanie prezentacji.

Claude Code to terminalowy agent programistyczny od Anthropic, który natywnie mówi w języku Model Context Protocol (MCP). Oznacza to, że możesz dać mu narzędzie zamieniające tekst w gotowy plik

— bez opuszczania powłoki. Tym narzędziem jest serwer MCP 2Slides: cienki łącznik, który udostępnia API 2Slides do generowania slajdów, motywów, narracji i eksportu jako narzędzia MCP, które Claude Code może wywoływać bezpośrednio.

Ten przewodnik pokazuje oba sposoby połączenia — lokalny stdio i zdalny Streamable HTTP — który wybrać, co robi każde narzędzie oraz dokładne prompty, które zamieniają jednoliniowe polecenie w gotowy do pobrania plik PowerPoint.

Po co w ogóle łączyć Claude Code z 2Slides?

Claude Code świetnie radzi sobie z analizą Twojego repozytorium, redagowaniem treści i budowaniem argumentacji. Samodzielnie nie potrafi jednak wygenerować prawdziwego, edytowalnego pliku

z kształtami, wykresami, motywami i notatkami prelegenta. To zadanie generowania plików — i należy ono do wyspecjalizowanego narzędzia.

Podział jest klarowny:

• Claude Code czyta materiał źródłowy (plik README, specyfikację, CSV, notatkę badawczą), analizuje go i decyduje, co trafia na każdy slajd.
• Serwer MCP 2Slides bierze ten plan i renderuje rzeczywisty plik PowerPoint — albo slajdy obrazowe z narracją głosową AI i eksportem do MP4.

Cały czas pozostajesz w terminalu. Zapytaj, poczekaj ~30–60 sekund, otrzymaj link do pobrania.

Czego potrzebujesz na początek

1. Zainstalowanego i uwierzytelnionego Claude Code (
   claude
   w PATH).
2. Klucza API 2Slides. Utwórz go na 2slides.com/api. Na tej samej stronie znajdziesz gotową do skopiowania konfigurację MCP oraz endpoint Streamable HTTP.
3. Node.js (dla transportu stdio, który lokalnie uruchamia
   npx 2slides-mcp
   ). Transport HTTP nie wymaga niczego lokalnie.

Stdio czy Streamable HTTP: który transport?

Serwer MCP 2Slides obsługuje dwa transporty. Oba udostępniają identyczny zestaw narzędzi; różnią się jedynie tym, gdzie działa łącznik.

Reguła kciuka: używaj stdio na własnej maszynie do codziennej pracy, a Streamable HTTP wtedy, gdy Claude Code działa tam, gdzie nie możesz zainstalować Node (zdalna maszyna, zadanie CI, zablokowany kontener).

Metoda 1: połączenie przez stdio (lokalnie)

Uruchom to raz. Separator

oddziela własne flagi Claude Code od polecenia, które uruchamia:

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

Kilka rzeczy wartych zapamiętania:

• Zachowaj
  --transport stdio
  (lub inną flagę) pomiędzy
  --env
  a nazwą serwera. Ponieważ
  --env
  przyjmuje wiele par
  KEY=value
  , umieszczenie nazwy zaraz po nim może sprawić, że CLI odczyta nazwę jako kolejną zmienną środowiskową.
• Wszystko po
  --
  jest przekazywane do serwera bez zmian (
  npx 2slides-mcp
  ).
• Dodaj
  --scope user
  , aby 2Slides było dostępne w każdym projekcie, lub
  --scope project
  , aby zapisać je w współdzielonym
  .mcp.json
  dla Twojego zespołu.

Powstały

(zakres projektu) wygląda tak — możesz go też edytować ręcznie:

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["2slides-mcp"],
      "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
    }
  }
}

Metoda 2: połączenie przez Streamable HTTP (zdalnie)

Bez lokalnej instalacji — wystarczy skierować Claude Code na hostowany endpoint:

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

Wolisz nie trzymać klucza w adresie URL? Wyślij go w nagłówku:

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

Weryfikacja połączenia

claude mcp list          # 2slides powinno się pojawić i połączyć
claude mcp get 2slides   # pokaż jego konfigurację i wykryte narzędzia

Albo, w sesji interaktywnej, uruchom polecenie ukośnikowe

, aby zobaczyć połączone serwery, liczbę narzędzi oraz (dla serwerów zdalnych) status uwierzytelniania.

Wygeneruj swoją pierwszą prezentację

Po połączeniu nie wywołujesz narzędzi ręcznie — po prostu prosisz. Claude Code automatycznie łączy narzędzia 2Slides w łańcuch:

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

Za kulisami Claude Code uruchamia

, aby znaleźć , następnie (Fast PPT) i podaje Ci . Całkowity czas: mniej więcej 30–60 sekund dla PowerPointa z motywem.

Chcesz zamiast szablonu niestandardowe slajdy projektowane jako obrazy? Poproś o to, a Claude Code użyje ścieżki Nano Banana (

), będzie odpytywać , aż prezentacja będzie gotowa, i zwróci link.

Zestaw narzędzi MCP 2Slides

Po połączeniu Claude Code widzi te narzędzia:

Trzy typowe łańcuchy:

• Fast PPT:
  themes_search
  →
  slides_generate
  (synchronicznie) → pobranie.
• Nano Banana:
  slides_create_pdf_slides
  (asynchronicznie) →
  jobs_get
  → pobranie.
• Materiały wideo z narracją: utwórz slajdy →
  jobs_get
  →
  slides_generate_narration
  →
  jobs_get
  →
  slides_download_pages_voices
  .

Częste błędy i rozwiązywanie problemów

• Serwer nie pojawia się w
  claude mcp list
  . Dla stdio sprawdź, czy kolejność
  --env
  /nazwa jest poprawna (zachowaj flagę między
  --env
  a nazwą). Dla HTTP ponownie sprawdź adres URL oraz to, czy klucz API jest ważny.
• Brak
  API_KEY
  . Serwer stdio potrzebuje zmiennej środowiskowej; serwer HTTP potrzebuje
  ?apikey=
  albo nagłówka
  Authorization
  . Nie pomyl tych dwóch.
• Prośba o
  .pptx
  bez narzędzia. Bez podłączonego 2Slides Claude Code potrafi napisać konspekt, ale nie wygeneruje prawdziwego PowerPointa. Najpierw podłącz serwer.
• Pominięcie motywu. Jeśli nie uruchomisz
  themes_search
  ani nie nazwiesz stylu, Fast PPT wybierze go za Ciebie. Określ go, aby kontrolować wygląd.
• Zbyt częste odpytywanie. Zadania asynchroniczne (Nano Banana, narracja) należy odpytywać przez
  jobs_get
  mniej więcej co 20 sekund, a nie w ciasnej pętli.

Najczęściej zadawane pytania

Czy Claude Code obsługuje serwery MCP natywnie?

Tak. Claude Code jest pełnoprawnym klientem MCP. Dodajesz serwery poleceniem

(transporty stdio, SSE lub HTTP), wyświetlasz je poleceniem i sprawdzasz w sesji przez . Serwer 2Slides działa ze wszystkimi tymi opcjami.

Stdio czy Streamable HTTP — którego użyć?

Używaj stdio na lokalnej maszynie (uruchamia ono za Ciebie

), a Streamable HTTP wszędzie tam, gdzie nie możesz lub nie chcesz instalować Node — CI, kontenery, serwery zdalne. Oba udostępniają te same narzędzia i dają identyczny wynik.

Czy to tworzy prawdziwy plik PowerPoint?

Tak. Ścieżka Fast PPT (

) zwraca edytowalny z prawdziwymi kształtami i motywami. Ścieżki Nano Banana zwracają prezentacje projektowane jako obrazy i mogą dodać narrację głosową AI oraz materiały do eksportu. To pliki, które możesz otworzyć, edytować i prezentować — nie zrzuty ekranu.

Skąd wziąć klucz API i konfigurację?

Z 2slides.com/api?tab=mcp. Ta strona pokazuje Twój klucz, gotową do wklejenia konfigurację stdio oraz adres URL endpointu Streamable HTTP.

Czy mogę udostępnić serwer 2Slides mojemu zespołowi?

Tak. Dodaj go z

, aby zapisać współdzielony , który zatwierdzisz w repozytorium. Członkowie zespołu zostaną poproszeni o jego zaakceptowanie przy pierwszym użyciu. Użyj dla prywatnej konfiguracji obejmującej wszystkie projekty.

Podsumowanie

Claude Code wykonuje myślenie; serwer MCP 2Slides tworzy plik. Połącz raz — stdio lokalnie, Streamable HTTP zdalnie — a „zrób mi prezentację" staje się jednym zdaniem w Twoim terminalu.

Jeśli żyjesz w Claude Code, to najszybsza droga od pomysłu (lub pliku w repozytorium) do gotowego, edytowalnego PowerPointa. Szersze spojrzenie na łączenie slajdów z agentami znajdziesz w artykule jak MCP zmienia procesy pracy nad prezentacjami oraz w pełnej mapie ekosystemu serwerów MCP dla PowerPointa. Korzystasz z aplikacji desktopowej zamiast CLI? Zobacz jak używać Claude MCP do generowania prezentacji.

Pobierz klucz i konfigurację na 2slides.com/api?tab=mcp i wygeneruj swoją pierwszą prezentację z terminala w niecałą minutę.

Źródła:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server