Конвертер документов с MCP для ИИ-агентов
Подключите ДокФормат к Claude, Cursor или другому MCP-клиенту — и просите ассистента «сделай из этого PDF» прямо в чате. Агент сам выберет конвертацию, дождётся результата и вернёт ссылку на готовый файл.
Что такое MCP и зачем он агенту
MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-ассистенты подключают внешние инструменты. Сами языковые модели не умеют открывать DOCX или собирать PDF; MCP-сервер даёт им такую возможность.
Вы один раз добавляете адрес сервера и API-ключ в настройки клиента. После этого агент видит инструменты ДокФормата и вызывает их, когда задача требует конвертации, — без кода и ручной загрузки файлов на сайт.
Для своих программ без ИИ используйте REST API — он работает с теми же конвертациями и лимитами.
Что происходит за одной просьбой
- 1Вы прикладываете файл и пишете: «Сделай из этого PDF»
- 2Агент вызывает list_tools и выбирает подходящую конвертацию
- 3convert_file отправляет файл — расходуется одна операция
- 4get_conversion ждёт результата и возвращает ссылку downloadUrl
Что умеет MCP-сервер
Описания инструментов — на русском и английском, поэтому агент правильно понимает их на любом языке диалога.
list_toolsСписок конвертацийSlug каждой конвертации, название, допустимые расширения и максимальный размер файла. Только чтение.convert_fileКонвертировать файлСтавит файл в очередь: slug, имя файла и либо публичная ссылка file_url (до 25 МБ), либо содержимое file_base64 (до 20 МБ). Возвращает id задачи.get_conversionСтатус и результатСтатус задачи и ссылка downloadUrl на готовый файл. Параметр wait_seconds (до 25) позволяет дождаться результата за один вызов.get_usageОстаток лимитовТариф, бесплатные операции за сегодня и разовые операции аккаунта — те же цифры, что в личном кабинете.
Конфиги для Claude, Cursor и других клиентов
Создайте ключ в личном кабинете → API и интеграции и подставьте его вместо dfk_ваш_ключ. В кабинете те же конфиги можно скопировать с уже подставленным ключом.
https://dokformat.ru/api/mcpClaude Desktop
Откройте Settings → Developer → Edit Config и добавьте сервер в claude_desktop_config.json. Claude Desktop подключается к удалённым серверам с заголовками через мост mcp-remote — нужен установленный Node.js.
{
"mcpServers": {
"dokformat": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://dokformat.ru/api/mcp",
"--header",
"Authorization:${DOKFORMAT_AUTH}"
],
"env": {
"DOKFORMAT_AUTH": "Bearer dfk_ваш_ключ"
}
}
}
}Claude Code
claude mcp add --transport http dokformat https://dokformat.ru/api/mcp --header "Authorization: Bearer dfk_ваш_ключ"Cursor
Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json внутри проекта.
{
"mcpServers": {
"dokformat": {
"url": "https://dokformat.ru/api/mcp",
"headers": {
"Authorization": "Bearer dfk_ваш_ключ"
}
}
}
}VS Code
{
"servers": {
"dokformat": {
"type": "http",
"url": "https://dokformat.ru/api/mcp",
"headers": {
"Authorization": "Bearer dfk_ваш_ключ"
}
}
}
}Другие MCP-клиенты
Подойдёт любой клиент с поддержкой удалённых серверов по Streamable HTTP: укажите адрес сервера и заголовок Authorization. В некоторых клиентах (например, Windsurf) поле адреса называется serverUrl. Сервер работает без сессий: каждый POST-запрос — отдельный обмен JSON-RPC, поэтому проверить ключ можно обычным curl:
curl -X POST https://dokformat.ru/api/mcp \
-H "Authorization: Bearer dfk_ваш_ключ" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Что можно попросить у агента
Формулировки свободные — агент сам сопоставит просьбу с инструментами. Если файл больше 20 МБ, дайте агенту публичную ссылку на него.
Каждая успешная конвертация расходует одну операцию; узнать остаток можно вопросом к агенту или в личном кабинете.
- «Сконвертируй этот договор в PDF»Файл из чата агент передаст в file_base64 и вернёт ссылку на PDF.
- «Скачай отчёт по ссылке https://example.ru/report.xlsx и сделай из него PDF»Агент передаст ссылку в file_url — файл загрузит сервер ДокФормата.
- «Преврати этот PDF в Word, мне нужно поправить текст»Агент выберет инструмент pdf-v-word и отдаст DOCX.
- «Сохрани все презентации из папки slides в PDF»Агенты с доступом к файлам (Claude Code, Cursor) обработают файлы по очереди — по операции на файл.
- «Сколько конвертаций у меня осталось сегодня?»Агент вызовет get_usage и ответит по данным аккаунта.
Что агент может и чего не может
- Ключ привязан к вашему аккаунтуАгент работает только от имени владельца ключа и видит только свои конвертации. Ключ можно отозвать в кабинете в любой момент.
- Защита file_url от SSRFСервер загружает только http(s)-ссылки на публичные адреса: внутренние сети, localhost и ссылки с логином отклоняются, каждый редирект проверяется заново.
- Ограничения размераДо 25 МБ по ссылке и до 20 МБ в base64. Большие файлы передавайте ссылкой.
- Хранение 24 часаИсходник удаляется сразу после обработки, результат — через 24 часа, как и на сайте.
- Подписанные ссылки на результатdownloadUrl действует 1 час и не содержит ключа — его безопасно показать в чате.
- Подсказки для клиентаlist_tools, get_conversion и get_usage помечены как read-only, поэтому клиент может выполнять их без подтверждения, а convert_file — спрашивать.
Те же операции, что на сайте
MCP-сервер, REST API, Telegram-бот и расширение для браузера расходуют лимиты одного аккаунта: 5 бесплатных серверных конвертаций в день, затем — операции тарифа. Неудачные конвертации не списываются. Технический лимит — 60 запросов в минуту на ключ.
MCP внутри вашего контура
В коробочной версии MCP-сервер и конвертер работают на ваших серверах, и корпоративные агенты обрабатывают документы, не отправляя их наружу. Встроить конвертацию в свой продукт под своим брендом — White Label.
Частые вопросы об MCP-сервере
Что такое MCP простыми словами?
Model Context Protocol — открытый стандарт, по которому ИИ-ассистенты подключают внешние инструменты. Вы один раз добавляете MCP-сервер ДокФормата в настройки клиента, и агент получает «кнопки» вроде «конвертировать файл», которые вызывает сам, когда это нужно для вашей задачи.
Какие ИИ-клиенты поддерживаются?
Любые MCP-клиенты с поддержкой удалённых серверов по Streamable HTTP и заголовка Authorization: Claude Desktop (через мост mcp-remote), Claude Code, Cursor, VS Code, Windsurf и другие. Если клиент умеет только локальные серверы, используйте mcp-remote, как в конфиге для Claude Desktop.
Сколько стоит MCP-сервер?
Отдельной платы нет. Каждая конвертация расходует одну операцию из лимитов аккаунта: 5 бесплатных в день или операции платного тарифа — от 59 ₽ за разовую операцию.
Какие форматы может конвертировать агент?
Word в PDF, Excel в PDF, PowerPoint в PDF, JPG в PDF, XLS в PDF, CSV в PDF, PDF в Word, DOC в DOCX, DOCX в DOC, RTF в DOCX, ODT в DOCX. Это те же серверные конвертации, что в REST API и на сайте.
Видит ли ДокФормат мою переписку с ассистентом?
Нет. Сервер получает только вызовы инструментов: slug, имя файла и сам файл или ссылку на него. Текст диалога и другие данные клиента на сервер не передаются.
Почему агент получает ссылку, а не сам файл?
Так результат не раздувает контекст модели. Ссылка downloadUrl действует 1 час, по ней файл скачиваете вы или агент с доступом к сети.
Можно ли использовать MCP внутри компании, без выхода в интернет?
Да, в коробочной версии MCP-сервер работает на ваших серверах вместе с конвертером, а агенты подключаются к нему по внутреннему адресу.
Подключите ДокФормат к своему агенту
Получите API-ключ — в кабинете появятся готовые конфиги для Claude, Cursor и Claude Code с вашим ключом.
Интеграция без ИИ: REST API для конвертации