Invompt MCP

Invompt MCP ist ein Pre-1.0-Paket in der lokalen Beta-Phase, um Claude Code und Codex in die Invompt-Rechnungstools einzuarbeiten. Es bietet portable Skills, eine Setup-CLI und eine Guest-stdio-Brücke; Invompt behält Rechnungsregeln, Persistenz, Rendering und gehostete Dokumentlinks bei.

Diese Quelle bereitet invompt-mcp@0.11.2 nur für den next-Kanal vor. Sie erhebt keinen Anspruch auf Release, Produktion, Registry-Verfügbarkeit oder Kompatibilität mit frischen Hosts. Überprüfen Sie den externen Zustand unabhängig, bevor Sie sich auf ein Registry-Artefakt verlassen.

Unterstützte lokale Beta-Hosts

Die lokale Beta ist auf macOS Claude Code und Codex beschränkt. Deren Paketmanifeste legen nur Skills offen; sie installieren keinen statischen MCP-Transport, weil der Benutzer zuerst den Verbindungsmodus wählen muss.

Der lokale Loopback-Entwicklungsendpunkt ist http://localhost:3101/mcp; er dient der Entwicklung und ist keine öffentliche Host-Standardkonfiguration. Gemini CLI- und Qwen Code-Dateien sind nur Vorlagen und keine unterstützten lokalen Beta-Laufzeiten.

ChatGPT web ist getrennt: Es ist nur remote per OAuth unter https://mcp.invompt.com/mcp verfügbar. Es darf niemals lokalen Status/Setup ausführen, eine Guest-Brücke verwenden oder lokalen Gerätezustand prüfen.

Die CLI dieses Repositorys ist eine separate lokale Beta-Distribution. Sie konfiguriert nur invompt-local-beta; Setup, Logout, Reset und Abgleich entfernen oder ändern niemals invompt. Der globale Workspace-Hub-Verbraucher bleibt ein gehosteter HTTPS-OAuth-only-invompt-Anbieter.

Related MCP server: Invoices Generator MCP Server

Setup

Vor einem Invompt-MCP-Aufruf prüft der Onboarding-Skill den redigierten Status. Wenn der Modus unentschieden ist, fragt er genau, ob Sie Guest oder OAuth in der aktuellen Gesprächssprache möchten, und wartet auf Ihre explizite Wahl.

Für Codex führen Sie einen gewählten Befehl aus:

npx --yes invompt-mcp@0.11.2 setup --host codex --mode guest
npx --yes invompt-mcp@0.11.2 setup --host codex --mode oauth

Für Claude Code verwenden Sie dieselbe gepinnte Paket-CLI, anstatt einen installierten Cache-Pfad anzunehmen:

npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode guest
npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode oauth

Verwenden Sie status --json über denselben aktuellen Host-Befehl, um den redigierten Zustand zu prüfen. Es gibt keine Postinstall-Eingabeaufforderung und keine Anmeldedaten in einem Manifest oder einer Host-Konfiguration.

Der resultierende MCP-Server heißt auf beiden Hosts invompt-local-beta. Halten Sie den normalen globalen invompt-Anbieter getrennt und nur OAuth.

Plugin- und Skill-Erkennung verwenden denselben isolierten Namespace: Plugin invompt-local-beta, mit Skills invompt-local-beta-onboarding und invompt-local-beta-invoice. Das Paket wird nicht als globales Plugin invompt oder als globaler Skill invompt-invoice, invompt-export oder invompt-health erkannt.

Guest ist auf macOS Keychain-first (com.invompt.invompt-mcp / guest-credential). Nur wenn Sie den Fallback explizit erlauben, darf das Setup --allow-file-fallback hinzufügen; der Fallback ist Klartext mit eingeschränkten Berechtigungen unter ~/.invompt/guest-credential (Modus 0600). Nicht-geheimer lokaler Zustand ist ~/.invompt/auth-state.json (Modus 0600 in einem 0700-Verzeichnis).

