К содержимому

MCP-сервер

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

Сервер готовится. Пакет @invoicebox/mcp-server ещё не опубликован, поэтому подключить его прямо сейчас нельзя. Здесь описано, каким он будет: состав инструментов, правила подтверждения денежных операций и границы доверия — это уже решено. Напишите в поддержку, если сервер вам нужен: так мы поймём приоритет и сообщим о публикации.
Показать схему: где лежит токен
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 создан, ссылка на оплату отправлена.

Что умеет первая версия

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

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

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

С чего начать

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

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