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 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest 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 .pptx — 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 .pptx 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 -y 2slides-mcp@latest). 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:

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 -y 2slides-mcp@latest).
• 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 .mcp.json (zakres projektu) wygląda tak — możesz go też edytować ręcznie:

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

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

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

Weryfikacja połączenia

Albo, w sesji interaktywnej, uruchom polecenie ukośnikowe /mcp, 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:

Za kulisami Claude Code uruchamia themes_search, aby znaleźć themeId, następnie slides_generate (Fast PPT) i podaje Ci downloadUrl. 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 (slides_create_pdf_slides), będzie odpytywać jobs_get, 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_slides_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 claude mcp add (transporty stdio, SSE lub HTTP), wyświetlasz je poleceniem claude mcp list i sprawdzasz w sesji przez /mcp. 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 npx -y 2slides-mcp@latest), 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 (slides_generate) zwraca edytowalny .pptx 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 --scope project, aby zapisać współdzielony .mcp.json, który zatwierdzisz w repozytorium. Członkowie zespołu zostaną poproszeni o jego zaakceptowanie przy pierwszym użyciu. Użyj --scope user 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