MCP-сервер
MCP-сервер SmartPDF даёт ИИ-агенту 24 инструмента — агент сам выбирает операцию по вашей просьбе. Ключ и баланс — те же, что у 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 |
xlsx_to_pdf | Excel в PDF | /pdf/xlsx-to-pdf |
pptx_to_pdf | PowerPoint в PDF | /pdf/pptx-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_excel | PDF в Excel | /pdf/to-excel |
pdf_to_pptx | PDF в PowerPoint | /pdf/to-pptx |
pdf_to_txt | PDF в текст | /pdf/to-txt |
compress_pdf | Сжать PDF | /pdf/compress |
merge_pdfs | Объединить PDF | /pdf/merge |
split_pdf | Разделить PDF | /pdf/split |
ocr_pdf | Распознать текст | /pdf/ocr |
flatten_pdf | Сгладить PDF | /pdf/flatten |
delete_pages | Удалить страницы | /pdf/delete-pages |
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 |
watermark_pdf | Водяной знак | /pdf/watermark |
get_balance | Баланс API, расход за месяц и цена запроса | GET /v1/api-keys/balance |
Параметры каждого инструмента агент получает от сервера сам — они те же, что у REST, но вместо file_id — ссылка на файл.
Оплата
Каждый вызов инструмента — запрос API с той же ценой (Оплата). get_balance показывает остаток и цену запроса. Если денег не хватает, агент получит ошибку с объяснением.
Примеры запросов к агенту
- «Сожми PDF по этим ссылкам и пришли ссылки на результат»
- «Распознай текст в скане договора и сделай из него Word»
- «Объедини три счёта в один PDF и пронумеруй страницы»
- «Поставь водяной знак «КОПИЯ» на все страницы»
- «Сколько осталось на балансе SmartPDF?»