Конвертируй Markdown в Word внутри своего ИИ-агента

MCP-сервер MD2Doc позволяет Claude Code, Cursor, Windsurf и другим ИИ-агентам конвертировать markdown в документы Word напрямую — без браузера, без копирования и без переключения контекста.

claude mcp add --transport http md2doc https://md2doc.com/mcp

Endpoint: https://md2doc.com/mcp · Streamable HTTP · Free · No API key

Зачем пользоваться MD2Doc через MCP?

Инструмент в браузере хорош для разовых конвертаций. MCP-сервер — для разработчиков и опытных пользователей, которые каждый день работают в средах ИИ для кода.

⚡

Никакого переключения контекста

Оставайся в Claude Code, Cursor или Windsurf. Попроси документ Word и получи ссылку на скачивание, не выходя из редактора.

🤖

Полностью автоматически

Агенты конвертируют markdown в Word как часть большой задачи — документация, отчёты, конспект исследования — без ручных шагов.

☁️

Ничего не нужно ставить локально

MCP-сервер работает на md2doc.com. Без бинарника, без Docker, без обновлений. Добавь URL один раз, и он просто работает на каждой твоей машине.

Как это работает

1

Добавь сервер один раз

Выполни команду установки в терминале. Это занимает 10 секунд. URL пропишется в конфиг агента.

claude mcp add --transport http md2doc https://md2doc.com/mcp
2

Попроси агента своими словами

Никакого особого синтаксиса. Просто опиши, что нужно, и агент сам вызовет MD2Doc.

«Конвертируй этот markdown в файл Word и сохрани его на рабочий стол»
3

Получи ссылку на скачивание

MD2Doc конвертирует файл на сервере и возвращает одноразовую ссылку на скачивание. Она действует 10 минут. Нажми и сохрани.

https://md2doc.com/mcp/download/abc123

Установка силами агента

MD2Doc работает с любым агентом, совместимым с MCP. Выбери свой ниже.

Claude Code Рекомендуем

Claude Code — официальный CLI от Anthropic. Одна команда ставит сервер глобально.

claude mcp add --transport http md2doc https://md2doc.com/mcp

That is Streamable HTTP — the current MCP remote transport. Verify with /mcp — md2doc should appear as connected.

Claude Desktop

Открой конфиг Claude Desktop и добавь сервер md2doc:

На Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

На Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

Restart Claude Desktop after saving. Use "type": "http" — not SSE.

Cursor

Добавь MD2Doc в глобальный конфиг MCP для Cursor. Создай или открой файл:

~/.cursor/mcp.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

Или добавь .cursor/mcp.json в каталог проекта, чтобы доступ был только у этого проекта.

Windsurf

Отредактируй файл конфигурации MCP в Windsurf:

~/.codeium/windsurf/mcp_config.json

{ "mcpServers": { "md2doc": { "url": "https://md2doc.com/mcp" } } }

Reload Windsurf after saving the config. Point at /mcp, not /mcp/sse.

Hermes

Hermes and other HTTP-only agents should use the Streamable HTTP URL — this is the default, not a fallback:

mcp_servers: md2doc: url: "https://md2doc.com/mcp"

POST JSON-RPC to that URL. Do not use /mcp/sse.

OpenClaw

OpenClaw регистрирует MCP-серверы из CLI. Одна команда — и md2doc доступен в любой сессии:

openclaw mcp set md2doc '{"url":"https://md2doc.com/mcp"}'

Use Streamable HTTP at https://md2doc.com/mcp. Only use /mcp/sse if the client cannot speak HTTP.

Любой агент с поддержкой MCP

Use Streamable HTTP unless your client cannot. SSE is a deprecated fallback.

Recommended — Streamable HTTP:

https://md2doc.com/mcp

Legacy SSE (only if HTTP fails):

https://md2doc.com/mcp/sse

For JSON configs (Cline, Continue, Zed, etc.), add the server under "mcpServers" with "type": "http" and "url": "https://md2doc.com/mcp".

Большие файлы Markdown

Если markdown больше ~50 КБ, агенты могут загрузить файл отдельно, чтобы содержимое не съело бюджет токенов вызова инструмента. Агент выполняет одну команду в оболочке, получает короткий ID и передаёт этот ID в convert_to_docx:

# 1. Загрузка (байты файла идут с диска на сервер, агент их не читает) curl -F [email protected] https://md2doc.com/mcp/upload # → {"id":"abc..."} # 2. Вызови инструмент с markdown_upload_id вместо markdown convert_to_docx({ markdown_upload_id: "abc...", filename: "report" })

ID загрузок одноразовые, максимум 5 МБ, и истекают через 10 минут.

Доступные инструменты

MCP-сервер MD2Doc открывает четыре инструмента, которые агент может вызвать:

convert_to_docx

Конвертирует markdown в файл Microsoft Word (.docx). Возвращает временную ссылку на скачивание, она действует 10 минут.

{ "name": "convert_to_docx", "arguments": { "markdown": "# Заголовок\n\nТекст...", "filename": "my-report" } }

Возвращает: URL для скачивания и размер файла

convert_to_pdf

Конвертирует markdown в PDF через headless Chrome, так что таблицы, блоки кода и типографика совпадают с предпросмотром на сайте. Возвращает временную ссылку на скачивание, она действует 10 минут. Удобно для аккуратных документов только для чтения: поделиться, напечатать или положить в архив.

