{
  "markdown": "# Invoicebox MCP Server\n\nСервер Model Context Protocol для Инвойсбокса: ассистент выставляет счёт организации, ИП или\nфизическому лицу, проверяет оплату, подтверждает отгрузку — а по ней формируются закрывающие\nдокументы, — и возвращает деньги. Всё по просьбе человека и с его подтверждением.\n\nПрава по умолчанию — только чтение. Ни одна операция с деньгами не выполняется в один вызов.\n\n## Быстрый старт на демо-магазине\n\nДемонстрационный магазин опубликован в документации ([авторизация](https://docs.invoicebox.ru/docs/api/auth/)),\nпоэтому попробовать можно без своего договора. Он общий для всех читателей: пробные счета видны всем,\nпоэтому реальные реквизиты и персональные данные в демо не вводите.\n\n```\nINVOICEBOX_API_TOKEN=b37c4c689295904ed21eee5d9a48d42e INVOICEBOX_MERCHANT_ID=ffffffff-ffff-ffff-ffff-ffffffffffff INVOICEBOX_ENV=demo npx -y @invoicebox/mcp-server\n```\n\nЗаписи включаются явно: `INVOICEBOX_TOOLSETS=write` добавляет счёт, отмену и отгрузку, `refund` —\nвозврат. Токен можно не держать в переменной окружения: `invoicebox-mcp-server login <токен>` кладёт его\nв файл с правами только для владельца.\n\nПример конфигурации клиента MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"invoicebox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@invoicebox/mcp-server@0.2.1\"],\n      \"env\": {\n        \"INVOICEBOX_API_TOKEN\": \"b37c4c689295904ed21eee5d9a48d42e\",\n        \"INVOICEBOX_MERCHANT_ID\": \"ffffffff-ffff-ffff-ffff-ffffffffffff\",\n        \"INVOICEBOX_ENV\": \"demo\",\n        \"INVOICEBOX_TOOLSETS\": \"read\"\n      }\n    }\n  }\n}\n```\n\nВерсию указывайте всегда: у платёжного инструмента `latest` означает, что набор инструментов может\nизмениться между двумя запусками одного и того же диалога.\n\n## Инструменты\n\n| Инструмент | Что делает | Подтверждение |\n|---|---|---|\n| `lookup_company_by_inn` | Реквизиты организации или ИП по ИНН | нет |\n| `get_order` | Счёт по идентификатору или по своему номеру | нет |\n| `find_orders` | Срез по счетам: номер, статус, даты, суммы | нет |\n| `find_shipments` | Что по заказу отгружено и в каком статусе | нет |\n| `create_order` | Выставляет счёт, возвращает ссылку на оплату | двухфазное |\n| `cancel_order` | Отменяет неоплаченный счёт | двухфазное |\n| `create_shipment` | Подтверждает отгрузку, по ней идут акт, счёт-фактура и УПД | двухфазное |\n| `create_refund` | Возвращает деньги полностью или по составу | двухфазное |\n\nПолный справочник с параметрами — https://docs.invoicebox.ru/mcp/tools/\n\n## Что важно знать до первого счёта\n\n- **Суммы — целые копейки строкой:** `\"12200\"` это 122,00 ₽. Так модель не теряет копейку на числе с\n  плавающей точкой.\n- **Цена — за единицу, сумма — за количество.** `amount` и `amount_wo_vat` в позиции относятся к одной\n  единице, `total_amount` и `total_vat_amount` — ко всему количеству.\n- **Все записи двухфазные.** Первый вызов ничего не отправляет в API: возвращает сводку и одноразовый\n  токен на 15 минут, привязанный к параметрам. Второй вызов с этим токеном исполняет операцию.\n- **Крупная сумма подтверждается отдельно.** Выше порога (по умолчанию 100 000 ₽) сервер спрашивает\n  человека, а не довольствуется числом, которое подставила модель.\n- **Повтор не создаёт дубль.** Номер операции выводится из содержимого запроса; повтор того же вызова\n  возвращает прежний результат.\n- **Покупатель — юрлицо, ИП или физлицо.** В API типа два: `legal` (у ИП ИНН из 12 цифр и без КПП) и\n  `private`.\n- **Закрывающие документы идут по отгрузке.** Отдельного «сформировать УПД» нет: акт, ТОРГ-12,\n  счёт-фактуру и УПД запускает `create_shipment`.\n\n## Настройки\n\n| Переменная | Обязательна | Назначение |\n|---|---|---|\n| `INVOICEBOX_API_TOKEN` | да, если нет файла токена | Токен из личного кабинета, вкладка «Интеграция (API)» |\n| `INVOICEBOX_ENV` | да | `demo` или `production`; демо — магазин в тестовом режиме |\n| `INVOICEBOX_MERCHANT_ID` | для операций магазина | Идентификатор магазина |\n| `INVOICEBOX_COUNTERPARTY_ID` | для операций организации | Идентификатор организации |\n| `INVOICEBOX_TOOLSETS` | нет | `read` по умолчанию, плюс `write` и `refund` |\n| `INVOICEBOX_STATE_DIR` | нет | Каталог журнала и защиты от дублей; без него она живёт только в пределах запуска |\n| `INVOICEBOX_RATE_LIMIT` | нет | Свой ограничитель, `запросы/секунды`; по умолчанию `60/30` |\n| `INVOICEBOX_LIMITS` | нет | Суточные потолки, JSON |\n| `INVOICEBOX_CONFIRM_THRESHOLD` | нет | Порог суммы в копейках для отдельного подтверждения |\n| `INVOICEBOX_LOG_LEVEL` | нет | `error`, `warn`, `info`, `debug` |\n| `INVOICEBOX_GRAYLOG_URL`, `INVOICEBOX_SENTRY_DSN` | нет | Внешние приёмники журнала; выключены по умолчанию |\n| `INVOICEBOX_TOKEN_FILE` | нет | Свой путь к файлу токена |\n| `INVOICEBOX_HTTP_PORT` | нет | Задан — транспорт Streamable HTTP на этом порту, иначе stdio |\n| `INVOICEBOX_HTTP_HOST` | нет | Адрес привязки HTTP; по умолчанию `127.0.0.1` |\n| `INVOICEBOX_HTTP_ALLOWED_HOSTS`, `INVOICEBOX_HTTP_ALLOWED_ORIGINS` | нет | Белые списки `Host` и `Origin`; по умолчанию наружу закрыто |\n| `INVOICEBOX_HTTP_SESSION_IDLE_MS`, `INVOICEBOX_HTTP_MAX_SESSIONS` | нет | Срок жизни сессии (30 минут) и их потолок (200) |\n\nПолный список настроек — https://docs.invoicebox.ru/mcp/quickstart/\n\n## Расход контекста\n\nНабор по умолчанию занимает около 1 100 токенов описаний, полный набор с возвратами — около 4 000.\nВыборка двадцати счетов стоит примерно 1 200 токенов в кратком формате и 2 900 в подробном. Ответы\nусекаются с явной пометкой, страница ограничена пятьюдесятью записями. Замеры и приёмы —\nhttps://docs.invoicebox.ru/mcp/tokens/\n\n## Разработка\n\n```\nnpm ci\nnpm run typecheck\nnpm run lint\nnpm test\nnpm run build\n```\n\n## Документация\n\n- Раздел о сервере: https://docs.invoicebox.ru/mcp/\n- Справочник инструментов: https://docs.invoicebox.ru/mcp/tools/\n- Безопасность и подтверждения: https://docs.invoicebox.ru/mcp/security/\n- Лимиты, ошибки и журнал: https://docs.invoicebox.ru/mcp/faq/\n- Расход токенов: https://docs.invoicebox.ru/mcp/tokens/\n- Ассистенты без MCP: https://docs.invoicebox.ru/mcp/functions/\n- API Инвойсбокса: https://docs.invoicebox.ru/docs/api/\n\n## История изменений\n\nЧто менялось между версиями — в файле `CHANGELOG.md` внутри пакета (`npm view\n@invoicebox/mcp-server versions` покажет список выпусков). Версию в конфигурации\nуказывайте явно: у платёжного инструмента `latest` означает, что набор инструментов\nможет измениться между двумя запусками одного диалога.\n\n## Поддержка\n\nВопросы и доступ к бете — https://www.invoicebox.ru/ru/contacts\n",
  "bytes": 6432,
  "sha": "70004362541da098414ef4a2cdb506a117652bb1f63aab0681963d5ccac58d1f",
  "repo_slug": "invoicebox/invoicebox-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ru_invoicebox_mcp_server_5e393b1d/readme"
}