2Slides Logo
Как подключить OpenAI Codex к MCP-серверу 2Slides (руководство 2026)
2Slides Team
7 min read

Как подключить OpenAI Codex к MCP-серверу 2Slides (руководство 2026)

Краткий ответ (≤60 слов): OpenAI Codex умеет создавать настоящие файлы PowerPoint, если добавить MCP-сервер 2Slides в

~/.codex/config.toml
. Получите ключ на 2slides.com/api, затем добавьте блок
[mcp_servers.2slides]
, запускающий
npx 2slides-mcp
(stdio), или блок
url = "https://2slides.com/api/mcp?apikey=KEY"
(Streamable HTTP). Либо выполните
codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp
. Затем попросите Codex собрать презентацию.

OpenAI Codex — это кодинг-агент с открытым исходным кодом и интерфейсом командной строки от OpenAI, и он является клиентом Model Context Protocol (MCP). Подключите его к MCP-серверу 2Slides — и Codex сможет превращать бриф (или файл в вашем репозитории) в готовый редактируемый

.pptx
, прямо из терминала.

В этом руководстве даны точные блоки

config.toml
для обоих транспортов (локальный stdio и удалённый Streamable HTTP), однострочный сокращённый вариант
codex mcp add
, описание каждого инструмента 2Slides и специфичный для версий нюанс, на который стоит обратить внимание при работе с HTTP-серверами.

Зачем сочетать Codex с 2Slides?

Codex рассуждает о коде и контенте; сам по себе он не выдаёт бинарные файлы слайдов. MCP-сервер 2Slides закрывает этот пробел. Разделение труда:

  • Codex читает ваш исходник (спецификацию, README, файл данных), планирует слайды и выстраивает повествование.
  • MCP-сервер 2Slides рендерит сам PowerPoint — Fast PPT на основе темы или слайды с дизайном из изображений с опциональным озвучиванием ИИ-голосом и комплектом экспортируемых материалов.

Вы спрашиваете на обычном языке; Codex вызывает инструменты; в ответ приходит ссылка на скачивание.

Что понадобится в первую очередь

  1. Установленный Codex CLI (
    codex
    в вашем PATH).
  2. API-ключ 2Slides с 2slides.com/api — на той же странице есть конфигурация MCP и эндпоинт Streamable HTTP.
  3. Node.js для транспорта stdio (он запускает
    npx 2slides-mcp
    ). Транспорту HTTP ничего локального не нужно.

Stdio или Streamable HTTP: какой транспорт?

MCP-сервер 2Slides предлагает оба. Инструменты одни и те же в любом случае — разница в том, где запускается коннектор.

Протокол StdioПротокол Streamable HTTP
Где запускаетсяЛокально через
npx 2slides-mcp
Удалённо, на хостинге 2Slides
Локальный Node.jsТребуетсяНе требуется
Стиль конфигурации
command
+
args
+
env
url
(опционально
bearer_token_env_var
)
Лучше всего дляЛокальной разработки, полного контроляУдалённых/CI-машин, минималистичных установок

Используйте stdio на рабочей станции; используйте Streamable HTTP, когда Codex запускается там, где нельзя установить Node.

Способ 1: stdio в config.toml

Отредактируйте

~/.codex/config.toml
и добавьте:

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

Среди необязательных полей, которые Codex поддерживает для stdio-серверов:

cwd
,
startup_timeout_sec
(по умолчанию 10 с) и
tool_timeout_sec
(по умолчанию 60 с). Если вы предпочитаете прокинуть существующую переменную окружения, а не вписывать ключ напрямую, используйте
env_vars = ["API_KEY"]
.

Или воспользуйтесь сокращением
codex mcp add

Редактировать файл не нужно — эта команда сама запишет блок:

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

Всё, что идёт после

--
, — это команда сервера. Выполните
codex mcp --help
, чтобы увидеть полный список подкоманд для вашей установленной версии.

Способ 2: Streamable HTTP в config.toml

Направьте Codex на размещённый эндпоинт:

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

Если вы предпочитаете аутентификацию через заголовок вместо ключа в строке запроса, Codex поддерживает переменную окружения с bearer-токеном и статические заголовки:

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

Нюанс версии (важно): Codex маршрутизирует HTTP MCP-серверы через свой Rust-клиент MCP. Свежие версии настраивают это автоматически, но некоторые старые сборки выдают ошибку

missing field command in mcp_servers
, пока вы не включите экспериментальный клиент. Если столкнётесь с этим, добавьте:

[features] experimental_use_rmcp_client = true

Сначала проверьте

codex --version
— в новых релизах это уже встроено, а флаг переименовывается в
[features].rmcp_client
. Показывайте этот блок только как запасной вариант, если ваша версия жалуется.

Проверьте подключение

codex mcp list # список настроенных MCP-серверов codex mcp get 2slides

Либо в TUI Codex выполните

