MCP-сервер

Nordlet надає підтримку Model ContextProtocol за адресою https://api.nordlet.com/mcp. Підключений до нього ШІ-асистент може здійснювати пошук в API, читати схемну структуру запитів для будь-якої операції та виконувати її, використовуючи той самий ключ API, компанію та права доступу (scopes), що й під час звичайного запиту. Кожне викликування інструменту є звичайним запитом до API: воно проходить автентифікацію, підлягає обмеженню кількості запитів (rate limiting) та обліку тарифікації, а виклик, що змінює дані, вносить зміни до облікових регістрів компанії.

Підключення

Кінцева точка (endpoint) працює через протокол Streamable HTTP та використовує автентифікацію за допомогою ключа Bearer API з розділу Початок роботи. У Claude Code виконайте таку команду:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

Будь-який інший MCP-клієнт використовує таку саму URL-адресу та заголовок. Ключ із правами доступу *:read може виконувати лише операції читання, при цьому інструменти повертають помилку про відсутність прав у вигляді помилки API 403.

Інструменти

Три інструменти охоплюють усі операції API:

Інструмент	Що він робить
search_operations	Знаходить операції за ключовими словами в їхній назві, шляху, короткому описі (summary) або описі, за бажанням у межах одного модуля (sales, bank, reports тощо). Без пошукового запиту він виводить список модулів.
describe_operation	Повертає метод, шлях, опис та JSON-схему запиту для однієї операції; параметр includeResponse: true додатково додає схему відповіді 200.
call_operation	Виконує одну операцію з тілом у форматі JSON. Тіло відповіді повертається у форматі JSON, а відповідь зі статусом 4xx або 5xx повертається як помилка інструменту разом із кодом статусу та конвертом помилки. Необов'язковий параметр idempotencyKey передається в заголовку Idempotency-Key, тому повторний виклик із тим самим ключем відтворює першу відповідь замість повторного виконання дії.

Найпопулярніші операції також доступні як прямі інструменти з власними схемами запитів, завдяки чому асистент бачить їхні поля без необхідності додаткового пошуку: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary та reports_debt_aging. Кожен інструмент містить анотації MCP (readOnlyHint, destructiveHint), які повідомляють клієнту, чи виконує він операцію запису.

Покажчик операцій та схеми генеруються з того самого опису OpenAPI, що й довідник API та SDK, тому операція, додана до API, з'явиться в search_operations разом із випуском, у якому вона з'явилася. Інструкції сервера нагадують асистенту про загальні правила: суми подаються у вигляді рядків з десятковою крапкою (decimal strings), списки приймають параметри page, pageSize, sort та filter, а звіти для податкових органів певної країни повертають помилку 422, якщо компанія зареєстрована за межами цієї країни.