2Slides Team
8 min read
Как подключить Claude Code к MCP-серверу 2Slides (руководство 2026)
Краткий ответ (≤60 слов): Claude Code умеет генерировать настоящие файлы PowerPoint, подключившись к MCP-серверу 2Slides. Получите API-ключ на 2slides.com/api, затем выполните
claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latestдля локального stdio илиclaude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEYдля удалённого Streamable HTTP. После этого просто попросите Claude Code собрать презентацию.
Claude Code — это терминальный кодинг-агент от Anthropic, и он изначально «говорит» на языке Model Context Protocol (MCP). Это значит, что вы можете дать ему инструмент, который превращает текст в готовый файл .pptx, не покидая оболочку. MCP-сервер 2Slides и есть этот инструмент: тонкий коннектор, который предоставляет API 2Slides для генерации слайдов, оформления, озвучивания и экспорта в виде MCP-инструментов, вызываемых Claude Code напрямую.
В этом руководстве показаны оба способа подключения — локальный stdio и удалённый Streamable HTTP, — какой из них выбрать, что делает каждый инструмент и какие именно запросы превращают однострочную просьбу в скачиваемый PowerPoint.
Зачем вообще подключать Claude Code к 2Slides?
Claude Code прекрасно справляется с рассуждениями по вашему репозиторию, составлением текста и выстраиванием аргументации. Чего он не может сам по себе — так это выдать настоящий редактируемый .pptx с фигурами, диаграммами, темами и заметками докладчика. Это задача генерации файлов, и решать её должен специализированный инструмент.
Разделение чёткое:
- Claude Code читает ваш исходный материал (README, спецификацию, CSV, исследовательскую заметку), осмысливает его и решает, что попадёт на каждый слайд.
- MCP-сервер 2Slides берёт этот план и рендерит реальный файл PowerPoint — или слайды на основе изображений с озвучиванием ИИ-голосом и экспортом в MP4.
Вы всё время остаётесь в терминале. Спросили, подождали ~30–60 секунд — получили ссылку на скачивание.
Что понадобится в первую очередь
- Установленный и авторизованный Claude Code (
claudeв вашем 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 локально | Да | Нет |
| Настройка | Добавить stdio-сервер + переменную API_KEY | Добавить один URL с ?apikey= |
| Лучше всего для | Локальной разработки, офлайн-сценариев, полного контроля | Контейнеров, CI, тонких клиентов, отсутствия локальных зависимостей |
| Аутентификация | Переменная окружения API_KEY | API-ключ в запросе URL (или заголовок Authorization) |
Эмпирическое правило: используйте stdio на собственной машине для повседневной работы, а Streamable HTTP — когда Claude Code запускается там, где нельзя установить Node (удалённая машина, CI-задача, изолированный контейнер).
Способ 1: подключение через stdio (локально)
Выполните это один раз. Разделитель -- отделяет собственные флаги Claude Code от запускаемой им команды:
claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latestНесколько важных моментов:
- Держите
--transport stdio(или другой флаг) между--envи именем сервера. Поскольку--envпринимает несколько парKEY=value, размещение имени сразу после него может заставить CLI воспринять имя как ещё одну переменную окружения. - Всё, что идёт после
--, передаётся серверу без изменений (npx -y 2slides-mcp@latest). - Добавьте
--scope user, чтобы 2Slides был доступен во всех проектах, или--scope project, чтобы зафиксировать его в общем.mcp.jsonдля вашей команды.
Итоговый .mcp.json (область проекта) выглядит так — его также можно отредактировать вручную:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Способ 2: подключение через Streamable HTTP (удалённо)
Никакой локальной установки — просто направьте Claude Code на размещённый эндпоинт:
claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEYПредпочитаете не держать ключ в URL? Передайте его в заголовке:
claude mcp add --transport http 2slides https://2slides.com/api/mcp \
--header "Authorization: Bearer YOUR_2SLIDES_API_KEY"Проверьте подключение
claude mcp list # 2slides должен появиться и подключиться
claude mcp get 2slides # показать конфигурацию и обнаруженные инструментыЛибо в интерактивной сессии выполните слэш-команду /mcp, чтобы увидеть подключённые серверы, количество инструментов и (для удалённых серверов) статус аутентификации.
Сгенерируйте первую презентацию
После подключения вы не вызываете инструменты вручную — вы просто просите. Claude Code сам выстраивает цепочку инструментов 2Slides:
Найди в темах 2slides аккуратный стиль "business", затем
сгенерируй презентацию из 7 слайдов с представлением нашей дорожной
карты на Q3. Возьми содержимое из ./ROADMAP.md. Верни ссылку на скачивание.За кулисами Claude Code запускает themes_search, чтобы найти themeId, затем slides_generate (Fast PPT) и выдаёт вам downloadUrl. Общее время: примерно 30–60 секунд для оформленного PowerPoint.
Хотите кастомные слайды с дизайном из изображений вместо шаблона? Попросите об этом — и Claude Code воспользуется путём Nano Banana (slides_create_pdf_slides), будет опрашивать jobs_get до готовности и вернёт ссылку.
Набор инструментов MCP-сервера 2Slides
После подключения Claude Code видит эти инструменты:
| Инструмент | Что делает | Кредиты |
|---|---|---|
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 | Опрашивает асинхронную задачу до статуса success | Бесплатно |
Три типичные цепочки:
- Fast PPT:
themes_search→slides_generate(синхронно) → скачивание. - Nano Banana:
slides_create_pdf_slides(асинхронно) →jobs_get→ скачивание. - Озвученные видеоматериалы: создание слайдов →
jobs_get→slides_generate_narration→jobs_get→slides_download_slides_pages_voices.
Частые ошибки и решение проблем
- Сервер не появляется в
claude mcp list. Для stdio проверьте правильность порядка--env/имени (держите флаг между--envи именем). Для HTTP перепроверьте URL и валидность API-ключа. - Отсутствует
API_KEY. Серверу stdio нужна переменная окружения; серверу HTTP нужен?apikey=или заголовокAuthorization. Не путайте их. - Запрос
.pptxбез инструмента. Без подключённого 2Slides Claude Code может написать структуру, но не способен выдать настоящий PowerPoint. Сначала подключите сервер. - Забыли про тему. Если вы не запустите
themes_searchи не назовёте стиль, Fast PPT выберет его за вас. Укажите тему, чтобы контролировать внешний вид. - Слишком частый опрос. Асинхронные задачи (Nano Banana, озвучивание) следует опрашивать через
jobs_getпримерно каждые 20 секунд, а не в плотном цикле.
Часто задаваемые вопросы
Поддерживает ли Claude Code MCP-серверы изначально?
Да. Claude Code — полноценный MCP-клиент. Вы добавляете серверы командой claude mcp add (транспорты stdio, SSE или HTTP), просматриваете их через claude mcp list и инспектируете прямо в сессии через /mcp. Сервер 2Slides работает со всеми этими вариантами.
Stdio или Streamable HTTP — что выбрать?
Используйте stdio на локальной машине (он сам запускает для вас npx -y 2slides-mcp@latest), а Streamable HTTP — везде, где нельзя или нежелательно ставить Node: CI, контейнеры, удалённые серверы. Оба предоставляют одни и те же инструменты и дают идентичный результат.
Получается ли настоящий файл PowerPoint?
Да. Путь Fast PPT (slides_generate) возвращает редактируемый .pptx с настоящими фигурами и темами. Пути Nano Banana возвращают слайды с дизайном из изображений и могут добавлять озвучивание ИИ-голосом и экспортируемые материалы. Это файлы, которые можно открыть, отредактировать и показать — а не скриншоты.
Где взять API-ключ и конфигурацию?
На 2slides.com/api?tab=mcp. Эта страница показывает ваш ключ, готовую к вставке конфигурацию stdio и URL эндпоинта Streamable HTTP.
Можно ли поделиться сервером 2Slides с командой?
Да. Добавьте его с --scope project, чтобы записать общий .mcp.json, который вы коммитите в репозиторий. Коллегам при первом использовании предложат подтвердить его. Для приватной настройки на все проекты используйте --scope user.
Вывод
Claude Code думает; MCP-сервер 2Slides создаёт файл. Подключите его один раз — stdio для локальной работы, Streamable HTTP для удалённой — и «сделай мне презентацию» превращается в одно предложение в вашем терминале.
Если вы живёте в Claude Code, это самый быстрый путь от идеи (или файла в вашем репозитории) к готовому редактируемому PowerPoint. Чтобы шире взглянуть на встраивание слайдов в агентов, см. как MCP меняет рабочие процессы презентаций и полную карту экосистемы PowerPoint MCP-серверов. Используете десктоп-приложение вместо CLI? См. как использовать Claude MCP для генерации презентаций.
Возьмите свой ключ и конфигурацию на 2slides.com/api?tab=mcp и сгенерируйте первую презентацию из терминала меньше чем за минуту.
Источники:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