/mcp
, чтобы увидеть активные серверы и их инструменты. (Подкоманды управления
codex mcp
всё ещё развиваются;
codex mcp --help
авторитетен именно для вашей сборки.)

Сгенерируйте первую презентацию

Вы не вызываете инструменты вручную — вы просите:

Прочитай ./docs/launch-plan.md и сгенерируй презентацию о запуске из 10 слайдов. Используй современную тёмную бизнес-тему из 2slides. Когда будет готово, верни ссылку на скачивание.

Codex запускает

themes_search
, чтобы найти
themeId
, затем
slides_generate
(Fast PPT) и возвращает
downloadUrl
— настоящий PowerPoint примерно за 30–60 секунд. Попросите слайды с дизайном из изображений — и он переключится на
slides_create_pdf_slides
, опрашивая
jobs_get
, пока файл не будет готов.

Набор инструментов MCP-сервера 2Slides

ИнструментЧто делаетКредиты
themes_search
Находит
themeId
для Fast PPT
Бесплатно
slides_generate
PowerPoint на основе темы (Fast PPT), синхронно/асинхронно10 / страница
slides_create_pdf_slides
Кастомные слайды с дизайном из изображений по тексту (Nano Banana)100 / страница (1K/2K), 200 (4K)
slides_create_like_this
Слайды в стиле эталонного изображения100 / страница (1K/2K), 200 (4K)
slides_generate_narration
Добавляет озвучивание ИИ-голосом к задаче Nano Banana210 / страница
slides_download_pages_voices
Экспортирует страницы + аудио в ZIPБесплатно
jobs_get
Опрашивает асинхронную задачу до завершенияБесплатно

Частые ошибки и решение проблем

  • missing field command in mcp_servers
    на HTTP-сервере.
    Вашей версии Codex нужен
    experimental_use_rmcp_client = true
    в секции
    [features]
    . Обновите Codex или добавьте флаг.
  • Заголовки таблиц TOML против встроенных таблиц.
    [mcp_servers.2slides.env]
    — это подтаблица; если вы делаете её встроенной, пишите
    env = { API_KEY = "..." }
    в строке сервера — не смешивайте оба стиля.
  • Имя сервера должно быть уникальным. Каждый сервер ключуется сегментом
    [mcp_servers.NAME]
    ; повторное использование имени перезапишет более ранний блок.
  • Нет
    .pptx
    без инструмента.
    Codex сам по себе может набросать структуру, но не способен выдать PowerPoint. Сначала добавьте 2Slides.
  • Таймауты инструмента на больших презентациях. Крупные или озвученные задачи могут превысить дефолтные 60 с в
    tool_timeout_sec
    ; увеличьте значение или дайте Codex опрашивать
    jobs_get
    для асинхронных задач.

Часто задаваемые вопросы

Поддерживает ли OpenAI Codex MCP-серверы?

Да. Codex — MCP-клиент. Вы настраиваете серверы в

~/.codex/config.toml
под
[mcp_servers.NAME]
или добавляете их через
codex mcp add
. Поддерживаются и stdio-, и удалённые HTTP-серверы.

Где Codex хранит конфигурацию MCP?

В

~/.codex/config.toml
(глобально). Доверенные проекты также могут использовать локальный для проекта
.codex/config.toml
. Каждый MCP-сервер — это таблица
[mcp_servers.NAME]
.

Stdio или Streamable HTTP?

Stdio запускает

npx 2slides-mcp
на вашей машине и является вариантом по умолчанию для локальной работы. Streamable HTTP указывает на размещённый эндпоинт
https://2slides.com/api/mcp
и ничего не требует устанавливать — идеален для CI и удалённых сред. Инструменты те же, результат тот же.

Получается ли настоящий PowerPoint?

Да —

slides_generate
возвращает редактируемый
.pptx
. Инструменты Nano Banana возвращают слайды с дизайном из изображений и могут добавлять озвучивание ИИ-голосом плюс комплект экспортируемых материалов.

Где взять ключ и конфигурацию?

На 2slides.com/api?tab=mcp: ваш API-ключ, готовая к вставке конфигурация и URL эндпоинта Streamable HTTP.

Вывод

Добавьте один блок

[mcp_servers.2slides]
в
config.toml
(или выполните
codex mcp add
) — и Codex получает инструмент, который превращает любой бриф в готовый PowerPoint, не покидая терминал.

Codex — сильный агент-рассуждатель; 2Slides — это недостающий ему генератор файлов. Для общей картины см. как MCP меняет рабочие процессы презентаций и карту экосистемы PowerPoint MCP-серверов. Предпочитаете агента от Anthropic? См. как подключить Claude Code к MCP-серверу 2Slides.

Получите свой ключ и точную конфигурацию на 2slides.com/api?tab=mcp и выпустите первую презентацию, созданную через Codex, уже сегодня.

Источники:

About 2Slides

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

Try For Free