DATEV Sandbox MCP: clienti e tipi di documento

💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, fai clic su Connectors → DATEV Online APIs (Sandbox), incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

DATEV Online APIs (Sandbox)

Ambiente sandbox per le DATEV Online APIs — leggi i Mandanten contabili (clienti), i tipi di documento e i metadati della versione DUO sui dati di test di DATEV. Usalo mentre sviluppi e testi; ogni nuova app DATEV deve girare in sandbox finché DATEV non concede l'approvazione per la produzione. Stesso flusso OAuth2 Authorization Code + PKCE della produzione, puntato agli endpoint sandbox di DATEV.

Configurazione

La configurazione richiede circa 10 minuti. Ti servono un'app sul DATEV-Entwicklerportal e un DATEV-Konto con cui accedere.

1. Sul DATEV-Entwicklerportal (https://developer.datev.de), crea un'app Confidential con OpenID Connect Authorization Code Flow. Imposta il redirect URI su <your AnythingMCP URL>/api/mcp-oauth/callback (su AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback).
2. Sottoscrivi l'app ai prodotti API sandbox accounting:clients 2.0 e accounting:documents 2.0.
3. Copia il client ID in DATEV_CLIENT_ID e il client secret in DATEV_CLIENT_SECRET. Copia il secret per intero: il portale lo mostra una sola volta.
4. Installa il connettore. È già configurato per gli endpoint sandbox di DATEV e si autentica sul token endpoint con HTTP Basic (client_secret_basic), come richiesto da DATEV.
5. Nella pagina del connettore, fai clic su Authorize with Provider e accedi con il tuo DATEV-Konto. È un accesso una tantum: il refresh token viene poi memorizzato in forma cifrata.
6. Esegui datev_list_clients: elenca i Mandanten per cui è abilitato l'utente del tuo DATEV-Konto, con UUID, numero consulente, numero cliente e nome.

Sandbox, non produzione: ogni app DATEV gira in sandbox finché DATEV non completa la revisione per l'approvazione in produzione, quindi è qui che sviluppi e testi. La sandbox lavora sui dati di test di DATEV. Quando DATEV approva la tua app per la produzione, usa il connettore separato DATEV Online APIs: accetta le stesse credenziali e punta agli endpoint di produzione.

Scope: il connettore richiede datev:accounting:clients accounting:clients:read accounting:documents. Non aggiungere openid: è il nome dell'issuer, non uno scope.

Due tipi di client id: ogni strumento per singolo cliente accetta un clientId, ovvero l'UUID del Mandant restituito da datev_list_clients. Non coincide con DATEV_CLIENT_ID, che identifica la tua app OAuth e viene inviato nell'header X-DATEV-Client-Id a ogni chiamata, insieme al Bearer token.

Cosa legge: i dati anagrafici di un Mandant (numero consulente e cliente, nome, indirizzo); i Mandanten con accesso ai documenti DATEV Unternehmen online (DUO), che possono essere meno del totale perché compaiono solo i clienti con un abbonamento DUO attivo; i tipi di documento (Belegtypen) di un Mandant; e la versione DUO con le estensioni di file che DUO accetta per il caricamento. Tutti e sei gli strumenti sono di sola lettura.

Prerequisiti: DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

Installa il connettore in locale

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

Apri http://localhost:3000/connectors/store, scegli DATEV Online APIs (Sandbox) e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

Prossimi passi

• Collega a Claude
• Collega a ChatGPT