{ "name": "convert_to_pdf", "arguments": { "markdown": "# Заголовок\n\nТекст...", "filename": "my-report" } }

Возвращает: URL для скачивания и размер файла

convert_to_html

Конвертирует markdown в самостоятельный стилизованный HTML-документ со встроенным CSS. Возвращает временную ссылку на скачивание, она действует 10 минут. Можно встроить на сайт, вставить в CMS или отправить как тело письма.

{ "name": "convert_to_html", "arguments": { "markdown": "# Заголовок\n\nТекст...", "filename": "my-report" } }

Возвращает: URL для скачивания и размер файла

preview_markdown

Конвертирует markdown в HTML-предпросмотр и показывает, как именно будет выглядеть документ Word. Удобно агентам, которым нужно проверить результат до скачивания.

{ "name": "preview_markdown", "arguments": { "markdown": "# Заголовок\n\nТекст..." } }

Возвращает: строку HTML

О чём просить агента

Когда MD2Doc подключён, документы Word можно просить обычными словами. Вот запросы, которые хорошо работают:

  • Конвертируй этот markdown в файл Word и сохрани его на рабочий стол
  • Возьми ответ Claude и сделай из него .docx, который я могу отправить команде
  • Напиши проектное предложение в markdown и скачай его как документ Word
  • Собери это исследование в краткий вид и экспортируй как оформленный файл Word
  • Конвертируй мой README.md в документ Word для презентации клиенту
  • Сделай заметки встречи из этой расшифровки и скачай их как .docx

Технические детали

Протокол

MCP Streamable HTTP is the current remote transport. Point clients at https://md2doc.com/mcp (POST JSON-RPC). Legacy HTTP+SSE at /mcp/sse is kept for older clients only.

Эндпоинты

# Streamable HTTP (recommended) POST /mcp # Legacy SSE connection GET /mcp/sse # Send JSON-RPC messages (SSE flow) POST /mcp/messages?sessionId=X # Out-of-band markdown upload POST /mcp/upload # Download generated file GET /mcp/download/{id}

Производительность

Обычная конвертация занимает меньше 2 секунд для документов до 100 КБ markdown. Готовые файлы .docx хранятся 10 минут, а потом автоматически удаляются.

Конфиденциальность

Содержимое Markdown отправляется на md2doc.com для конвертации: оно не пишется в журнал и не хранится. Ссылки на скачивание одноразовые и истекают через 10 минут.

Вопросы про MCP

Что такое MCP и почему это важно?

MCP (Model Context Protocol) — открытый стандарт от Anthropic: ИИ-агенты подключаются к внешним инструментам и сервисам. Вместо того чтобы описывать, как пользоваться инструментом, агенты вызывают его напрямую, как функцию. Так процессы становятся быстрее, надёжнее и полностью автоматическими.

Нужен ли API-ключ?

Нет. MCP-сервер MD2Doc бесплатный и открытый. Просто добавь URL сервера и пользуйся. Без регистрации и без карты.

Which URL should I use?

Use https://md2doc.com/mcp (Streamable HTTP). That is the current MCP remote transport and the one HTTP-only connectors (Hermes, Estate, custom bots) can actually load. The old SSE URL at https://md2doc.com/mcp/sse still works for some Claude Code / Cursor setups, but it is deprecated — do not give it to a client that failed on SSE.

SSE isn't working. Now what?

Swap the URL to https://md2doc.com/mcp and set the transport to HTTP / Streamable HTTP. Do not GET that URL in a browser expecting JSON — the MCP protocol is POST. The website converter at md2doc.com still works if you skip MCP entirely.

Какие форматы файлов выдаёт MD2Doc?

Инструмент convert_to_docx создаёт стандартный файл .docx, совместимый с Microsoft Word 2010 и новее, Google Docs, LibreOffice и всеми основными редакторами документов.

Какие возможности markdown поддерживаются?

Заголовки (H1–H6), жирный, курсив, зачёркивание, упорядоченные и неупорядоченные списки, таблицы, блоки кода в ограждении, код в строке, цитаты и гиперссылки. Те же возможности, что у веб-конвертера.

Есть ли лимит запросов?

Сейчас для разумного использования лимита нет. Сервис сделан для рабочих процессов разработчиков и личного пользования. Если нужна конвертация больших объёмов, напиши нам.

Можно встроить это в своё приложение?

Да. REST API по адресам https://md2doc.com/convert и https://md2doc.com/download-docx тоже доступен для программного использования. Полная документация API — в LLM.md.

Вторая половина истории markdown для агентов

FolderMD — десктопная читалка, которую мы сделали для длинного markdown от агентов. Больше не нужно щуриться на ответы в 400 строк в терминале или окне чата: агенты могут писать сразу в спокойное красивое чтение, созданное именно для этого.

Перейти на foldermd.com →

Готов добавить MD2Doc к своему агенту?

Одна команда. Бесплатно. Регистрация не нужна.

claude mcp add --transport http md2doc https://md2doc.com/mcp

Или воспользуйся конвертером в браузере, если нужна разовая конвертация.

Нужна более высокая параллельность или ловишь ошибку «сервер занят»? Напиши @kirillzubovsky в личные сообщения в X — мы заведём для тебя отдельный аккаунт.