# Подключение агента через MCP

[HTML](https://pdfcraft.ai/ru-RU/docs/getting-started/mcp/)
[Site index](https://pdfcraft.ai/llms.txt)

Конвертируйте и переводите PDF и EPUB с помощью ИИ-агента и PDFCraft.


Подключите PDFCraft к ИИ-агенту, который поддерживает удалённые MCP-серверы. Агент сможет конвертировать PDF в Markdown или EPUB, переводить PDF и книги EPUB, проверять баланс, оценивать стоимость и получать результаты.

## Настройка подключения

1. Создайте собственный API Key в [OOMOL Console](https://console.oomol.com/api-key).
2. Добавьте удалённый MCP-сервер в настройках агента. Укажите URL `https://api.pdfcraft.ai/v1/mcp` и транспорт Streamable HTTP.
3. Добавьте заголовок `Authorization: Bearer YOUR_API_KEY`, заменив `YOUR_API_KEY` своим ключом.

Ниже показаны параметры подключения в формате JSON. Названия полей зависят от клиента: укажите эти значения в его настройках URL и HTTP-заголовков.

```json
{
  "url": "https://api.pdfcraft.ai/v1/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}
```

Храните ключ в защищённых настройках клиента. Не вставляйте его в переписку или ссылки на файлы. Конвертация расходует кредиты PDFCraft. [Пополнить баланс можно здесь](https://pdfcraft.ai/ru-RU/recharge/).

## Совместимость клиента

Сервис использует Streamable HTTP и версию протокола MCP `2026-07-28`. Клиент должен поддерживать эту версию и настройку заголовков авторизации Bearer. Старые процедуры инициализации и работы с сессиями образца 2025 года не поддерживаются.

Интерактивного входа через OAuth нет. Клиенты, которые требуют OAuth и не позволяют передать API Key в заголовке Bearer, не могут подключиться напрямую.

## Первая конвертация

После подключения агент сможет получить список инструментов и инструкции к ним. Попросите его сначала вызвать `get_capabilities`, чтобы узнать доступные форматы, языки и порядок действий. Например:

> Преобразуй этот PDF в EPUB. Перед запуском проверь мой баланс и оцени стоимость.

Для загрузки агенту нужен доступ к содержимому файла: одного локального пути недостаточно, чтобы удалённый сервер прочитал файл. Затем агент сможет создать задачу, загрузить файл, запустить обработку, следить за прогрессом и получить ссылку на скачивание. Сохраните UUID задачи, чтобы вернуться к ней позже.

По умолчанию скачивается полный файл. Если скачивание заблокировано из-за задолженности, пополните баланс и запросите новую ссылку для той же задачи. Неполный файл выдаётся только по явному запросу и при наличии такой версии.

Для прямой интеграции в приложение см. [справочник REST API](https://pdfcraft.ai/ru-RU/docs/api/overview/).