Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Quaderno mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Steuere Steuern und Rechnungen in Quaderno aus deiner KI: Umsatzsteuer, VAT und GST für jeden Ort berechnen, USt-IdNrn. prüfen, Kontakte, Rechnungen, Gutschriften, Angebote, Ausgaben und Produkte durchsuchen, Rechnungen ausstellen und per E-Mail versenden und Steuerberichte anfordern.
Frag einfach
Beispiel-Prompts für Quaderno
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Quaderno klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Quaderno + Gemini
Steuere Steuern und Rechnungen in Quaderno aus deiner KI: Umsatzsteuer, VAT und GST für jeden Ort berechnen, USt-IdNrn. prüfen, Kontakte, Rechnungen, Gutschriften, Angebote, Ausgaben und Produkte durchsuchen, Rechnungen ausstellen und per E-Mail versenden und Steuerberichte anfordern.
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:
QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
Schritt 1 — Zugangsdaten holen
- Melde dich unter
https://quadernoapp.coman und öffne Profile → API keys (https://quadernoapp.com/users/api-keys). - Kopiere den privaten Key, der mit
sk_beginnt, inQUADERNO_API_KEY. Der öffentliche Key (pk_) funktioniert hier nicht. Der Key wird als Benutzername für HTTP Basic mit leerem Passwort gesendet, und zwar nur an dein Quaderno-Konto. - Dieselbe Seite zeigt deine API-URL, zum Beispiel
https://acme-1234.quadernoapp.com/api/. Trag den Teil vor.quadernoapp.com(hieracme-1234) inQUADERNO_ACCOUNT_NAMEein und installiere den Connector. - Prüfe die Einrichtung mit
quaderno_ping: Es bestätigt den Key und zeigt die verbleibenden Anfragen im aktuellen Zeitfenster.
Rechnungen werden nur nach deinem Ja ausgestellt und versendet: Eine ausgestellte Rechnung ist ein steuerlicher Beleg. Quaderno nummeriert sie fortlaufend, und sie lässt sich nicht löschen, nur in der Quaderno-App stornieren oder gutschreiben. Vor quaderno_create_invoice zeigt dir die KI Kunde, Positionen, Preise und Währung. Vor quaderno_deliver_invoice, das die Rechnung sofort per E-Mail an den Kunden schickt und sich nicht zurückholen lässt, sagt sie dir, welche Rechnung an welche Adresse geht. Auch quaderno_create_contact und quaderno_request_report fragen vorher. Eine Rechnung anzulegen verschickt sie noch nicht. quaderno_delete_contact ist bei der Installation ausgeschaltet.
Steuerberechnung: quaderno_calculate_tax liefert Umsatzsteuer, VAT oder GST für einen Verkauf an jeden Ort: Steuerbezeichnung, Satz, Steuerbetrag, Zwischensumme und Gesamtbetrag, die Steuerhoheit bis hinunter zur Stadt und Hinweise wie Reverse Charge bei einer gültigen EU-USt-IdNr. Es rechnet nur und speichert nichts. quaderno_validate_tax_id prüft eine USt-IdNr. oder Unternehmensnummer gegen das amtliche Register ihres Landes (EU-VIES, Vereinigtes Königreich, Schweiz, Québec, Australien, Neuseeland).
Was er liest: Kontakte, Rechnungen, Gutschriften, Angebote (bei Quaderno Proformas), Ausgaben, Produkte, Steuerhoheiten und Steuercodes. Steuerberichte (vereinnahmte Steuern je Steuerhoheit für deine Erklärungen, eine Rechnungsliste oder eine Gutschriftenliste) entstehen im Hintergrund: Die KI fordert einen für einen Zeitraum an, prüft, bis er fertig ist, und gibt dir den Download-Link.
Sensible Daten: Rechnungen und Kontakte enthalten Namen, Adressen und Steuernummern deiner Kunden und sind steuerliche Aufzeichnungen. Gib sie nur an die Personen weiter, die sich um die Abrechnung kümmern.
Beträge: Felder mit der Endung _cents sind in Cent (12345 sind 123,45); Preise und die Ergebnisse der Steuerberechnung sind in der Währungseinheit.
Ratenlimit: 100 Aufrufe pro 15 Sekunden. Ein 429 heißt: warten, bis das Zeitfenster zurückgesetzt ist.
Häufige Fehler: 401 Wrong API key or the user does not exist: Der Key ist falsch, es ist der pk_-Key, oder er gehört zu einem anderen Konto als QUADERNO_ACCOUNT_NAME. 406: ein ungültiger Wert, etwa ein unbekannter Steuercode. 422: Der Beleg lässt sich so nicht anlegen, zum Beispiel ohne Positionen.
Nicht enthalten: Rechnungen ändern, stornieren oder als uneinbringlich markieren, Zahlungen erfassen, Quittungen, wiederkehrende Belege, Transaktionen, Checkout-Sessions und Gutscheine, Nachweise, Webhooks, die Sandbox und Quaderno-Connect-Konten.
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 AnleitungYOUR_SERVER_IDzeigt.
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" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal):anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
Quaderno-Tools aufrufen.
Verfügbare Tools
| Tool | What it does |
|---|---|
quaderno_ping | Check that the API key works and see the requests left in the current rate-limit window |
quaderno_list_contacts | List or search customers and suppliers (contacts) by name, email or tax id: id, kind (person or company), name, email, tax id and tax… |
quaderno_get_contact | Get one contact with full address, phone, website, language, default discount, notes and the link to their billing area |
quaderno_create_contact | Create a customer or supplier contact |
quaderno_delete_contact | Delete one contact for good |
quaderno_list_invoices | List or search invoices by number, customer name or PO number, issue date range, state or customer: id, number, dates, state (outstanding… |
quaderno_get_invoice | Get one invoice in full: customer and billing address, line items with their taxes, the tax breakdown, payments, deliveries, alerts, the… |
quaderno_create_invoice | Issue a new invoice |
quaderno_deliver_invoice | Email an invoice to its customer from Quaderno, with the PDF and the link to it |
quaderno_list_credit_notes | List or search credit notes (refunds and corrections of invoices) by number, customer name or PO number, issue date range or state: id… |
quaderno_get_credit_note | Get one credit note in full: customer, line items, tax breakdown, payments, deliveries, the related invoice, the public link and the PDF… |
quaderno_list_quotes | List or search quotes (Quaderno calls them proformas; they replaced estimates) by number, customer name or PO number, issue date range… |
quaderno_get_quote | Get one quote (proforma) in full: customer, line items, tax breakdown, validity, the public link and the PDF link |
quaderno_list_expenses | List or search expenses (purchase invoices from suppliers) by number, supplier name or PO number, issue date range, state or supplier: id… |
quaderno_list_products | List or search products (items) by name or code: id, code, name, description, unit cost, currency, kind (one-off or subscription), product… |
quaderno_calculate_tax | Calculate the sales tax, VAT or GST for a sale to a customer location: tax name, rate, taxable part, tax amount, subtotal and total, the… |
quaderno_validate_tax_id | Check a business tax id against the official registry of its country (EU VIES, UK, Switzerland, Quebec, Australia, New Zealand): returns… |
quaderno_list_tax_jurisdictions | List the tax jurisdictions Quaderno knows, optionally for one country or region: id, name, country and region |
quaderno_list_tax_codes | List the tax codes products can be classified with (e.g. eservice, saas, ebook, consulting, standard, reduced, exempt): id, name and what… |
quaderno_list_reports | List the reports requested so far: id, type (tax_summary, invoices_list, credits_list), state, period, when it completed and the download… |
quaderno_request_report | Ask Quaderno to build a report for a period: tax_summary (taxes collected per jurisdiction, for filing returns), invoices_list or… |
quaderno_get_report | Check one report request: state (pending, suceeded or failed), period, when it completed and the report_url to download it once ready |
Beispiel-Prompts
- „Welche Umsatzsteuer gilt für ein SaaS-Abo für 49 EUR an eine Privatperson in Lyon, Frankreich? Und an ein Unternehmen dort mit gültiger USt-IdNr.?“
- „Ist die USt-IdNr. DE123456789 gültig?“
- „Welche Rechnungen sind noch offen oder überfällig, und wie viel macht das je Währung aus?“
- „Stell Northwind GmbH eine Rechnung über 10 Stunden Beratung zu 120 EUR pro Stunde aus. Zeig mir vorher alles und verschick sie noch nicht.“
- „Fordere einen Steuerbericht (Tax Summary) für das dritte Quartal an und gib mir den Download-Link, sobald er fertig ist.“
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
War dieser Guide hilfreich?
