Invoice4U MCP от Agente

Неофициальный сторонний сервер Model Context Protocol, который предоставляет любому MCP-совместимому агенту безопасный типизированный доступ к аккаунту Invoice4U — поиск документов и клиентов, а также создание квитанций, связанных с оплаченными счетами.

• Неофициальный: это интеграция сообщества, не связанная с Invoice4U, не одобренная и не поддерживаемая им. Названия Invoice4U используются номинативно для описания того, к чему подключается сервер. Товарные знаки и логотипы Invoice4U не используются без разрешения.

• TypeScript / Node.js 24 LTS / MIT · транспорт stdio · локальный самохостинг — Agente никогда не хранит ваши учетные данные Invoice4U.

• Только чтение по умолчанию: единственный инструмент записи (создание квитанции) не регистрируется в tools/list, если не задано INVOICE4U_ALLOW_WRITES=true.

• Английский README · Иврит README.he.md

Quick start

{
  "mcpServers": {
    "invoice4u": {
      "command": "npx",
      "args": ["-y", "@agente-dev/invoice4u-mcp"],
      "env": {
        "INVOICE4U_API_TOKEN": "your-api-key",
        "INVOICE4U_ENV": "qa",
        "INVOICE4U_ALLOW_WRITES": "false"
      }
    }
  }
}

INVOICE4U_ENV должен быть явно задан как qa или production — он никогда молча не переключается на production по умолчанию. Начните с QA; это безопасная документированная стартовая конфигурация.

Related MCP server: mcp-server-smallinvoice

Tools (поверхность v0.1)

Инструменты чтения объявляют readOnlyHint: true, idempotentHint: true. Инструмент записи объявляет readOnlyHint: false, destructiveHint: false, idempotentHint: true — идемпотентность сохраняется только потому, что стабильный apiIdentifier обязателен, а дублирующиеся или неопределенные результаты разрешаются через поиск по идентификатору. Тайм-аут после отправки записи никогда не повторяется вслепую: сервер сначала выполняет запрос по apiIdentifier и повторяет попытку только в том случае, если поиск показывает, что документ не существует.

Деньги выражаются в виде десятичных строк на границе MCP ("12500.00"), никогда не как числа с плавающей запятой JavaScript. Ответы Invoice4U, которые возвращают HTTP 200, но содержат ошибки приложения в коллекции Errors, нормализуются в типизированную модель ошибок — никогда не сообщаются как успех.

Конфигурация

Учетные данные хранятся только в переменных окружения — токен никогда не принимается как аргумент инструмента, никогда не возвращается и не логируется.

См. .env.example. Связь устанавливается только с проверенными официальными хостами Invoice4U — нет произвольного запасного пути для базового URL.

Модель безопасности

• Только чтение по умолчанию — инструмент записи полностью исключен из tools/list, если запись явно не включена.

• Идемпотентные записи — обязательный стабильный apiIdentifier; повторная отправка того же запроса не может создать вторую квитанцию.

• Проверенные записи — каждая запись повторно получает квитанцию и связанные счета, возвращая предыдущие/новые остатки и статусы в виде структурированного вывода.

• Без слепых повторных попыток при неопределенных результатах записи; разрешение происходит через поиск по apiIdentifier.

• Гигиена секретов — никакие токены или персональные данные клиентов не попадают в журналы при обычных уровнях; QA-фикстуры не содержат реальных данных клиентов.

• Без движения денег — создание квитанции фиксирует уже полученные деньги; сервер не может инициировать платежи или списывать средства с карт.

Статус

Реализовано — поверхность v0.1. Восемь инструментов (7 чтения + 1 ограниченная запись) реализованы и зарегистрированы, как описано в таблице инструментов выше. Покрытие отслеживается в coverage-manifest.json, подробности в docs/.

• Статус QA: инструменты чтения проверены по справочнику API Invoice4U, а также контрактными тестами (120 модульных и контрактных тестов пройдены). Живая интеграция QA ЗАБЛОКИРОВАНА до получения учетных данных — нет публичной песочницы Invoice4U, и использование apiqa.invoice4u.co.il требует реальной учетной записи QA-организации и API-токена. Ограниченный смоук-тест (tests/integration/qa.spec.ts) пропускается без токена; см. docs/qa-testing.md.

• npm-пакет ожидает: публикация ожидает ссылку доверенной публикации для @agente-dev/invoice4u-mcp на npmjs.com.

Лицензия

MIT — см. LICENSE. © Agente Dev LTD. Не связано с Invoice4U.