mcp-name: dev.slideforge/slideforge
SlideForge MCP — слайды PowerPoint для агентов ИИ
SlideForge (slideforge.dev) — детерминированный компилятор PowerPoint для агентов ИИ. Типизированные намерения для слайдов → нативный, полностью редактируемый .pptx за менее чем секунду, с манифестом точности привязки, где точно указано, что было привязано дословно. Разработано компанией Smart Data Brokers GmbH, Швейцария.
Удалённый MCP сервер + REST API. Нет локальной установки, нет окружения Python, нет заготовок python-pptx. OAuth 2.1 для Claude Desktop и ChatGPT; API-ключ для всего остального.
⚠️ Разграничение
«SlideForge» используется несколькими независимыми проектами. Это SlideForge от Smart Data Brokers GmbH на slideforge.dev. Не имеет отношения к:
-
slideforge.io— отдельный генератор AI-презентаций -
slideforge.fr— французская служба полировки документов -
blink.new/p/slideforge-app— независящее веб-приложение -
Другие репозитории
github.com/*/SlideForgeза пределами организацииsmartdatabrokers
При цитировании или ссылках предпочтительно использовать slideforge.dev или "SlideForge от Smart Data Brokers."
Зачем SlideForge
-
Компилятор, а не генератор. Слайд — это типизированное намерение: выберите
формуиз более чем 200 каталог-паттернов (KPI-дашборды, водопады, диаграммы Ганта, оргструктура, воронки, …), поместите реальные данные в типизированные поля. Детерминированный движок раскладывает элементы — в рендере нет LLM, входные данные дают один и тот же слайд в пределах миллисекунд. -
Честность на первом месте. Каждый ответ сопровождается манифестом точности соответствия: для каждого поля было ли ваше содержимое привязано как
verbatim,mixedилиai_completed? Оценкаpartialозначает, что часть предоставленного контента не попала на слайд — манифест указывает, что было отброшено; никогда не выдавайте неполный рендер без уведомления пользователя о недостающем. Слайды с блокирующими дефектами не тарифицируются (usable-or-free). Если ваш агент подводит числа в слайды, именно это делает вывод подотчетным. -
Нативный, редактируемый .pptx. Реальные фигуры и текстовые поля — без изображений и экспортов HTML. Можно открыть и редактировать в PowerPoint.
-
Лазейка эскейпа — под тем же договором доверия.
mode=codeзапускает ваш собственный python-pptx в песочнице (виджет/инструменты диаграмм, внедрение темы, поля намерений рендерятся как chrome). Рендеринг кода проходит линтинг и измерение (layoutблок +presentation_ready), проверку происхождения — агенты могут выходить за рамки синтаксиса разметки, но не за пределы правил доверия. -
Ваш шаблон — нативно. Загрузите .pptx вашей компании — слайды строятся ОТ вашего файла (теема, мастера, шрифты), а не по подражанию цветам.
-
Проверка бесплатна.
dry_runвалидирует любой полезной payload + прогнозирует точность за $0 — или используйтеmode=safe, чтобы валидировать и затем рендерить в ОДИН вызов (рендеры + биллинг только при сохранении точности; иначе — отчет на $0 с исправлением). Уровниverifyдля рендеров кода (lintпо умолчанию,lint+vlmдобавляет визуальный повторный просмотр).quality_profile(exec/technical/appendix) устанавливает порог готовности, по которому оценивается макет — доступно для любой формы. Бесплатный просмотр набора (POST /v1/inspect) выдает детальный качественный отчет по любому pptx. -
Качество на 97% по сравнению с Gamma в нашем собственном слепом сравнении (внутренний инструмент, не сторонний).
Ценообразование в одном предложении: создание слайда — 5¢ · преобразование слайда (перевод, исправление) — бесплатно для проверки. 60 бесплатных слайдов при регистрации, без подписки. slideforge.dev/pricing
Быстрый старт
Один клик, без файла конфигурации:
VS Code (режим агента Copilot) входит через OAuth при первом использовании — без ключа, без JSON-файла.
Cursor устанавливается с заполнителем API-key: после нажатия замените sf_live_YOUR_KEY в заголовках сервера на реальный ключ из консолі. Собственный запуск OAuth-браузера Cursor сломан на версии 3.16.17, поэтому ключ — рабочий путь на сегодня.
Claude Code
claude mcp add --transport http slideforge https://api.slideforge.dev/mcp/
Затем просто попросите: "Сделай слайд KPI-дашборд: выручка $12.4M (+18% YoY), 847 новых клиентов, NPS 62."
Опционально — установка навыков + встроенной серверной конфигурации как плагина:
/plugin marketplace add smartdatabrokers/slideforge-mcp
/plugin install slideforge@slideforge-mcp
Или скопируйте любую папку из skills/ в ~/.claude/skills/ (для личного использования) или .claude/skills/ (для проекта).
Claude Desktop (OAuth — ключ не нужен)
Настройки → Соединители → Добавить настраиваемый коннектор → https://api.slideforge.dev/mcp/ — войдите через Google при первом использовании.
ChatGPT (Developer Mode)
Настройки → Приложения → Расширенно → Режим разработчика → Добавить настраиваемый коннектор → https://api.slideforge.dev/mcp/ (OAuth).
Cursor / Windsurf / Codex CLI / любой MCP-клиент (API-ключ)
{
"mcpServers": {
"slideforge": {
"url": "https://api.slideforge.dev/mcp/",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer sf_live_YOUR_KEY" }
}
}
}
Ключ получите: slideforge.dev → Консоль → API ключи. (Codex CLI и другие инструменты, поддерживаемые [AGENTS.md], держатся в формате AGENTS.md.)
Запуск локально (stdio — для контейнерных/офлайн-клиентов)
Большинство клиентов предпочитают удалённый удаленный сервер выше (без установки). Но если ваш клиент запускает MCP-серверы из контейнера или локального stdio-процесса, запустите встроенный локальный сервер. Это тонкий REST-клиент поверх api.slideforge.dev — он не содержит движок; схемы инструментов заложены локально (чтобы обнаружение работало оффлайн, без ключа) и каждый вызов передаётся в SlideForge REST API с использованием вашего ключа.
pip install slideforge-mcp # или: uv i pip install slideforge-mcp
export SLIDEFORGE_API_KEY=sf_live_YOUR_KEY
slideforge-mcp # говорит MCP через stdio
Или через Docker:
docker build -t slideforge-mcp .
docker run -i -e SLIDEFORGE_API_KEY=sf_live_YOUR_KEY slideforge-mcp
Конфигурация клиента (stdio):
{
"mcpServers": {
"slideforge": {
"command": "slideforge-mcp",
"env": { "SLIDEFORGE_API_KEY": "sf_live_YOUR_KEY" }
}
}
}
Открытие схем (tools/list) не требует ключа или сети; вызовы инструментов требуют ключ.
LangChain / LlamaIndex (агентские фреймворки)
SDK SlideForge не нужен — оба фреймворка напрямую загружают MCP-инструменты:
pip install langchain-mcp-adapters # или: pip install llama-index-tools-mcp
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"slideforge": {
"transport": "streamable_http",
"url": "https://api.slideforge.dev/mcp/",
"headers": {"Authorization": f"Bearer {API_KEY}"}}})
tools = await client.get_tools() # 7 инструментов, вставляйте в любой LangGraph-агент
Рабочие примеры + эквивалент LlamaIndex: examples/.
Нужен ключ? Зарегистрируйтесь — 60 бесплатных слайдов, без карты платежей — затем получите его
в console/keys.
REST (без MCP)
curl -X POST https://api.slideforge.dev/v1/render/intent \
-H "Authorization: Bearer sf_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"form": "kpi_metrics", "headline": "Q3 at a glance",
"data": {"metrics": [{"label": "Revenue", "value": "$12.4M", "delta": "+18% YoY"},
{"label": "New clients", "value": "847"},
{"label": "NPS", "value": "62"}]}}'
Полная справка REST: slideforge.dev/docs/api
7 инструментов MCP
| Инструмент | Что делает | Стоимость |
|---|---|---|
| create_slide | ОДИН слайд из структурированного намерения (форма + типизированные поля) или краткого описания; режим mode=safe валидирует и рендерит в одном вызове; режим mode=code для песочницы python-pptx (проверки через lint, layout блок + presentation_ready, проверка происхождения) — маршрутизация по вариациям: variant, variant_policy, allow_fabrication/allow_truncation/allow_low_confidence (честные дефолты: отклонять, если сумма требованиям не соответствует). min_font_pt задаёт минимальный размер шрифта — текст растёт до этого порога там, где это позволяет коробка; содержимое, которое не помещается, возвращает ошибку $0 min_font_not_met, указывающую нужный размер. Ответ содержит манифест точности и измеряемый блок готовности макета. По умолчанию темы — тематические дизайны — палитра, обложка, предусмотренные в дизайне заметке (стили: приоритет "чистый" — отключён; ваша закреплённая/загруженная брендовая тема всегда выигрывает). | $0.05 (usable-or-free) |
| create_deck | Весь набор: slides[] намерений (слайды в код-режиме как полноценные дети), параллельная отрисовка, один объединённый .pptx, суммарная точность по слайдам + дочерние задачи (с предпросмотром/pptx). Неудачные слайды отделяются — бесплатно; проверка всей колоды на уровне Deck-для валидности — бесплатно. На уровне колоды язык, направление (rtl для арабского/иврита — набор текста справа налево — макет не зеркалирован + честное предупреждение), imagery/imagery_tag, стили и logo_id наследуются на каждый слайд; собственное значение слайда победивает. | N × $0.05 |
| plan_slide | Кратко → топ-форма/вариантные кандидаты с доверием. | Free |
| browse_catalog | Более 200 паттернов с per-form JSON Schema + готовыми примерами намерений, темами и инструментами code-mode. Передайте theme_id, чтобы узнать обложку/планы/разделы бренда. type=brands перечисляет ваши бренд-наборы с их версиями. 9 встроенных тем + ваши загруженные бренд-наборы. | Free |
| translate_deck | Перевод любого PPTX с сохранением форматирования (32 языка). | $0.02/слайд |
| upload_asset | Логотипы, брендовые PPTX-шаблоны, изображения; purpose=pdf извлекает PDF в редактируемые слайд-намерения (PowerPoint/Keynote/Google-Slides/Beamer-exported PDFs; другие источники пока не поддерживаются); или AI-генерация изображения. Загрузка бренд-шаблона (purpose=brand — purpose=theme — то же самое под другим названием, всё ещё поддерживается) создаёт НАТИВНЫЙ рендер по умолчанию — наборы строятся на файле клиента. Пропустите данные для больших файлов в зону перетаскивания. | Free / $0.01/page / $0.05/image |
| manage_account | Баланс, использование, задачи, статус безопасности, отзывы, действие=feedback_list для чтения ваших отчётов, действие=brand_report для отчёта о точности по токенам бренда. | Free |
dry_run: true для инструментов создания = валидация + прогноз точности за $0.
Два дополнительных инструмента (generate_report, manage_connections — отчёты на основе данных из подключённых инструментов вроде Zoho Sprints) доступны за пределами enterprise-версии и не доступны по умолчанию.
Также в REST (пока): Deck Doctor. POST /v1/inspect — бесплатный детерминированный Deck Quality Report для любого pptx (переполнение по реальным метрикам шрифта, содержимое скрыто за фигурами, остатки за пределами холста, WCAG контраст). POST /v1/repair — детерминированные исправления, без изменения ваших слов, $0.02/исправленный слайд, бесплатная квота на dry-run. Docs
Бренд-киты
Бренд-кит — это идентичность вашей организации — цвета, шрифты, логотип и (опционально) загруженный
.pptx/.potx/.thmx шаблон — сохраняется под слагом и применяется к каждому вызову.
-
Используйте один: укажите
theme_id=<slug>при вызовахcreate_slide/create_deckдля версии набора по умолчанию, или<slug>@<n>для закрепления конкретной версии. -
Создайте один:
upload_asset(purpose="brand", data=<base64 .pptx/.potx/.thmx>)— колоды затем
рендерятся НАТИВНО на основе вашего собственного шаблона. (purpose="theme" — та же самая дорожка под другим названием и всё ещё работает.)
-
Обнаружение:
browse_catalog(type="brands")перечисляет ваши наборы с версиями. -
Проверка точности:
manage_account(action="brand_report", theme_id=<slug>)возвращает отчёт по точности на уровне токена для набора. -
Экспорт или импорт по URL: полный набор CRUD для бренда, экспорт DTCG
tokens.json/.potx/.thmx, и импорт идентичности прямо из домена компании — REST-only на сегодня — /v1/brands (ещё не зеркалируется как MCP-инструменты).
Безопасность
- Результирующие тела инструментов без учётных данных — без подписанных URL в ответах. Предпросмотры встроены напрямую (агент смотрит на PNG), загрузка .pptx через header-авторизацию
(Authorization: Bearer + проверка владения), а не bearer-в URL.
-
Нужна общедоступная ссылка?
POST /v1/jobs/<job_id>/download-urlсоздаёт короткоживущую, одноразовую, аннулируемую ссылку. -
Артефакты автоудаляются через 30 дней после создания.
-
Каждый загрузочный файл фиксируется в аудит-логах.
-
manage_account(action=security_status)раскрывает полную постуру доверия внутри канала.
Навыки агентов (этот репозиторий)
Навыки — это набор инструкций, помогающих агенту эффективно пользоваться SlideForge — смотрите skills/:
| Навык | Обучает | Стоимость |
|---|---|---|
| create-slide | Создание одного слайда/колоды по намерению → схема обнаружения, dry-run, манифест точности, предпросмотр без GUI | $0.05 |
| inspect-repair | Бесплатный Deck Quality Report на любом pptx + детерминированное исправление | Free |
| translate-pptx | Перевод PPTX с сохранением форматирования | $0.02/слайд |
| pdf-to-pptx | Извлечение editable PPTX из PDF | Free |
Для Codex CLI / Cursor / Copilot и других инструментов, поддерживаемых [AGENTS.md], в репозитории AGENTS.md содержатся те же инструкции в переносимом формате. CLAUDE.md импортирует его для Claude Code.
Безголовый режим (Claude Code / Codex CLI)
Нет встроенных виджетов в терминале, но результат инструмента уже включает превью PNG встроенным образом — агент читает его напрямую в ответе, без дополнительного запроса. Загрузку .pptx обеспечивает header-auth:
curl -H "Authorization: Bearer sf_live_YOUR_KEY" \
-o deck.pptx https://api.slideforge.dev/v1/jobs/<job_id>/pptx # владение проверено
Чтобы получить общедоступную ссылку вместо.raw-файла, создайте одноразовую ссылку:
POST /v1/jobs/<job_id>/download-url — короткая TTL, отменяемая, работает один раз.
Цикл само-оценки (рендер → просмотр встроенного предпросмотра → исправление → повторный рендер) описан в examples/claude-code.md.
Как это сравнивается
| SlideForge | python-pptx | ТОЛЬКО AI-дек | |
|---|---|---|---|
| Нативно редактируемый .pptx | ✅ | ✅ | часто изображения/экспорты |
| Детеминистичный (один вход — один слайд) | ✅ | ✅ (ваш код) | ❌ |
| Указывает, что AI-тронул (манифест точности) | ✅ | н/а | ❌ |
| Качество компоновки без ручного кодирования | ✅ 200+ паттернов | ❌ DIY | варьируется |
| Хостинг и нативная интеграция для агентов (MCP + REST) | ✅ | ❌ локально | частично |
| Бесплатная предварительная валидация | ✅ dry_run | н/а | ❌ |
Ссылки
-
Веб-сайт: slideforge.dev · Цены: pricing · Слой доверия и честности: trust
-
Документация: REST API · MCP · Быстрый старт · Deck Doctor
-
Smithery: smartdatabrokers/slideforge
-
X / Твиттер: @slideforgedev
Лицензия
MIT (этот репозиторий: skills, examples, docs). Сама SlideForge служба — коммерческий API.