Jak używać OpenAI Codex z serwerem MCP 2Slides (przewodnik 2026)

Szybka odpowiedź (≤60 słów): OpenAI Codex potrafi tworzyć prawdziwe pliki PowerPoint po dodaniu serwera MCP 2Slides do ~/.codex/config.toml. Zdobądź klucz na 2slides.com/api, a następnie dodaj blok [mcp_servers.2slides] uruchamiający npx -y 2slides-mcp@latest (stdio) lub blok url = "https://2slides.com/api/mcp?apikey=KEY" (Streamable HTTP). Albo uruchom codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Potem poproś Codex o zbudowanie prezentacji.

OpenAI Codex to otwartoźródłowy agent programistyczny CLI od OpenAI i jest klientem Model Context Protocol (MCP). Połącz go z serwerem MCP 2Slides, a Codex zamieni brief — albo plik w Twoim repozytorium — w gotowy, edytowalny .pptx, w całości z poziomu terminala.

Ten przewodnik podaje dokładne bloki config.toml dla obu transportów (lokalnego stdio i zdalnego Streamable HTTP), jednoliniowy skrót codex mcp add, opis działania każdego narzędzia 2Slides oraz pułapkę specyficzną dla wersji, na którą trzeba uważać przy serwerach HTTP.

Po co łączyć Codex z 2Slides?

Codex analizuje kod i treści; samodzielnie nie generuje binarnych plików slajdów. Serwer MCP 2Slides wypełnia tę lukę. Podział pracy:

• Codex czyta Twoje źródło (specyfikację, README, plik z danymi), planuje slajdy i decyduje o narracji.
• Serwer MCP 2Slides renderuje rzeczywisty PowerPoint — Fast PPT oparty na motywie albo slajdy obrazowe z opcjonalną narracją AI i pakietem materiałów do eksportu.

Pytasz po prostu zwykłym językiem; Codex wywołuje narzędzia; wraca link do pobrania.

Czego potrzebujesz na początek

1. Zainstalowanego Codex CLI (codex w PATH).
2. Klucza API 2Slides z 2slides.com/api — na tej stronie znajdziesz też konfigurację MCP oraz endpoint Streamable HTTP.
3. Node.js dla transportu stdio (uruchamia npx -y 2slides-mcp@latest). Transport HTTP nie wymaga niczego lokalnie.

Stdio czy Streamable HTTP: który transport?

Serwer MCP 2Slides oferuje oba. W każdym przypadku te same narzędzia — różnica polega na tym, gdzie działa łącznik.

Używaj stdio na swojej stacji roboczej; używaj Streamable HTTP, gdy Codex działa tam, gdzie nie możesz zainstalować Node.

Metoda 1: stdio w config.toml

Edytuj ~/.codex/config.toml i dodaj:

Opcjonalne pola, które Codex obsługuje dla serwerów stdio, to m.in. cwd, startup_timeout_sec (domyślnie 10 s) oraz tool_timeout_sec (domyślnie 60 s). Jeśli wolisz przekazać istniejącą zmienną środowiskową zamiast wpisywać klucz na sztywno, użyj env_vars = ["API_KEY"].

Albo użyj skrótu codex mcp add

Bez edycji pliku — to zapisuje blok za Ciebie:

Wszystko po -- to polecenie serwera. Uruchom codex mcp --help, aby zobaczyć pełną listę podpoleceń dla zainstalowanej wersji.

Metoda 2: Streamable HTTP w config.toml

Skieruj Codex na hostowany endpoint:

Jeśli wolisz uwierzytelnianie nagłówkiem zamiast klucza w zapytaniu, Codex obsługuje zmienną środowiskową z tokenem bearer oraz statyczne nagłówki:

Pułapka wersji (ważne): Codex kieruje serwery MCP HTTP przez swojego klienta MCP w Rust. Nowsze wersje konfigurują to automatycznie, ale niektóre starsze kompilacje zgłaszają błąd missing field command in mcp_servers, dopóki nie włączysz klienta eksperymentalnego. Jeśli Cię to spotka, dodaj:

Najpierw sprawdź codex --version — nowsze wydania mają to wbudowane, a flaga jest zmieniana na [features].rmcp_client. Pokaż ten blok tylko jako rozwiązanie awaryjne, jeśli Twoja wersja zgłosi problem.

