Invoice4U MCP von Agente

Ein inoffizieller, von Drittanbietern bereitgestellter Model Context Protocol-Server, der jedem MCP-kompatiblen Agenten sicheren, typisierten Zugriff auf ein Invoice4U-Konto bietet – Suchen von Dokumenten und Kunden sowie Erstellen von Belegen, die mit bezahlten Rechnungen verknüpft sind.

• Inoffiziell: Dies ist eine Community-Integration, weder mit Invoice4U verbunden, noch von Invoice4U unterstützt, noch von Invoice4U befürwortet. Invoice4U-Namen werden als Namen verwendet, um zu beschreiben, womit der Server verbunden ist. Ohne Erlaubnis werden keine Invoice4U-Marken oder -Logos verwendet.

• TypeScript / Node.js 24 LTS / MIT · stdio-Transport · lokal selbst gehostet — Agente verwahrt Ihre Invoice4U-Zugangsdaten niemals.

• Standardmäßig schreibgeschützt: Das einzige Schreibwerkzeug (Belegerstellung) ist nicht in tools/list registriert, es sei denn, INVOICE4U_ALLOW_WRITES=true.

• Englisch README · Hebräisch README.he.md

Schnellstart

{
  "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 muss explizit qa oder production sein — es wird niemals stillschweigend auf production zurückgegriffen. Beginnen Sie mit QA; dies ist die sichere dokumentierte Startkonfiguration.

Related MCP server: mcp-server-smallinvoice

Werkzeuge (v0.1-Oberfläche)

Lesewerkzeuge deklarieren readOnlyHint: true, idempotentHint: true. Das Schreibwerkzeug deklariert readOnlyHint: false, destructiveHint: false, idempotentHint: true — Idempotenz gilt nur, weil eine stabile apiIdentifier obligatorisch ist und doppelte oder unsichere Ergebnisse über die Identifikatorsuche aufgelöst werden. Eine Zeitüberschreitung nach dem Senden eines Schreibvorgangs wird niemals blind wiederholt: Der Server fragt zuerst per apiIdentifier ab und wiederholt nur, wenn die Suche beweist, dass kein Dokument existiert.

Geldbeträge werden an der MCP-Grenze als Dezimalzeichenfolgen ausgedrückt ("12500.00"), niemals als JavaScript-Fließkommazahlen. Invoice4U-Antworten, die HTTP 200 zurückgeben, aber Anwendungsfehler in der Errors-Sammlung enthalten, werden in ein typisiertes Fehlermodell normalisiert — niemals als Erfolg gemeldet.

Konfiguration

Anmeldeinformationen leben nur in Umgebungsvariablen — das Token wird niemals als Werkzeugargument akzeptiert, niemals zurückgegeben, niemals protokolliert.

Siehe .env.example. Es werden nur geprüfte offizielle Invoice4U-Hosts kontaktiert — es gibt keine beliebige Basis-URL-Ausweichmöglichkeit.

Sicherheitsmodell

• Standardmäßig schreibgeschützt — das Schreibwerkzeug wird vollständig aus tools/list ausgelassen, es sei denn, Schreibvorgänge sind explizit aktiviert.

• Idempotente Schreibvorgänge — obligatorische stabile apiIdentifier; das erneute Senden derselben Anfrage kann keinen zweiten Beleg erstellen.

• Verifizierte Schreibvorgänge — jeder Schreibvorgang ruft den Beleg und die referenzierten Rechnungen erneut ab und gibt vorherige/neue Salden und Status als strukturierte Ausgabe zurück.

• Keine blinden Wiederholungen bei unsicheren Schreibvorgängen; die Auflösung erfolgt über die apiIdentifier-Suche.

• Geheimnishygiene — keine Tokens oder Kundendaten (PII) in Protokollen auf normalen Ebenen; QA-Fixtures enthalten keine echten Kundendaten.

• Keine Geldbewegungen — das Erstellen eines Belegs erfasst bereits erhaltenes Geld; der Server kann keine Zahlungen initiieren oder Karten belasten.

Status

Implementiert — v0.1-Oberfläche. Acht Werkzeuge (7 Lese- + 1 gesperrtes Schreibwerkzeug) sind implementiert und registriert, wie in der obigen Werkzeugtabelle beschrieben. Die Abdeckung wird in coverage-manifest.json verfolgt, mit Details in docs/.

• QA-Status: Lesewerkzeuge sind gegen die Invoice4U-API-Referenz sowie Vertragstests verifiziert (120 Einheiten- und Vertragstests grün). Live-QA-Integration ist BLOCKIERT, bis Anmeldeinformationen vorliegen — es gibt keine öffentliche Invoice4U-Sandbox, und die Nutzung von apiqa.invoice4u.co.il erfordert ein echtes QA-Organisationskonto + API-Token. Der gesperrte Smoke-Test (tests/integration/qa.spec.ts) wird ohne Token übersprungen; siehe docs/qa-testing.md.

• npm-Paket ausstehend: Die Veröffentlichung wartet auf den Trusted-Publishing-Link für @agente-dev/invoice4u-mcp auf npmjs.com.

Lizenz

MIT — siehe LICENSE. © Agente Dev LTD. Nicht mit Invoice4U verbunden.