Подключите PDFCraft к ИИ-агенту, который поддерживает удалённые MCP-серверы. Агент сможет конвертировать PDF в Markdown или EPUB, переводить PDF и книги EPUB, проверять баланс, оценивать стоимость и получать результаты.
Настройка подключения
- Создайте собственный API Key в OOMOL Console.
- Добавьте удалённый MCP-сервер в настройках агента. Укажите URL
https://api.pdfcraft.ai/v1/mcpи транспорт Streamable HTTP. - Добавьте заголовок
Authorization: Bearer YOUR_API_KEY, заменивYOUR_API_KEYсвоим ключом.
Ниже показаны параметры подключения в формате JSON. Названия полей зависят от клиента: укажите эти значения в его настройках URL и HTTP-заголовков.
{ "url": "https://api.pdfcraft.ai/v1/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" }}Храните ключ в защищённых настройках клиента. Не вставляйте его в переписку или ссылки на файлы. Конвертация расходует кредиты PDFCraft. Пополнить баланс можно здесь.
Совместимость клиента
Сервис использует Streamable HTTP и версию протокола MCP 2026-07-28. Клиент должен поддерживать эту версию и настройку заголовков авторизации Bearer. Старые процедуры инициализации и работы с сессиями образца 2025 года не поддерживаются.
Интерактивного входа через OAuth нет. Клиенты, которые требуют OAuth и не позволяют передать API Key в заголовке Bearer, не могут подключиться напрямую.
Первая конвертация
После подключения агент сможет получить список инструментов и инструкции к ним. Попросите его сначала вызвать get_capabilities, чтобы узнать доступные форматы, языки и порядок действий. Например:
Преобразуй этот PDF в EPUB. Перед запуском проверь мой баланс и оцени стоимость.
Для загрузки агенту нужен доступ к содержимому файла: одного локального пути недостаточно, чтобы удалённый сервер прочитал файл. Затем агент сможет создать задачу, загрузить файл, запустить обработку, следить за прогрессом и получить ссылку на скачивание. Сохраните UUID задачи, чтобы вернуться к ней позже.
По умолчанию скачивается полный файл. Если скачивание заблокировано из-за задолженности, пополните баланс и запросите новую ссылку для той же задачи. Неполный файл выдаётся только по явному запросу и при наличии такой версии.
Для прямой интеграции в приложение см. справочник REST API.