Datev mit Cursor verbinden — über MCP

DATEV mit Cursor verbinden

DATEV ist die Software, mit der die meisten deutschen Steuerberatungskanzleien arbeiten. Mit AnythingMCP liest Cursor deine DATEV-Mandanten und ihre Beleg-Einstellungen in DATEV Unternehmen online (DUO) über die offiziellen DATEV Online APIs. Du fragst in normaler Sprache, statt dich durch DATEV zu klicken.

Der Connector liest nur: sechs Tools für Mandantenstammdaten und Beleg-Metadaten. Er bucht nicht, liest keine Lohndaten und lädt keine Belege hoch (mehr dazu in den FAQ unten).

Was du Cursor fragen kannst

• "Liste alle Mandanten, auf die ich in DATEV Zugriff habe." Nutzt datev_list_clients.
• "Zeig mir die Stammdaten der Müller GmbH: Beraternummer, Mandantennummer, Anschrift." Nutzt datev_list_clients, um den Mandanten zu finden, dann datev_get_client.
• "Welche meiner Mandanten nutzen DATEV Unternehmen online für Belege?" Nutzt datev_documents_list_clients.
• "Welche Belegtypen sind für die Müller GmbH eingerichtet?" Nutzt datev_list_document_types.
• "Welche Dateitypen kann die Müller GmbH in DUO hochladen, und welche DUO-Version hat sie?" Nutzt datev_get_duo_version.
• "Vergleiche meine Mandantenliste mit der DUO-Liste: Wer hat noch keinen DUO-Zugang?" Nutzt datev_list_clients und datev_documents_list_clients.

Was du brauchst

• Eine App im DATEV-Entwicklerportal, angelegt als Confidential Client mit dem OpenID Connect Authorization Code Flow. Als Redirect-URI trägst du auf AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback ein, beim Self-Hosting <deine AnythingMCP-URL>/api/mcp-oauth/callback.
• Abos für zwei API-Produkte für diese App: accounting:clients 2.0 und accounting:documents 2.0.
• Client-ID und Client-Secret der App, die in DATEV_CLIENT_ID und DATEV_CLIENT_SECRET kommen. Das Portal zeigt das Secret nur einmal an, kopiere es also vollständig.
• Einen DATEV-Konto-Nutzer mit SmartLogin oder SmartCard/mIDentity. Für diese APIs gibt es bei DATEV keinen Maschinenzugang: Jeder Aufruf läuft im Namen eines echten DATEV-Nutzers, und Cursor sieht nur die Mandanten, die dieser Nutzer sehen darf.
• Die Produktionsfreigabe von DATEV für echte Daten. Jede neue DATEV-App läuft in der Sandbox, bis DATEV sie freigibt. Bis dahin nutzt du den Connector DATEV Online APIs (Sandbox), der auf die Testdaten von DATEV eingestellt ist.

Schritt 1 — DATEV-App anlegen

Registriere dich im DATEV-Entwicklerportal, lege die App wie oben beschrieben an, abonniere accounting:clients 2.0 und accounting:documents 2.0 und notiere Client-ID und Secret.

Schritt 2 — DATEV-Connector installieren

Auf AnythingMCP Cloud öffnest du Connectors, wählst DATEV Online APIs (oder die Sandbox-Variante) und fügst Client-ID und Secret ein.

Wenn du lieber selbst hostest, startest du AnythingMCP mit Docker und installierst den Connector im Store unter http://localhost:3000/connectors/store:

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 — Mit dem DATEV-Konto anmelden

Klicke auf der Connector-Seite auf Authorize with Provider und melde dich mit deinem DATEV-Konto an. AnythingMCP speichert das Refresh-Token verschlüsselt und erneuert Access-Tokens selbstständig. Confidential Clients bekommen bei DATEV rollierende Refresh-Tokens mit zwei Jahren Laufzeit. Jeder Aufruf trägt danach das Access-Token und den Header X-DATEV-Client-Id, den DATEV verlangt; beides setzt du nicht von Hand.

Schritt 4 — 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 DATEV-Tools aufrufen.

Verfügbare Tools

Jedes mandantenbezogene Tool erwartet die UUID des Mandanten als clientId. Cursor holt sie aus datev_list_clients; sie ist nicht dasselbe wie die DATEV_CLIENT_ID deiner App.

Fehlerbehebung

• Die DATEV-Anmeldung klappt, die Verbindung trotzdem nicht. Der Token-Austausch nach der Anmeldung braucht exakt das richtige Client-Secret. DATEV erwartet es per HTTP Basic, das erledigt der Connector; meist ist das Secret unvollständig kopiert oder gehört zu einer anderen App. Erzeuge im Portal ein neues Secret, füge es erneut ein und klicke noch einmal auf Authorize with Provider.
• Aufrufe werden abgelehnt, obwohl du angemeldet bist. Prüfe im Portal, ob die App accounting:clients 2.0 und accounting:documents 2.0 abonniert hat. Die Beleg-Tools brauchen das zweite Produkt.
• Die Sandbox funktioniert, Produktion nicht. Deine App hat noch keine Produktionsfreigabe. Bleib beim Sandbox-Connector, bis DATEV die App freigibt, und wechsle dann mit denselben Zugangsdaten zu DATEV Online APIs.
• Ein Mandant fehlt. datev_list_clients liefert nur die Mandanten, für die dein DATEV-Nutzer Rechte hat, und datev_documents_list_clients nur die mit aktivem DUO-Zugang. Prüf die Rechte des Nutzers in DATEV, nicht den Connector.

FAQ

Kann Cursor in DATEV buchen oder Belege hochladen? Nein. Der Connector liest nur Mandantenstammdaten und Beleg-Einstellungen. Der Beleg-Upload nach DUO braucht binäre Datei-Uploads, die die Connector-Engine noch nicht beherrscht, und Buchungen, Lohn und DMS sind eigene DATEV-API-Produkte, die dieser Connector nicht abdeckt.

Ist das kostenlos? AnythingMCP ist Open Source unter AGPL-3.0: Self-Hosting ist kostenlos, auch für die kommerzielle Nutzung in deinem eigenen Unternehmen. AnythingMCP Cloud kannst du 7 Tage kostenlos testen. Der Zugang zu DATEV selbst richtet sich nach deinem DATEV-Vertrag und den Bedingungen des Entwicklerportals.

Speichert AnythingMCP meine Daten? Dein DATEV-Client-Secret und das Refresh-Token liegen verschlüsselt (AES-256-GCM) in deinem Workspace und werden Cursor nie gezeigt. Wenn Cursor ein Tool nutzt, ruft AnythingMCP DATEV auf und gibt das Ergebnis an Cursor weiter; der Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet; wenn die Daten deine eigene Infrastruktur nicht verlassen dürfen, hostest du AnythingMCP selbst.

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

Nächste Schritte

• DATEV-MCP-Server für andere KI-Clients
• DATEV mit Claude verbinden
• DATEV mit ChatGPT verbinden
• DATEV mit Gemini verbinden
• DATEV mit Meta Muse verbinden