2Slides Team
5 min read
Как подключить Gemini CLI к MCP-серверу 2Slides (руководство 2026)
Краткий ответ (≤60 слов): Gemini CLI от Google умеет генерировать настоящие файлы PowerPoint через MCP-сервер 2Slides. Получите ключ на 2slides.com/api, затем добавьте запись
mcpServersв~/.gemini/settings.json—command: "npx",args: ["2slides-mcp"],env.API_KEYдля stdio, либоhttpUrl: "https://2slides.com/api/mcp?apikey=KEY"для Streamable HTTP. Или выполнитеgemini mcp add. Затем попросите Gemini собрать презентацию.
Gemini CLI — это open-source терминальный ИИ-агент от Google, и он «говорит» на языке Model Context Protocol (MCP). Подключите его к MCP-серверу 2Slides — и Gemini сможет превращать запрос (или файл в вашем рабочем каталоге) в готовый редактируемый .pptx.
В этом руководстве даны точные блоки settings.json для обоих транспортов (локальный stdio и удалённый Streamable HTTP), сокращение gemini mcp add и описание каждого инструмента 2Slides.
Зачем подключать Gemini CLI к 2Slides?
Gemini — сильный мультимодальный рассуждатель, но сам по себе он не выдаёт бинарные файлы .pptx. MCP-сервер 2Slides — это специализированный генератор:
- Gemini CLI читает ваш исходник, планирует слайды и пишет тексты.
- MCP-сервер 2Slides рендерит настоящий PowerPoint — Fast PPT на основе темы или слайды с дизайном из изображений с опциональным озвучиванием ИИ-голосом и экспортируемым комплектом.
Что понадобится в первую очередь
- Установленный Gemini CLI (
geminiв вашем PATH). - API-ключ 2Slides с 2slides.com/api.
- Node.js для транспорта stdio (
npx -y 2slides-mcp@latest). Транспорту HTTP ничего локального не нужно.
Stdio или Streamable HTTP: какой транспорт?
Оба предоставляют одни и те же инструменты; разница в ключе конфигурации и в том, где запускается коннектор.
| Stdio (локально) | Streamable HTTP (удалённо) | |
|---|---|---|
| Ключ конфигурации | command / args / env | httpUrl |
| Локальный Node.js | Требуется | Не требуется |
| Лучше всего для | Локальной разработки | Удалённых/CI, минималистичных установок |
Имя ключа имеет значение: Gemini CLI использует
httpUrlдля Streamable HTTP иurlдля устаревшего SSE. Для эндпоинта Streamable HTTP 2Slides используйтеhttpUrl.
Способ 1: stdio в settings.json
Gemini CLI читает ~/.gemini/settings.json (глобально) и .gemini/settings.json (проект). Добавьте блок mcpServers:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Значения env также могут ссылаться на переменные оболочки (например, "API_KEY": "$TWOSLIDES_API_KEY"), если вы не хотите вписывать ключ напрямую.
Способ 2: Streamable HTTP в settings.json
Для размещённого эндпоинта используйте httpUrl:
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}Предпочитаете аутентификацию через заголовок? Добавьте объект headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.
Или воспользуйтесь командой gemini mcp add
# stdio (-e задаёт переменные окружения)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"Эти команды пишут те же записи mcpServers в settings.json. Среди флагов: -t, --transport (stdio | sse | http), -e, --env, -H, --header и --timeout.
Проверьте подключение
В интерактивной сессии gemini выполните:
/mcpКоманда показывает статус каждого сервера (CONNECTED / CONNECTING / DISCONNECTED) и обнаруженные инструменты. Используйте /mcp auth, если удалённый сервер требует OAuth.
Сгенерируйте первую презентацию
Просто попросите:
Прочитай ./notes/market-update.md и сгенерируй брифинг из 9 слайдов.
Найди профессиональную тему из 2slides, собери PowerPoint
и дай мне ссылку на скачивание.Gemini CLI запускает themes_search → slides_generate (Fast PPT) → возвращает downloadUrl. Для кастомных слайдов с дизайном из изображений он использует 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 | Опрашивает асинхронную задачу до завершения | Бесплатно |
Частые ошибки и решение проблем
- Использовали
urlдля эндпоинта Streamable HTTP. Gemini CLI трактуетurlкак SSE. ИспользуйтеhttpUrlдля Streamable HTTP 2Slides. - Сервер показывает DISCONNECTED в
/mcp. Проверьте API-ключ, а для stdio убедитесь, что Node.js установлен. - Инструменты не перечислены. Перезапустите сессию после редактирования
settings.jsonили заново выполнитеgemini mcp add. - Нет
.pptxбез инструмента. Gemini сам по себе набрасывает структуру; файл создаёт 2Slides. - Слишком частый опрос. Дайте Gemini опрашивать
jobs_getпримерно каждые 20 секунд для асинхронных задач Nano Banana / озвучивания.
Часто задаваемые вопросы
Поддерживает ли Gemini CLI MCP-серверы?
Да. Gemini CLI — MCP-клиент. Настраивайте серверы под mcpServers в ~/.gemini/settings.json или добавляйте их через gemini mcp add. Поддерживаются транспорты stdio, SSE и Streamable HTTP.
Какой ключ конфигурации для сервера Streamable HTTP?
httpUrl. Используйте url только для устаревших SSE-серверов. Эндпоинт Streamable HTTP 2Slides идёт в httpUrl.
Где Gemini CLI хранит конфигурацию MCP?
~/.gemini/settings.json (глобально) или .gemini/settings.json (проект). Блок MCP — это верхнеуровневый ключ mcpServers.
Получается ли настоящий PowerPoint?
Да — slides_generate возвращает редактируемый .pptx. Инструменты Nano Banana возвращают слайды с дизайном из изображений с опциональным озвучиванием ИИ-голосом.
Где взять ключ и конфигурацию?
На 2slides.com/api?tab=mcp: ваш ключ, готовая к вставке конфигурация и URL эндпоинта Streamable HTTP.
Вывод
Одна запись
mcpServers—commandдля локальной работы,httpUrlдля удалённой — превращает Gemini CLI в генератор слайдов. Проверьте через/mcp, затем просто попросите презентацию.
Чтобы увидеть более широкую картину, см. как MCP меняет рабочие процессы презентаций и карту экосистемы PowerPoint MCP-серверов. Работаете в другом терминальном агенте? См. Claude Code, OpenAI Codex и Qwen Code с тем же сервером.
Получите свой ключ и конфигурацию на 2slides.com/api?tab=mcp и сгенерируйте первую презентацию из Gemini CLI меньше чем за минуту.
Источники:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
