Unplain MCP

Ваш ассистент пишет электронную книгу или отчёт. Unplain оформляет её и возвращает готовый к публикации PDF.

Unplain — это размещённый сервер Model Context Protocol. Попросите ассистента создать документ, и он выберет дизайн (или применит сохранённый бренд), сгенерирует обложку и экспортирует готовый PDF с оформленной обложкой, оглавлением, построенным из заголовков, настоящей пагинацией и завершающей страницей с призывом к действию. Вы не покидаете чат и не открываете инструменты дизайна.

Из этого следует два важных момента, ради которых стоит использовать этот сервис вместо прямого запроса к модели на создание PDF:

• Результат всегда одинаковый. Брендовые темы сохраняются, поэтому десятый документ совпадает с первым. Ассистент может создать тему и переиспользовать её.

• Правки не тратят токены. Каждый документ — это реальный проект в вашем аккаунте Unplain, и инструменты возвращают ссылку на редактор. Исправьте предложение, нажав на него, а не перегенерируйте файл заново.

Unplain не пишет ваш контент и не принимает файлы через MCP: ассистент передаёт текст в формате Markdown. Загрузка .docx или .txt — это функция веб-приложения, а не MCP.

• Конечная точка: https://app.unplain.io/api/mcp

• Транспорт: потоковый HTTP

• Аутентификация: Authorization: Bearer <api-key> (также принимается просто Authorization: <api-key>)

• Установка: ничего устанавливать не нужно

• Документация: https://unplain.io/mcp

• Тарифы: включено во все планы, бесплатный и Pro. https://unplain.io/pricing

Этот репозиторий — документация. Сервер размещён у нас, поэтому здесь нет пакета для установки и исходного кода для запуска. Вопросы и сообщения об ошибках приветствуются.

Публикация в официальном реестре MCP: см. PUBLISHING.md. Манифест: server.json.

Быстрый старт

1. Получите API-ключ

Создайте ключ в настройках аккаунта. Он показывается только один раз. Бесплатного аккаунта достаточно для всего, что описано ниже.

2. Добавьте сервер

Claude Code

claude mcp add --transport http unplain https://app.unplain.io/api/mcp \
  --header "Authorization: Bearer unp_your_key_here"

Полное руководство: https://unplain.io/mcp/claude-code

Codex

export UNPLAIN_API_KEY="unp_your_key_here"

codex mcp add unplain \
  --url https://app.unplain.io/api/mcp \
  --bearer-token-env-var UNPLAIN_API_KEY

Полное руководство: https://unplain.io/mcp/codex

Что угодно ещё

Подойдёт любой клиент, который умеет подключать удалённый MCP-сервер и отправлять заголовок Authorization. Вам понадобятся два значения:

Server URL:  https://app.unplain.io/api/mcp
Header:      Authorization: Bearer unp_your_key_here

Клиент, который поддерживает только серверы на вашей собственной машине, пока подключиться не сможет.

3. Поприветствуйте сервер

List the Brand Themes in my Unplain account and tell me which one is the default.

Пустой список — это уже успех: соединение работает, а темы вы пока не сохраняли.

4. Создайте что-нибудь

Write a short ebook called "The Email Welcome Sequence Playbook" with an intro
and five chapters. Use my default Brand Theme, then export the PDF.

Related MCP server: MCP MD2PDF Server

Инструменты

Двенадцать инструментов. Названия и поведение актуальны для версии, указанной в CHANGELOG.md.

Важные замечания

• Правки атомарны и защищены от конфликтов. Ассистент не может перезаписать изменение, которое вы внесли в веб-приложении в то же время; устаревшая запись будет отклонена, а не применена поверх вашей работы.

• Дизайн можно описать словами, а не задавать вручную. «Строгий монохромный отчёт» или «элегантный независимый литературный журнал» превращается в реальные настройки, выбранные из того, что Unplain действительно поддерживает, а не выдуманные.

• Шрифты вне каталога будут отклонены, а не заменены. Что вы видите в приложении, то и окажется в PDF.

• Генерация обложки расходует вашу обычную квоту — ту же, что и кнопка в приложении. Отдельной квоты для MCP нет. Перезапись существующей обложки требует явного подтверждения, так что повторный запрос не приведёт к лишнему списанию.

• Ссылки для скачивания подписаны и истекают. Проект сохраняется, поэтому при необходимости просто запустите экспорт ещё раз, а не храните старую ссылку.

Планы и лимиты

MCP — это интерфейс, а не отдельный тариф. Ключ даёт ровно те же возможности, что и аккаунт, за которым он стоит, и те же лимиты действуют независимо от того, работаете ли вы в веб-приложении или через ассистента.

Обложка, оглавление и страница с призывом к действию не учитываются в лимите страниц. Актуальные тарифы: https://unplain.io/pricing

Примеры запросов

Полный набор примеров — в examples/prompts.md. Несколько для начала:

Take the Markdown in notes.md and create an Unplain ebook called "Q3 Growth
Report". Use my default Brand Theme, then wait for the export and give me the
PDF link.

Open my Unplain ebook "Q3 Growth Report", read the outline, rewrite the
introduction so it opens with a concrete number instead of a general claim,
then export a fresh PDF.

Analyse the churn data in ./data, write it up as a report with an executive
summary, three findings and a recommendation, then create it in Unplain using
my "Acme" theme and export the PDF.

Как обращаться с ключом

Относитесь к нему как к паролю.

• Codex читает ключ из переменной окружения — так он не попадает в конфигурационные файлы.

• Команда Claude Code -s project записывает .mcp.json в корень проекта. Не коммитьте в репозиторий настоящий ключ. Используйте заглушку, а каждый участник пусть подставляет свой собственный; ключ действует в том аккаунте, которому принадлежит.

• Отозвать ключ можно в настройках аккаунта. Отзыв вступает в силу немедленно. Держите отдельный ключ для каждого клиента, чтобы можно было отозвать один, не затронув остальные.

Устранение неполадок

Подробнее: https://unplain.io/mcp

Поддержка

• Документация: https://unplain.io/mcp

• Эл. почта: info@unplain.io

• Сообщения об ошибках: используйте этот репозиторий

Лицензия

Документация и примеры в этом репозитории распространяются по лицензии MIT. Сам сервис Unplain регулируется его условиями и политикой конфиденциальности.