DATEV Sandbox MCP mit Microsoft Copilot 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) + Microsoft Copilot

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 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 Online APIs (Sandbox)-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

FAQ

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

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