Invoice123 über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Invoice123 klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Invoice123 + Gemini

Invoice123 (Saskaita123), Rechnungsstellung für Litauen und Lettland, nur lesend: Ausgangsrechnungen mit Zahlungen, Zahlungslinks und PDFs, Einkäufe, Kunden, Produkte, Projekte, Lieferscheine, MwSt-Sätze, Nummernkreise und Bankkonten.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

INVOICE123_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Invoice123-Konto (in Litauen Saskaita123), in dem du Integrationen installieren kannst.

1. Öffne in Invoice123 das Kontomenü (oben rechts), dann Integrations (Puzzle-Symbol) oder Account settings > Integrations, und installiere die Integration API.
2. Klick auf Generate your API key, gib dem Schlüssel einen Namen und hake die Berechtigungen an, die die KI nutzen darf: mindestens invoice:index, dazu expense:index, client:index, product:index, project:index und waybills:index für diese Bereiche. Das Rechnungs-PDF prüft invoice:store, das Angebots-PDF commercial:store.
3. Füge nur den Schlüssel in INVOICE123_API_TOKEN ein, ohne das Wort Bearer, Leerzeichen oder Anführungszeichen. Der Connector schickt ihn als Authorization: Bearer.
4. Installiere den Connector und rufe invoice123_get_company auf, um den Token zu prüfen.

Was er liest: Ausgangsrechnungen mit Kunde, Positionen, MwSt, Summen, Währung, Zahlungen und Bezahlt-Kennzeichen; die Zahlungen einer Rechnung, also wie und wann sie bezahlt wurde (Überweisung, bar, Karte, Kassenbon); den Online-Zahlungslink einer Rechnung, wenn die Firma Montonio oder Paysera aktiviert hat; Rechnungs- und Angebots-PDFs auf Litauisch, Englisch oder Lettisch; Eingangsrechnungen (Ausgaben) mit Ausgabenarten, MwSt und Zahlungen; Kunden und Lieferanten; den Produktkatalog mit Preisen und Bestand pro Lager; Projekte mit Budget; Lieferscheine; und die Stammdaten: Nummernkreise, MwSt-Sätze für Verkauf und Einkauf, Bankkonten, Einheiten, Tätigkeiten, Kassen und E-Mail-Vorlagen.

So arbeitet die KI damit: Braucht sie IDs, liest sie zuerst die Stammdaten, in einem Aufruf mit invoice123_get_invoice_data (Tätigkeiten, Nummernkreise, Banken, Einheiten, MwSt-Sätze und Lager) oder Liste für Liste. Für offene Posten filtert sie invoice123_list_invoices nach status unpaid oder late, für einen Zeitraum nach range und für einen Kunden nach client_id; invoice123_list_invoice_payments zeigt dann, wie eine Rechnung beglichen wurde.

Nur lesend: Alle 21 Tools lesen nur. In Invoice123 wird nichts ausgestellt, verschickt oder geändert, deshalb gibt es nichts zu bestätigen, und kein Tool ist bei der Installation ausgeschaltet.

Seiten, Datum und Beträge: Listen liefern data.result und data.pagination (current_page, last_page, total); die KI übergibt page (ab 1) und limit (Standard 20) und hört bei last_page auf. Ein Zeitraum sind zwei YYYY-MM-DD-Daten, durch ein Komma verbunden. Beträge sind Zeichenketten in der Rechnungswährung, meist EUR.

Limits: 60 Anfragen pro Minute im Tarif Standard, 1.000 pro Stunde im Tarif Business. Darüber antwortet Invoice123 mit 429.

Häufige Fehler: 401 heißt, dass der Token falsch ist oder gelöscht wurde. 403 heißt, dass dem Token die Berechtigung fehlt, die in der Tool-Beschreibung steht; Einkäufe, Lieferscheine und Angebote brauchen außerdem ihr Modul im Konto.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Invoice123-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Rechnungen sind überfällig, über welche Beträge und für welche Kunden?“
• „Wie und wann wurde die letzte Rechnung an UAB Pavyzdys bezahlt?“
• „Liste die Eingangsrechnungen dieses Monats nach Ausgabenart mit ihrer MwSt auf.“
• „Gib mir den Online-Zahlungslink für die offene Rechnung von UAB Pavyzdys.“
• „Lade das PDF unserer letzten Rechnung auf Englisch herunter.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden