MCP-сервер
MCP-сервер SmartPDF даёт ИИ-агенту 47 операций с PDF и фото и проверку баланса — агент сам выбирает операцию по вашей просьбе. Ключ и баланс — те же, что у REST API.
Подключение
| Адрес | https://mcp.smartpdf.ru/mcp |
| Транспорт | Streamable HTTP, без сессий |
| Ключ | Authorization: Bearer sk_live_… или X-API-Key: sk_live_… |
Ключ в адресе (?token=) не принимается: спецификация MCP это запрещает, а адрес попадает в журналы. Список инструментов (tools/list) доступен и без ключа, вызов инструмента без ключа вернёт ошибку со ссылкой на кабинет.
Пошаговые инструкции: Claude Code, Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI, Windsurf и Cline, n8n, Make.
Как агент работает с файлами
Инструменты принимают публичную ссылку на файл (file_url, до 100 МБ) и возвращают ссылку на результат (download_url) со сроком (expires_at). Файл с компьютера агент сначала загружает через REST API — см. Как передать файл.
Инструменты
| Инструмент | Что делает | REST |
|---|---|---|
word_to_pdf | Word в PDF | /pdf/word-to-pdf |
jpg_to_pdf | JPG в PDF | /pdf/jpg-to-pdf |
photo_to_pdf | Фото в PDF | /pdf/photo-to-pdf |
xlsx_to_pdf | Excel в PDF | /pdf/xlsx-to-pdf |
pptx_to_pdf | PowerPoint в PDF | /pdf/pptx-to-pdf |
djvu_to_pdf | DjVu в PDF | /pdf/djvu-to-pdf |
fb2_to_pdf | FB2 в PDF | /pdf/fb2-to-pdf |
epub_to_pdf | EPUB в PDF | /pdf/epub-to-pdf |
html_to_pdf | HTML в PDF | /pdf/html-to-pdf |
pdf_to_word | PDF в Word | /pdf/to-word |
pdf_to_jpg | PDF в JPG | /pdf/to-jpg |
pdf_to_png | PDF в PNG | /pdf/to-png |
pdf_to_excel | PDF в Excel | /pdf/to-excel |
pdf_to_pptx | PDF в PowerPoint | /pdf/to-pptx |
pdf_to_markdown | PDF в Markdown | /pdf/to-markdown |
pdf_to_txt | PDF в текст | /pdf/to-txt |
compress_image | Сжать фото | /pdf/compress-image |
heic_to_jpg | HEIC в JPG | /pdf/heic-to-jpg |
image_to_text | Фото в текст | /pdf/image-to-text |
png_to_jpg | PNG в JPG | /pdf/png-to-jpg |
jpg_to_png | JPG в PNG | /pdf/jpg-to-png |
webp_to_jpg | WEBP в JPG | /pdf/webp-to-jpg |
resize_image | Изменить размер фото | /pdf/resize-image |
crop_image | Обрезать фото | /pdf/crop-image |
rotate_image | Повернуть фото | /pdf/rotate-image |
word_to_jpg | Word в JPG | /pdf/word-to-jpg |
edit_pdf | Редактор PDF | /pdf/edit |
compress_pdf | Сжать PDF | /pdf/compress |
grayscale_pdf | PDF в ч/б | /pdf/grayscale |
pdf_to_pdfa | PDF в PDF/A | /pdf/to-pdfa |
repair_pdf | Восстановить PDF | /pdf/repair |
merge_pdfs | Объединить PDF | /pdf/merge |
split_pdf | Разделить PDF | /pdf/split |
ocr_pdf | Распознать текст | /pdf/ocr |
flatten_pdf | Сгладить PDF | /pdf/flatten |
delete_pages | Удалить страницы | /pdf/delete-pages |
crop_pdf | Обрезать PDF | /pdf/crop |
extract_pages | Извлечь страницы | /pdf/extract-pages |
rotate_pdf | Повернуть страницы | /pdf/rotate |
reorder_pages | Порядок страниц | /pdf/reorder-pages |
add_page_numbers | Нумерация страниц | /pdf/add-page-numbers |
sign_pdf | Подписать PDF | /pdf/sign |
protect_pdf | Защитить паролем | /pdf/protect |
unlock_pdf | Снять пароль | /pdf/unlock |
redact_pdf | Скрыть персональные данные | /pdf/redact |
find_personal_data | Найти персональные данные | /pdf/find-personal-data |
watermark_pdf | Водяной знак | /pdf/watermark |
get_balance | Баланс API, расход за месяц и цена запроса | GET /v1/api-keys/balance |
Параметры каждого инструмента агент получает от сервера сам — они те же, что у REST, но вместо file_id — ссылка на файл.
Оплата
Каждый вызов инструмента — запрос API с той же ценой (Оплата). get_balance показывает остаток и цену запроса. Если денег не хватает, агент получит ошибку с объяснением.
Примеры запросов к агенту
- «Сожми PDF по этим ссылкам и пришли ссылки на результат»
- «Распознай текст в скане договора и сделай из него Word»
- «Объедини три счёта в один PDF и пронумеруй страницы»
- «Поставь водяной знак «КОПИЯ» на все страницы»
- «Сколько осталось на балансе SmartPDF?»