2Slides Team
5 min read
Jak używać Gemini CLI z serwerem MCP 2Slides (przewodnik 2026)
Szybka odpowiedź (≤60 słów): Gemini CLI od Google potrafi generować prawdziwe pliki PowerPoint poprzez serwer MCP 2Slides. Zdobądź klucz na 2slides.com/api, a następnie dodaj wpis
mcpServersdo~/.gemini/settings.json—command: "npx",args: ["2slides-mcp"],env.API_KEYdla stdio lubhttpUrl: "https://2slides.com/api/mcp?apikey=KEY"dla Streamable HTTP. Albo uruchomgemini mcp add. Potem poproś Gemini o zbudowanie prezentacji.
Gemini CLI to otwartoźródłowy terminalowy agent AI od Google, który mówi w języku Model Context Protocol (MCP). Połącz go z serwerem MCP 2Slides, a Gemini zamieni prompt — albo plik w Twoim katalogu roboczym — w gotowy, edytowalny .pptx.
Ten przewodnik podaje dokładne bloki settings.json dla obu transportów (lokalnego stdio i zdalnego Streamable HTTP), skrót gemini mcp add oraz opis działania każdego narzędzia 2Slides.
Po co łączyć Gemini CLI z 2Slides?
Gemini to mocny multimodalny model rozumujący, ale samodzielnie nie generuje binarnych plików .pptx. Serwer MCP 2Slides jest wyspecjalizowanym generatorem:
- Gemini CLI czyta Twoje źródło, planuje slajdy i pisze treść.
- Serwer MCP 2Slides renderuje rzeczywisty PowerPoint — Fast PPT oparty na motywie albo slajdy obrazowe z opcjonalną narracją AI i pakietem do eksportu.
Czego potrzebujesz na początek
- Zainstalowanego Gemini CLI (
geminiw PATH). - Klucza API 2Slides z 2slides.com/api.
- Node.js dla transportu stdio (
npx -y 2slides-mcp@latest). Transport HTTP nie wymaga niczego lokalnie.
Stdio czy Streamable HTTP: który transport?
Oba udostępniają te same narzędzia; różnica polega na kluczu konfiguracji i tym, gdzie działa łącznik.
| Stdio (lokalnie) | Streamable HTTP (zdalnie) | |
|---|---|---|
| Klucz konfiguracji | command / args / env | httpUrl |
| Lokalny Node.js | Wymagany | Niewymagany |
| Najlepszy do | Lokalnego dev | Zdalnych/CI, minimalnych konfiguracji |
Nazwa klucza ma znaczenie: Gemini CLI używa
httpUrldla Streamable HTTP orazurldla starszego SSE. Dla endpointu Streamable HTTP 2Slides użyjhttpUrl.
Metoda 1: stdio w settings.json
Gemini CLI czyta ~/.gemini/settings.json (globalnie) oraz .gemini/settings.json (projekt). Dodaj blok mcpServers:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Wartości env mogą też odwoływać się do zmiennych powłoki (np. "API_KEY": "$TWOSLIDES_API_KEY"), jeśli wolisz nie wpisywać klucza na sztywno.
Metoda 2: Streamable HTTP w settings.json
Dla hostowanego endpointu użyj httpUrl:
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}Wolisz uwierzytelnianie nagłówkiem? Dodaj obiekt headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.
Albo użyj polecenia gemini mcp add
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"Te polecenia zapisują te same wpisy mcpServers do settings.json. Flagi obejmują -t, --transport (stdio | sse | http), -e, --env, -H, --header oraz --timeout.
Weryfikacja połączenia
W interaktywnej sesji gemini uruchom:
/mcpPokaże status każdego serwera (CONNECTED / CONNECTING / DISCONNECTED) oraz wykryte narzędzia. Użyj /mcp auth, jeśli serwer zdalny wymaga OAuth.
Wygeneruj swoją pierwszą prezentację
Po prostu poproś:
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.Gemini CLI uruchamia themes_search → slides_generate (Fast PPT) → zwraca downloadUrl. Dla niestandardowych slajdów projektowanych jako obrazy używa slides_create_pdf_slides i odpytuje jobs_get, aż prezentacja będzie gotowa.
Zestaw narzędzi MCP 2Slides
| Narzędzie | Co robi | Kredyty |
|---|---|---|
themes_search | Znajdź themeId dla Fast PPT | Bezpłatnie |
slides_generate | PowerPoint oparty na motywie (Fast PPT), synchronicznie/asynchronicznie | 10 / strona |
slides_create_pdf_slides | Niestandardowe slajdy obrazowe z tekstu (Nano Banana) | 100 / strona (1K/2K), 200 (4K) |
slides_create_like_this | Slajdy dopasowane do stylu obrazu referencyjnego | 100 / strona (1K/2K), 200 (4K) |
slides_generate_narration | Dodaj narrację głosową AI do zadania Nano Banana | 210 / strona |
slides_download_slides_pages_voices | Eksportuj strony + audio jako ZIP | Bezpłatnie |
jobs_get | Odpytuj zadanie asynchroniczne aż do zakończenia | Bezpłatnie |
Częste błędy i rozwiązywanie problemów
- Użyto
urldla endpointu Streamable HTTP. Gemini CLI traktujeurljako SSE. Dla Streamable HTTP 2Slides użyjhttpUrl. - Serwer pokazuje DISCONNECTED w
/mcp. Sprawdź klucz API, a dla stdio potwierdź, że Node.js jest zainstalowany. - Brak wyświetlonych narzędzi. Zrestartuj sesję po edycji
settings.jsonlub ponownie uruchomgemini mcp add. - Brak
.pptxbez narzędzia. Samo Gemini szkicuje konspekt; 2Slides tworzy plik. - Zbyt częste odpytywanie. Pozwól Gemini odpytywać
jobs_getmniej więcej co 20 sekund dla asynchronicznych zadań Nano Banana / narracji.
Najczęściej zadawane pytania
Czy Gemini CLI obsługuje serwery MCP?
Tak. Gemini CLI jest klientem MCP. Konfiguruj serwery pod mcpServers w ~/.gemini/settings.json albo dodawaj je poleceniem gemini mcp add. Obsługiwane są transporty stdio, SSE oraz Streamable HTTP.
Jaki jest klucz konfiguracji dla serwera Streamable HTTP?
httpUrl. Używaj url tylko dla starszych serwerów SSE. Endpoint Streamable HTTP 2Slides trafia do httpUrl.
Gdzie Gemini CLI przechowuje konfigurację MCP?
~/.gemini/settings.json (globalnie) albo .gemini/settings.json (projekt). Blok MCP to klucz najwyższego poziomu mcpServers.
Czy tworzy prawdziwy PowerPoint?
Tak — slides_generate zwraca edytowalny .pptx. Narzędzia Nano Banana zwracają prezentacje projektowane jako obrazy z opcjonalną narracją AI.
Skąd wziąć klucz i konfigurację?
Z 2slides.com/api?tab=mcp: Twój klucz, gotowa do skopiowania konfiguracja i adres URL endpointu Streamable HTTP.
Podsumowanie
Jeden wpis
mcpServers—commandlokalnie,httpUrlzdalnie — zamienia Gemini CLI w generator slajdów. Zweryfikuj przez/mcp, a potem po prostu poproś o prezentację.
Szerszy obraz znajdziesz w artykule jak MCP zmienia procesy pracy nad prezentacjami oraz w mapie ekosystemu serwerów MCP dla PowerPointa. Pracujesz w innym agencie terminalowym? Zobacz Claude Code, OpenAI Codex oraz Qwen Code z tym samym serwerem.
Zdobądź klucz i konfigurację na 2slides.com/api?tab=mcp i wygeneruj swoją pierwszą prezentację z Gemini CLI w niecałą minutę.
Źródła:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
