Quaderno über MCP mit Cursor verbinden

💡 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 + Cursor

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

1. Melde dich unter https://quadernoapp.com an und öffne Profile → API keys (https://quadernoapp.com/users/api-keys).
2. Kopiere den privaten Key, der mit sk_ beginnt, in QUADERNO_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.
3. Dieselbe Seite zeigt deine API-URL, zum Beispiel https://acme-1234.quadernoapp.com/api/. Trag den Teil vor .quadernoapp.com (hier acme-1234) in QUADERNO_ACCOUNT_NAME ein und installiere den Connector.
4. 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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Quaderno-Tools aufrufen.

Verfügbare Tools

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden