К содержимому
Инвойсбокс

MCP-сервер

Model Context Protocol — способ дать ассистенту доступ к внешним системам. MCP-сервер Инвойсбокс позволяет выставить счёт юрлицу, проверить оплату и оформить возврат прямо из диалога в Claude, Cursor или VS Code — не открывая личный кабинет и не собирая запрос к API руками.

Версия 0.2.1 опубликована. @invoicebox/mcp-server доступен в npm, команды на этих страницах работают. Пакет собран сборкой из открытых исходников и подписан: у версии есть подтверждение происхождения, которое проверяется командой npm audit signatures, а состав зависимостей выложен рядом с релизом. Проверка прав инструмента до вызова и аутентификация сессии для размещённого режима появились в 0.2.0. Указывайте версию в конфигурации явно, а о замеченном пишите в поддержку.
Показать схему: где лежит токен
flowchart LR
        A["Клиент: Claude Desktop,<br/>Cursor, VS Code"] --> B
        subgraph L["Ваша машина"]
            B["MCP-сервер Инвойсбокс<br/>здесь лежит токен"]
        end
        B --> C["API Инвойсбокс"]
        B -.-> D{"Подтверждение<br/>человеком"}
        D -.-> E["Выставить счёт,<br/>оформить возврат"]

Как это выглядит

ВыВыстави счёт ООО «Ромашка», ИНН 7701234560, на консультацию 122 000 ₽ с НДС 22 %, оплата до пятницы
АссистентНашёл реквизиты по ИНН. Счёт: консультация, 122 000 ₽, НДС 22 000 ₽, срок оплаты 8 августа. Выставить?
ВыДа
АссистентСчёт № 4821 создан, ссылка на оплату отправлена.

Тот же диалог по шагам — в разделе Демонстрация: видно, какой инструмент вызван, с какими параметрами, что он вернул и как выглядит подтверждение денежной операции.

Попробовать с этой фразой

Что умеет MCP-сервер

  • Выставить счёт юрлицу: реквизиты подтягиваются по ИНН, суммы проверяются на сходимость.
  • Узнать статус счёта по номеру в вашей учётной системе и получить ссылку на оплату.
  • Показать срез: неоплаченные счета за период, суммы и сроки.
  • Отменить неоплаченный счёт или оформить возврат по оплаченному.
  • Подтвердить отгрузку по счёту и посмотреть, какие отгрузки уже прошли.

Чего сервер не делает: не ведёт реестр поступлений (отдельной выборки платежей в API нет), не рассылает счета покупателям сам, не оформляет подписки, не списывает деньги по сохранённой карте и не управляет магазинами Витрины. Эти операции остаются в личном кабинете и в прямой интеграции с API.

Чем заплатит покупатель

Счёт, выставленный ассистентом, — обычный счёт Инвойсбокс, и оплачивается он теми же способами. Ссылка из ответа create_order открывает платёжную страницу: физлицо платит банковской картой «Мир» или по СБП по QR-коду и получает фискальный чек, организация — по СБП B2B, оплатой по счёту или с отсрочкой платежа и получает счёт, а после оплаты акт, счёт-фактуру и УПД. что видит покупатель на платёжной странице

Разница с обычным путём — во времени. Ассистент отдаёт ссылку и QR-код в том же диалоге, где человек только что согласился: между решением и оплатой не остаётся ни письма, ни ожидания, ни поиска счёта в почте, — а каждый такой шаг стоит конверсии. Оплата по СБП с телефона занимает секунды, и счёт закрывается, пока разговор ещё идёт.

Денежные операции требуют подтверждения человеком: ассистент показывает счёт или возврат целиком и ждёт согласия. Сервер сам следит, чтобы обрыв связи не создал дубль. Подробности — на странице безопасности.

С чего начать

Кто уже умеет говорить на MCP

Протокол поддерживает не модель, а клиент или фреймворк, в котором собран агент. Из готовых клиентов это Claude Code и Claude Desktop, Cursor, VS Code, Cline, Continue.dev. Агенты на LangChain и LangGraph получают MCP-клиент пакетом langchain-mcp-adapters, и через него работают сборки на GigaChat (langchain-gigachat), ChatGPT и Claude. Автономный GigaAgent от Сбера и AIRI подключает серверы MCP каталогом коннекторов.

Ассистентам без MCP-клиента — YandexGPT в Yandex Cloud Foundation Models, навыкам Алисы, локальным моделям вроде Qwen или Llama на своём сервере вывода — нужен слой функций: каталог инструментов тот же, меняется форма вызова.

Если ассистента у вас нет

Тот же набор операций доступен через обычное API: начните с быстрого старта. А если нужен приём оплаты на сайте без интеграции — посмотрите платёжные виджеты.