QuickBooks Online über MCP mit Gemini verbinden

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

QuickBooks Online + Gemini

Lass deine KI mit QuickBooks Online arbeiten: Kunden, Lieferanten, Artikel, Rechnungen, Eingangsrechnungen, Zahlungen und Konten abfragen, einzelne Datensätze lesen, Berichte wie Gewinn- und Verlustrechnung, Bilanz und Fälligkeitslisten für Forderungen und Verbindlichkeiten abrufen sowie Kunden und Rechnungen anlegen. Anmeldung über Intuit OAuth, mit einer Sandbox- oder Produktivfirma.

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:

QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REALM_ID, QBO_API_URL

Schritt 1 — Zugangsdaten holen

1. Melde dich bei developer.intuit.com an, öffne My Hub → App dashboard → Create an app, wähle QuickBooks Online and Payments und dann den Scope com.intuit.quickbooks.accounting.
2. Füge unter Settings → Redirect URIs die Adresse https://cloud.anythingmcp.com/api/mcp-oauth/callback für Development und später auch für Production hinzu. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Die URI muss exakt übereinstimmen.
3. Kopiere Client ID und Client Secret aus Keys & credentials in QBO_CLIENT_ID und QBO_CLIENT_SECRET. Development-Keys funktionieren nur mit Sandbox-Firmen. Production-Keys funktionieren mit echten Firmen; Intuit vergibt sie nach einer kurzen Prüfung der App (einem Fragebogen im App-Dashboard).
4. Ermittle die realm id (Company ID) der Firma: Klicke in QuickBooks auf das Zahnradsymbol, öffne Account and settings → Billing & subscription und kopiere die Company ID ohne Leerzeichen. Bei einer Sandbox-Firma findest du sie auf der Entwicklerseite unter Sandboxes. Trage sie in QBO_REALM_ID ein.
5. Setze QBO_API_URL für eine echte Firma auf https://quickbooks.api.intuit.com oder für eine Sandbox-Firma auf https://sandbox-quickbooks.api.intuit.com. Die URL muss zu den Keys passen: Development-Keys mit der Sandbox-URL, Production-Keys mit der Produktiv-URL.
6. Installiere den Connector, klicke auf der Connector-Seite auf Authorize with Provider, melde dich bei Intuit an und verbinde dieselbe Firma.
7. Beginne mit qbo_get_company_info und prüfe den Firmennamen, bevor die KI etwas liest oder schreibt. Ein Connector arbeitet mit genau einer Firma; für eine zweite Firma installierst du ihn erneut.

Angemeldet bleiben: Access-Tokens gelten eine Stunde und werden automatisch erneuert. Ein Refresh-Token, der 100 Tage lang nicht genutzt wird, läuft ab, und jede Autorisierung endet spätestens nach 5 Jahren. Danach, oder wenn die App in QuickBooks getrennt wurde, klickst du erneut auf Authorize with Provider. Nutze dieselbe Intuit-App nicht gleichzeitig in einem anderen Tool: Intuit ersetzt den Refresh-Token etwa einmal am Tag, und eines der beiden Tools bliebe mit einem veralteten Token zurück.

Berechtigungen und Nur lesen: Der Scope com.intuit.quickbooks.accounting gibt Lese- und Schreibzugriff auf die Buchhaltungsdaten, soweit die Rolle des QuickBooks-Benutzers, der sich anmeldet, das erlaubt. Intuit hat keinen reinen Lese-Scope für die Buchhaltung. Für ein Nur-lesen-Setup meldest du dich mit einem Benutzer an, dessen Rolle keine Transaktionen anlegen darf, und deaktivierst qbo_create_customer, qbo_update_customer und qbo_create_invoice.

Bei der Installation ausgeschaltet: qbo_send_invoice, das eine Rechnung im Namen deiner Firma per E-Mail an den Kunden schickt, und qbo_delete_invoice. Schalte sie nur ein, wenn die KI Rechnungen senden oder löschen soll.

Rechnungen werden sofort gebucht: QuickBooks kennt keine Rechnungsentwürfe. Eine Rechnung, die die KI anlegt, erhöht sofort den Saldo des Kunden und erscheint direkt in den Berichten, wird aber nicht per E-Mail verschickt. Kunden lassen sich nicht löschen, nur inaktiv setzen.

Kundennamen: Der Anzeigename eines Kunden muss über Kunden, Lieferanten und Mitarbeiter hinweg eindeutig sein und darf keinen Doppelpunkt (QuickBooks trennt Unterkunden mit Doppelpunkten), keinen Tabulator und keinen Zeilenumbruch enthalten.

Häufige Fehler: 401 AuthenticationFailed (3200) heißt, dass die Autorisierung abgelaufen ist oder widerrufen wurde oder dass QBO_API_URL nicht zu den Keys passt: Prüfe die URL und klicke dann erneut auf Authorize with Provider. 403 ApplicationAuthorizationFailed (3100) heißt, dass die realm id zu einer Firma gehört, für die diese Anmeldung nicht freigegeben wurde, oder dass die Rolle des Benutzers keinen Zugriff hat. 400 QueryParserError heißt, dass eine Abfrage einen Syntaxfehler enthält. 6240 Duplicate Name Exists Error heißt, dass der Anzeigename schon vergeben ist; 2040 Invalid String heißt, dass ein Name einen Doppelpunkt, einen Tabulator oder einen Zeilenumbruch enthält; 5010 Stale Object Error heißt, dass sich der Datensatz inzwischen geändert hat und neu gelesen werden muss. 429 heißt, dass das Limit von 500 Anfragen pro Minute erreicht ist: Warte eine Minute.

Der Connector unterstützt keine Rechnungs-PDFs und Anhänge, kein Erfassen von Zahlungen, keine Bankfeeds, keine Lohnabrechnung und kein QuickBooks Desktop, und er löscht nichts außer Rechnungen.

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 QuickBooks Online-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Rechnungen sind überfällig, und wie viel schuldet uns jeder Kunde?“
• „Zeig mir die Gewinn- und Verlustrechnung für dieses Geschäftsjahr, Monat für Monat.“
• „Erstelle eine Rechnung für Acme Ltd: 10 Stunden der Leistung Beratung, fällig in 30 Tagen.“
• „Welche Lieferantenrechnungen sind seit mehr als 60 Tagen überfällig?“

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