

Как подключить OpenAI Codex к MCP-серверу 2Slides (руководство 2026)
Краткий ответ (≤60 слов): OpenAI Codex умеет создавать настоящие файлы PowerPoint, если добавить MCP-сервер 2Slides в
~/.codex/config.toml. Получите ключ на 2slides.com/api, затем добавьте блок[mcp_servers.2slides], запускающийnpx -y 2slides-mcp@latest(stdio), или блокurl = "https://2slides.com/api/mcp?apikey=KEY"(Streamable HTTP). Либо выполнитеcodex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Затем попросите 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 вызывает инструменты; в ответ приходит ссылка на скачивание.
Что понадобится в первую очередь
- Установленный Codex CLI (
codexв вашем PATH). - API-ключ 2Slides с 2slides.com/api — на той же странице есть конфигурация MCP и эндпоинт Streamable HTTP.
- Node.js для транспорта stdio (он запускает
npx -y 2slides-mcp@latest). Транспорту HTTP ничего локального не нужно.
Stdio или Streamable HTTP: какой транспорт?
MCP-сервер 2Slides предлагает оба. Инструменты одни и те же в любом случае — разница в том, где запускается коннектор.
| Протокол Stdio | Протокол Streamable HTTP | |
|---|---|---|
| Где запускается | Локально через npx -y 2slides-mcp@latest | Удалённо, на хостинге 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 = ["-y", "2slides-mcp@latest"]
[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 -y 2slides-mcp@latestВсё, что идёт после --, — это команда сервера. Выполните 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 Banana | 210 / страница |
slides_download_slides_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 -y 2slides-mcp@latest на вашей машине и является вариантом по умолчанию для локальной работы. 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