DATEV Sandbox MCP mit Cursor verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → DATEV Online APIs (Sandbox), füge deine Zugangsdaten ein, erzeuge einen MCP-API-Schlüssel — fertig. Kein Docker, kein git clone, kein lokaler Server.

DATEV Online APIs (Sandbox) + Cursor

Sandbox-Umgebung für die DATEV Online APIs — lies Buchhaltungs-Mandanten, Belegtypen und DUO-Versionsmetadaten gegen die Testdaten von DATEV. Nutze sie während der Entwicklung und beim Testen; jede neue DATEV-App muss in der Sandbox laufen, bis DATEV die Freigabe für die Produktion erteilt. Derselbe OAuth2-Authorization-Code-Flow mit PKCE wie in der Produktion, nur auf die Sandbox-Endpunkte von DATEV ausgerichtet.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector hinterlegt (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 10 Minuten. Du brauchst eine App im DATEV-Entwicklerportal und ein DATEV-Konto zum Anmelden.

1. Erstelle im DATEV-Entwicklerportal (https://developer.datev.de) eine Confidential-App mit OpenID Connect Authorization Code Flow. Setze die Redirect-URI auf <your AnythingMCP URL>/api/mcp-oauth/callback (bei AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback).
2. Abonniere die App für die Sandbox-API-Produkte accounting:clients 2.0 und accounting:documents 2.0.
3. Kopiere die Client-ID in DATEV_CLIENT_ID und das Client-Secret in DATEV_CLIENT_SECRET. Kopiere das Secret vollständig: Das Portal zeigt es nur ein einziges Mal an.
4. Installiere den Connector. Er ist bereits für die Sandbox-Endpunkte von DATEV eingerichtet und authentifiziert sich am Token-Endpunkt mit HTTP Basic (client_secret_basic), was DATEV verlangt.
5. Klicke auf der Connector-Seite auf Authorize with Provider und melde dich mit deinem DATEV-Konto an. Diese Anmeldung ist einmalig: Das Refresh-Token wird anschließend verschlüsselt gespeichert.
6. Führe datev_list_clients aus: Das Tool listet die Mandanten auf, für die dein DATEV-Konto-Benutzer freigeschaltet ist, mit UUID, Beraternummer, Mandantennummer und Name.

Sandbox, nicht Produktion: Jede DATEV-App läuft in der Sandbox, bis DATEV die Prüfung für die Produktionsfreigabe abgeschlossen hat. Hier entwickelst und testest du also. Sobald DATEV deine App für die Produktion freigibt, verwende den separaten Connector DATEV Online APIs: Er nutzt dieselben Zugangsdaten und zeigt auf die Produktions-Endpunkte.

Scopes: Der Connector fordert datev:accounting:clients accounting:clients:read accounting:documents an. Füge nicht openid hinzu: Das ist der Name des Issuers, kein Scope.

Zwei Arten von Client-IDs: Jedes Tool pro Mandant erwartet eine clientId, die Mandanten-UUID, die datev_list_clients zurückgibt. Sie ist nicht dasselbe wie DATEV_CLIENT_ID, die deine OAuth-App identifiziert und bei jedem Aufruf zusammen mit dem Bearer-Token im Header X-DATEV-Client-Id gesendet wird.

Was gelesen wird: die Stammdaten eines Mandanten (Berater- und Mandantennummer, Name, Adresse); die Mandanten mit Dokumentenzugriff auf DATEV Unternehmen online (DUO), die weniger als alle sein können, weil nur Mandanten mit aktivem DUO-Abonnement erscheinen; die Belegtypen eines Mandanten; und die DUO-Version mit den Dateiendungen, die DUO für den Upload akzeptiert. Alle sechs Tools lesen nur.

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 DATEV Online APIs (Sandbox)-Tools aufrufen.

Verfügbare Tools

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