Invoice4U MCP 由 Agente

一个非官方的第三方 Model Context Protocol 服务器，为任何兼容 MCP 的代理提供对 Invoice4U 账户的安全、类型化访问——搜索文档和客户，并创建与已付款发票关联的收款单。

• 非官方： 这是一个社区集成，与 Invoice4U 无关联、未经其认可或支持。Invoice4U 名称仅用于指代服务器所连接的对象。未经许可不使用任何 Invoice4U 商标或徽标。

• TypeScript / Node.js 24 LTS / MIT · stdio 传输 · 本地自托管 — Agente 绝不保管您的 Invoice4U 凭据。

• 默认只读： 除非 INVOICE4U_ALLOW_WRITES=true，否则唯一的写入工具（创建收款单）不会在 tools/list 中注册。

• 英文 README · 希伯来文 README.he.md

快速开始

{
  "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——它绝不会静默默认为生产环境。从 QA 开始；这是安全且文档化的起始配置。

Related MCP server: mcp-server-smallinvoice

工具（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 主机——没有任意的 base-URL 逃生舱口。

安全模型

• 默认只读 — 除非显式启用写入，否则写入工具完全从 tools/list 中省略。

• 幂等写入 — 强制稳定的 apiIdentifier；重新提交相同请求不会创建第二张收款单。

• 已验证写入 — 每次写入都会重新获取收款单和关联发票，以结构化输出返回之前/新的余额和状态。

• 不盲目重试 不确定的写入结果；通过 apiIdentifier 查找解决。

• 机密卫生 — 正常级别的日志中不包含令牌或客户 PII；QA 测试夹具不包含真实客户数据。

• 无资金流动 — 创建收款单仅记录已收到的资金；服务器无法发起付款或扣款。

状态

已实现 — v0.1 接口。 八个工具（7 个读取 + 1 个受控写入）已实现并注册，如上文工具表所述。覆盖率在 coverage-manifest.json 中跟踪，详情见 docs/。

• QA 状态： 读取工具已根据 Invoice4U API 参考和契约测试验证（120 个单元 + 契约测试通过）。实时 QA 集成因缺少凭据而受阻 — 没有公开的 Invoice4U 沙箱，使用 apiqa.invoice4u.co.il 需要真实的 QA 组织账户 + API 令牌。没有令牌时，受控冒烟测试（tests/integration/qa.spec.ts）会被跳过；参见 docs/qa-testing.md。

• npm 包待发布： 发布等待 npmjs.com 上 @agente-dev/invoice4u-mcp 的可信发布链接。

许可证

MIT — 参见 LICENSE。© Agente Dev LTD。与 Invoice4U 无关联。