API VEGA

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 из PDFFree

Для 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.


Как это сравнивается

SlideForgepython-pptxТОЛЬКО AI-дек
Нативно редактируемый .pptxчасто изображения/экспорты
Детеминистичный (один вход — один слайд)✅ (ваш код)
Указывает, что AI-тронул (манифест точности)н/а
Качество компоновки без ручного кодирования✅ 200+ паттернов❌ DIYварьируется
Хостинг и нативная интеграция для агентов (MCP + REST)❌ локальночастично
Бесплатная предварительная валидация✅ dry_runн/а

Ссылки

Лицензия

MIT (этот репозиторий: skills, examples, docs). Сама SlideForge служба — коммерческий API.