n8n

Community-узел claritos для n8n: триггер-узел для всех событий и обычный узел для каждой конечной точки — сгенерировано из спецификации.

Что это за пакет

npm-пакет n8n-nodes-claritos (репозиторий: integrations/n8n) с двумя узлами и одним типом учётных данных. Обычный узел декларативный: resource = домен API, operation = конечная точка, поля из схемы; списки распаковываются в элементы data. Триггер-узел подписывается на события через webhook API. Оба генерируются из OpenAPI-спецификации и каталога событий и следуют за каждой версией API.

Установка и подключение

В n8n в Settings → Community Nodes установите пакет n8n-nodes-claritos (self-hosted: npm install в каталоге узлов). Учётные данные «claritos API»: API-ключ (capi_…) и среда; n8n проверяет подключение через GET /me. Scopes ключа определяют, какие операции и события работают.

bash

# n8n → Settings → Community Nodes → Install
n8n-nodes-claritos

# oder selbst gehostet
cd ~/.n8n/nodes && npm install n8n-nodes-claritos

Триггер-узел

При активации workflow узел создаёт подписку на webhook-URL n8n через POST /webhooks (выбранные типы событий, пусто = все), сохраняет id и secret в данных узла и проверяет каждую доставку по подписи Standard Webhooks (webhook-id, webhook-timestamp, webhook-signature; допуск 5 минут). При деактивации подписка удаляется. Нагрузка = конверт события {id, type, createdAt, data}. Для теста без реального события: POST /webhooks/{id}/test из API или «Тестовая доставка» во вкладке организации.

Обычный узел

Выберите ресурс (контакты, счета, подписи, письма, задачи …), затем операцию — параметры пути обязательны, поля query/body необязательны; вложенные поля (позиции, значения) как JSON. Ошибки приходят как Problem Details (RFC 9457) и показываются с заголовком/деталями в журнале выполнения; 429 содержит Retry-After. Повторы n8n для операций записи используйте осторожно.

Альтернатива: узел MCP Client

В n8n есть узел MCP Client. Вместо community-узла можно подключить MCP claritos (POST /api/mcp/v1) с заголовком Authorization — удобно для workflow с ИИ-агентами, где модель сама выбирает инструменты (руководство «MCP»).

json

// n8n „MCP Client“-Node: Server-URL + Header
{ "url": "https://www.claritos.io/api/mcp/v1", "headers": { "Authorization": "Bearer capi_…" } }

Для операторов: публикация

Аккаунт/токен npm как секрет NPM_TOKEN; тег n8n-v<version> запускает workflow publish-n8n (тесты, сборка, npm publish с provenance). Для отметки «verified» подайте пакет в n8n (правила community-узлов: без runtime-зависимостей кроме n8n-workflow — выполнено).