DATEV mit Microsoft Copilot verbinden — KI für deutsche Buchhaltung

DATEV mit Copilot verbinden

DATEV ist die Software, mit der die meisten deutschen Steuerberatungskanzleien arbeiten. Mit AnythingMCP liest Copilot 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 Copilot 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 Copilot 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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die DATEV-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Jedes mandantenbezogene Tool erwartet die UUID des Mandanten als clientId. Copilot 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 Copilot 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 Copilot nie gezeigt. Wenn Copilot ein Tool nutzt, ruft AnythingMCP DATEV auf und gibt das Ergebnis an Copilot 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.

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

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