2Slides Logo
Jak używać OpenAI Codex z serwerem MCP 2Slides (przewodnik 2026)
2Slides Team
7 min read

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 2slides-mcp
(stdio) lub blok
url = "https://2slides.com/api/mcp?apikey=KEY"
(Streamable HTTP). Albo uruchom
codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp
. 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 2slides-mcp
    ). 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.

Protokół StdioProtokół Streamable HTTP
Gdzie działaLokalnie przez
npx 2slides-mcp
Zdalnie, hostowany przez 2Slides
Lokalny Node.jsWymaganyNiewymagany
Styl konfiguracji
command
+
args
+
env
url
(opcjonalnie
bearer_token_env_var
)
Najlepszy doLokalnego dev, pełnej kontroliMaszyn zdalnych/CI, minimalnych konfiguracji

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:

[mcp_servers.2slides] command = "npx" args = ["2slides-mcp"] [mcp_servers.2slides.env] API_KEY = "YOUR_2SLIDES_API_KEY"

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:

codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx 2slides-mcp

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:

[mcp_servers.2slides_remote] url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

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

[mcp_servers.2slides_remote] url = "https://2slides.com/api/mcp" bearer_token_env_var = "TWOSLIDES_TOKEN"

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:

[features] experimental_use_rmcp_client = true

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

codex mcp list # wyświetl skonfigurowane serwery MCP codex mcp get 2slides

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:

Read ./docs/launch-plan.md and generate a 10-slide launch deck. Use a modern, dark business theme from 2slides. Return the download link when it's done.

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

NarzędzieCo robiKredyty
themes_search
Znajdź
themeId
dla Fast PPT
Bezpłatnie
slides_generate
PowerPoint oparty na motywie (Fast PPT), synchronicznie/asynchronicznie10 / 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 referencyjnego100 / strona (1K/2K), 200 (4K)
slides_generate_narration
Dodaj narrację głosową AI do zadania Nano Banana210 / strona
slides_download_pages_voices
Eksportuj strony + audio jako ZIPBezpłatnie
jobs_get
Odpytuj zadanie asynchroniczne aż do zakończeniaBezpłatnie

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 2slides-mcp
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:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free