Der Wechsel von Guest zu OAuth lässt das Guest-Geheimnis ruhen. Es wird niemals automatisch konvertiert, beansprucht oder in ein Konto zusammengeführt. Verwenden Sie logout --host codex oder logout --host claude-code für einen bewussten Host-Logout. reset --yes entfernt lokalen Zustand und versucht eine Guest-Widerrufung; wenn der Widerruf den Dienst nicht erreichen kann, können kopierte Anmeldedaten gültig bleiben, und die CLI meldet diese Warnung.

Der Transportmodus ist getrennt vom Kontotyp: Gehosteter OAuth-Guest und Legacy-Credential-Guest sind beide Guest-Prinzipale. Eine explizite Konto-Übernahmeanfrage ruft das Claim-Tool einmal auf; das Backend entscheidet über die Berechtigung. Nach einem OAuth-Guest-Claim bleibt die Gewährung verbunden und validiert den registrierten Zustand erneut; nach einem Legacy-Guest-Claim schlägt die alte Anmeldedaten mit GUEST_ACCOUNT_CLAIMED fehl.

Migration und Rollback

0.11.2 fügt eine nullable Update-Link-Wiederherstellung hinzu: Ein committetes update_invoice kann url: null mit linkState: unavailable melden, wenn die Fähigkeitssuche ein Erneuerungsrennen verliert, also erneuern Sie den Link, ohne das Update zu wiederholen. Es migriert keinen bestehenden globalen OAuth-only-Verbraucher. Wählen Sie bewusst einen lokalen Beta-Modus. --allow-file-fallback ist nur mit setup --mode guest gültig, und unbekannte oder doppelte Flags werden abgelehnt. Um den lokalen Beta-Zustand zurückzurollen, führen Sie zuerst logout --host … aus; verwenden Sie reset --yes nur, wenn Sie auch lokalen Authentifizierungszustand entfernen und eine Guest-Widerrufung versuchen möchten. Stellen Sie den Workspace-Hub-Verbraucher über seinen eigenen OAuth-only-Installer wieder her, nicht über diese CLI.

Fehler und Datenschutz

• Offline-/Netzwerkfehler und 5xx-Antworten sind vorübergehende Fehler; Schleifen Sie nicht und wiederholen Sie die Ausstellung von Anmeldedaten nicht stillschweigend.

• 401 bedeutet, dass eine Guest-Anmeldedaten ungültig oder widerrufen ist; verwenden Sie einen bewussten Reset/Wiederherstellung vor einem weiteren Setup-Versuch, insbesondere wenn das aufgezeichnete Geheimnis-Backend nicht verfügbar ist.

• 429 respektiert Retry-After; wiederholen Sie nicht davor.

• Ein Host-CLI-Fehler lässt das Setup abgleichsbedürftig; behaupten Sie nicht, der Host sei konfiguriert.

Invompt MCP leitet keinen Hardware- oder Geräte-Fingerprint ab und sammelt keine Seriendaten oder MAC-Adressen. Die vom Server ausgestellte Guest-Anmeldedaten ist die einzige pseudonyme lokale Identität; sie wird standardmäßig in der Keychain gespeichert und niemals zur Ableitung der Geräteidentität verwendet. Sie hat nach dem Bündeln keine Laufzeitabhängigkeiten, öffnet keinen Listener und führt keine Rechnungs-Geschäftslogik aus. Sie leitet JSON-RPC nur über den explizit gewählten Transport weiter und lehnt HTTP-Redirects ab.

Entwicklungsverifikation

Verwenden Sie Node.js 22.22.0 und npm 11.11.0 für die kanonischen Paket-Gates:

npm ci
npm run check

Die Prüfungen bauen, typisieren, linten, testen, scannen Quell- und gepackte Artefakte auf Geheimnis-/Datenschutzregressionen, verifizieren die exakte Paket-Allowlist und testen einen isolierten Nur-Tarball-Verbraucher. Lokale Prüfungen beweisen keine externe Veröffentlichung oder Frisch-Host-Installation.