MCP-сервер

Nordlet предоставляет интерфейс Model Context Protocol по адресу https://api.nordlet.com/mcp. Подключенный к нему ИИ-ассистент может выполнять поиск по API, читать схемы запросов любых операций и вызывать их, используя те же ключ API, компанию и область доступа (scope), что и при прямом запросе. Каждый вызов инструмента представляет собой обычный запрос к API: он проходит аутентификацию, для него действуют ограничения частоты запросов (rate limits) и тарификация, а изменяющий данные вызов отражается в учетных регистрах компании.

Подключение

Конечная точка поддерживает Streamable HTTP и использует аутентификацию по ключу API Bearer из раздела Начало работы. Команда для 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	Находит операции по ключевым словам в их названии, пути, кратком описании или описании, при необходимости с фильтрацией по модулю (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, поэтому любая новая операция появляется в search_operations одновременно с ее релизом в API. Инструкции сервера напоминают ассистенту об основных соглашениях: суммы передаются в виде строк с десятичной точкой, для списков используются параметры page, pageSize, sort и filter, а при попытке отправить отчетность для юрисдикции несоответствующей страны возвращается ошибка 422.