DATEV MCP: DATEV mit KI-Agenten verbinden

DATEV mit KI-Agenten verbinden

DATEV ist die Buchhaltungs- und Steuersoftware, mit der die meisten deutschen Steuerberater und viele ihrer Mandanten arbeiten. AnythingMCP macht aus den offiziellen DATEV Online APIs einen MCP-Server, damit Claude, ChatGPT und andere MCP-Clients DATEV-Daten über Tools lesen können, statt über Screenshots und Exporte.

Was der DATEV-Connector heute abdeckt: sechs lesende Tools auf zwei DATEV-API-Produkten, accounting:clients (Mandantenstammdaten) und accounting:documents (DATEV Unternehmen online, DUO). Er schreibt nichts in DATEV, und Lohn, Buchungen und DMS gehören nicht dazu.

Was du fragen kannst

Diese Prompts funktionieren in jedem MCP-Client, der mit dem DATEV-Server verbunden ist; das genutzte Tool steht jeweils in Klammern.

• "Wie viele Mandanten sehe ich in DATEV, und welche Mandantennummern haben sie?" (datev_list_clients)
• "Welche Anschrift ist für Mandant 10023 hinterlegt?" (datev_list_clients, dann datev_get_client)
• "Welche Mandanten haben Belegzugriff in DATEV Unternehmen online?" (datev_documents_list_clients)
• "Liste die Belegtypen der Bäckerei Schmidt, damit ich weiß, welcher für Eingangsrechnungen passt." (datev_list_document_types)
• "Kann die Bäckerei Schmidt TIFF-Dateien nach DUO hochladen?" (datev_get_duo_version)
• "Zeig mir die DUO-Sicht der Bäckerei Schmidt neben ihrem Stammdatensatz." (datev_get_documents_client und datev_get_client)

Was du brauchst

1. Eine registrierte App im DATEV-Entwicklerportal: Confidential Client, OpenID Connect Authorization Code Flow, Redirect-URI <deine AnythingMCP-URL>/api/mcp-oauth/callback (auf AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback).
2. Abos der App für accounting:clients 2.0 und accounting:documents 2.0.
3. Client-ID und Secret der App für DATEV_CLIENT_ID und DATEV_CLIENT_SECRET (das Secret wird nur einmal angezeigt).
4. Einen DATEV-Konto-Nutzer mit SmartLogin oder SmartCard/mIDentity. Für diese APIs bietet DATEV kein client_credentials: Jeder Aufruf läuft im Namen einer Person, mit deren Rechten.
5. Für Produktivdaten die Produktionsfreigabe deiner App durch DATEV. Bis dahin gibt es den eigenen Connector DATEV Online APIs (Sandbox), der schon auf die Sandbox-Endpunkte zeigt.

Schnelleinrichtung

Auf AnythingMCP Cloud: Öffne Connectors, installiere DATEV Online APIs (oder den Sandbox-Connector), füge Client-ID und Secret ein, klicke dann auf der Connector-Seite auf Authorize with Provider und melde dich mit deinem DATEV-Konto an.

Selbst gehostet:

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

Öffne http://localhost:3000/connectors/store, importiere den DATEV-Adapter, trag die OAuth-2.0-Zugangsdaten ein und führe dieselbe einmalige Autorisierung durch.

Danach hält AnythingMCP die Tokens aktuell (Confidential Clients bekommen bei DATEV rollierende Refresh-Tokens mit zwei Jahren Laufzeit) und setzt bei jedem Aufruf den Pflicht-Header X-DATEV-Client-Id. Richte deinen MCP-Client auf deine AnythingMCP-MCP-URL; die Schritte für Claude stehen in DATEV mit Claude verbinden.

Verfügbare Tools

Der Parameter clientId der mandantenbezogenen Tools ist die UUID des Mandanten aus datev_list_clients, nicht deine OAuth-Client-ID.

Scopes und Umgebungen

Der Connector fordert datev:accounting:clients accounting:clients:read accounting:documents in einem einzigen Zustimmungsdialog an. Produktion nutzt login.datev.de/openid/authorize und api.datev.de/token, der Sandbox-Connector login.datev.de/openidsandbox/authorize und sandbox-api.datev.de/token. Die Zugangsdaten sind für beide dieselben; nur die Freigabe unterscheidet sich.

Fehlerbehebung

• Der Token-Austausch scheitert nach erfolgreicher DATEV-Anmeldung. Meist liegt es am Client-Secret: unvollständig kopiert oder von einer anderen App. Erzeuge ein neues, speichere es im Connector und autorisiere erneut. Der Connector schickt es bereits per HTTP Basic, wie DATEV es verlangt.
• Die Beleg-Tools scheitern, die Mandanten-Tools funktionieren. Der App fehlt das Abo für accounting:documents 2.0, oder der Mandant hat keinen DUO-Zugang.
• In der Sandbox klappt alles, in Produktion nichts. Die App ist noch nicht für Produktion freigegeben. Teste weiter mit dem Sandbox-Connector.
• Die Mandantenliste ist kürzer als erwartet. Die Tools liefern, was dein DATEV-Nutzer sehen darf. Für mehr Mandanten braucht der Nutzer mehr Rechte in DATEV, keine Änderung am Connector.

FAQ

Welche DATEV-Daten können KI-Agenten über diesen MCP-Server lesen? Mandantenstammdaten aus accounting:clients und aus accounting:documents die Liste der DUO-Mandanten, ihre Belegtypen und die DUO-Version. Lohn, Buchungen, DMS und Beleg-Uploads sind nicht enthalten.

Funktioniert das in Claude Desktop und Claude Code? Ja. Ein Custom Connector, den du auf claude.ai hinzufügst, steht auch in Claude Desktop zur Verfügung, und in Claude Code fügst du dieselbe URL mit claude mcp add --transport http hinzu. Andere Clients, die entfernte MCP-Server unterstützen, verbinden sich mit derselben URL.

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? Deine DATEV-Zugangsdaten und Tokens liegen verschlüsselt (AES-256-GCM) und werden nie an den KI-Client weitergegeben. Tool-Ergebnisse gehen an den KI-Client, den du verbunden hast, und jeder 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 selbst.