# n8n

Источник: https://dev.smartpdf.ru/docs/n8n

## Агент в n8n — узел MCP Client Tool

1. Добавьте к узлу **AI Agent** инструмент **MCP Client Tool**.
2. **Endpoint** — `https://mcp.smartpdf.ru/mcp`, **Server Transport** — HTTP Streamable.
3. **Authentication** — Bearer Auth; в учётных данных — только ключ `sk_live_…`, слово `Bearer` n8n добавит сам.
4. Выберите инструменты SmartPDF, которые нужны агенту.

Для обычного шага сценария без агента есть узел **MCP Client** с теми же настройками.

## Без агента — HTTP Request

Фиксированные сценарии надёжнее строить на REST API — узлами **HTTP Request**:

1. `POST https://api.smartpdf.ru/v1/upload` — тело Form-Data, поле `file` с двоичными данными; заголовок `X-API-Key`.
2. `POST https://api.smartpdf.ru/v1/pdf/<операция>` — JSON с `file_id` из шага 1.
3. Ожидание: цикл с **Wait** и `GET https://api.smartpdf.ru/v1/tasks/{task_id}` до статуса `done` — или [вебхук](https://dev.smartpdf.ru/docs/webhooks) на узел **Webhook**.
4. `GET https://api.smartpdf.ru/v1/tasks/{task_id}/download` и скачивание `download_url`.

Параметры операций — в разделе [Операции](https://dev.smartpdf.ru/docs/operations).
