Как передать файл

#Файл по ссылке — для MCP

Инструменты MCP принимают ссылку на файл и скачивают его сами. Ссылка должна быть:

• публичной — http или https, без входа и cookies (подойдут, например, временные ссылки S3 или облачного диска);
• на внешний адрес — адреса внутренних сетей и localhost не принимаются;
• на файл до 100 МБ, который скачивается не дольше минуты.

Результат приходит ссылкой — агент передаст её вам или скачает сам.

#Файл с компьютера — через REST

Если файл у вас на диске, его сначала загружают через POST /v1/upload, а операцию запускают через REST API — так умеют агенты с доступом к терминалу (Claude Code, Codex CLI, Gemini CLI, Cursor):

FILE_ID=$(curl -sS -H "X-API-Key: $SMARTPDF_API_KEY" -F "file=@contract.pdf" \
  https://api.smartpdf.ru/v1/upload | jq -r .file_id)

Дальше — запуск операции, ожидание и скачивание, как в быстром старте. Агенту достаточно попросить: «загрузи contract.pdf в SmartPDF через REST API и сожми его» — и дать ссылку на эту страницу или llms.txt.

Проще — дать агенту навык SmartPDF: инструкцию и скрипт, который сам загрузит файл, запустит операцию и сохранит результат рядом (Python 3, без зависимостей). В Claude Code он входит в плагин, для Codex CLI, Gemini CLI, Cursor и VS Code — папка skills/smartpdf в папку навыков агента.