Weryfikacja połączenia

Albo, w TUI Codex, uruchom /mcp, aby zobaczyć aktywne serwery i ich narzędzia. (Podpolecenia zarządzania codex mcp wciąż się rozwijają; codex mcp --help jest miarodajne dla Twojej kompilacji.)

Wygeneruj swoją pierwszą prezentację

Nie wywołujesz narzędzi ręcznie — po prostu prosisz:

Codex uruchamia themes_search, aby znaleźć themeId, następnie slides_generate (Fast PPT) i zwraca downloadUrl — prawdziwy PowerPoint w mniej więcej 30–60 sekund. Poproś o slajdy projektowane jako obrazy, a Codex przełączy się na slides_create_pdf_slides, odpytując jobs_get, aż plik będzie gotowy.

Zestaw narzędzi MCP 2Slides

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

• missing field command in mcp_servers przy serwerze HTTP. Twoja wersja Codex potrzebuje experimental_use_rmcp_client = true w sekcji [features]. Zaktualizuj Codex albo dodaj flagę.
• Nagłówki tabel TOML kontra tabele inline. [mcp_servers.2slides.env] to podtabela; jeśli wpiszesz ją inline, użyj env = { API_KEY = "..." } w linii serwera — nie mieszaj obu stylów.
• Nazwa serwera musi być unikalna. Każdy serwer jest identyfikowany przez segment [mcp_servers.NAME]; ponowne użycie nazwy nadpisuje wcześniejszy blok.
• Brak .pptx bez narzędzia. Sam Codex potrafi naszkicować konspekt, ale nie wygeneruje PowerPointa. Najpierw dodaj 2Slides.
• Przekroczenia limitu czasu przy dużych prezentacjach. Duże zadania lub zadania z narracją mogą przekroczyć domyślne tool_timeout_sec wynoszące 60 s; podnieś tę wartość lub pozwól Codeksowi odpytywać jobs_get dla zadań asynchronicznych.

Najczęściej zadawane pytania

Czy OpenAI Codex obsługuje serwery MCP?

Tak. Codex jest klientem MCP. Serwery konfigurujesz w ~/.codex/config.toml pod [mcp_servers.NAME] albo dodajesz je poleceniem codex mcp add. Obsługiwane są zarówno serwery stdio, jak i zdalne HTTP.

Gdzie Codex przechowuje konfigurację MCP?

W ~/.codex/config.toml (globalnie). Zaufane projekty mogą też używać lokalnego .codex/config.toml. Każdy serwer MCP to tabela [mcp_servers.NAME].

Stdio czy Streamable HTTP?

Stdio uruchamia npx -y 2slides-mcp@latest na Twojej maszynie i jest domyślne dla pracy lokalnej. Streamable HTTP kieruje na hostowany endpoint https://2slides.com/api/mcp i nie wymaga niczego zainstalowanego — idealne do CI i środowisk zdalnych. Te same narzędzia, ten sam wynik.

Czy tworzy prawdziwy PowerPoint?

Tak — slides_generate zwraca edytowalny .pptx. Narzędzia Nano Banana zwracają prezentacje projektowane jako obrazy i mogą dodać narrację AI oraz pakiet materiałów do eksportu.

Skąd wziąć klucz i konfigurację?

Z 2slides.com/api?tab=mcp: Twój klucz API, gotowa do skopiowania konfiguracja i adres URL endpointu Streamable HTTP.

Podsumowanie

Dodaj jeden blok [mcp_servers.2slides] do config.toml (lub uruchom codex mcp add), a Codex zyska narzędzie zamieniające dowolny brief w gotowy PowerPoint — bez opuszczania terminala.

Codex to mocny agent rozumujący; 2Slides to brakujący mu generator plików. Szerszy obraz znajdziesz w artykule jak MCP zmienia procesy pracy nad prezentacjami oraz w mapie ekosystemu serwerów MCP dla PowerPointa. Wolisz agenta od Anthropic? Zobacz jak używać Claude Code z serwerem MCP 2Slides.

Zdobądź klucz i dokładną konfigurację na 2slides.com/api?tab=mcp i wypuść swoją pierwszą prezentację wygenerowaną przez Codex jeszcze dziś.

Źródła:

• OpenAI Codex — Model Context Protocol (official docs)
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server