In breve
API Klardaten sul sistema DATEV di uno studio di consulenza fiscale: anagrafiche dei clienti, dichiarazioni dei redditi, delle società e dell'imposta sulle attività produttive, contabilità (registrazioni, bilancio di verifica SuSa, movimenti bancari), paghe LODAS, analisi dello studio e un accesso diretto a DATEVconnect in sola lettura.
Configurazione guidata
Collega Klardaten a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Klardaten con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Klardaten (DATEV)
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Klardaten (DATEV), inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente
git clone, niente server locale.
Klardaten (DATEV) + Microsoft Copilot
API Klardaten sul sistema DATEV di uno studio di consulenza fiscale: anagrafiche dei clienti, dichiarazioni dei redditi, delle società e dell'imposta sulle attività produttive, contabilità (registrazioni, bilancio di verifica SuSa, movimenti bancari), paghe LODAS, analisi dello studio e un accesso diretto a DATEVconnect in sola lettura.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
KLARDATEN_API_KEY, KLARDATEN_INSTANCE_ID
Step 1 — Ottieni le credenziali
Dati sensibili: leggi prima questo. Questo connettore legge tramite Klardaten i dati DATEV di uno studio di consulenza fiscale: anagrafiche, dichiarazioni fiscali, contabilità e paghe dei clienti dello studio, compresi stipendi, codici fiscali, date di nascita e movimenti bancari di persone fisiche e aziende. Sono dati coperti dal segreto professionale (§ 203 StGB, § 57 StBerG) e dal GDPR. Aggiungi il connettore solo a server i cui utenti possono vedere tutti questi dati, per esempio i soci o il personale che ha già quell'accesso in DATEV, e mai a un server condiviso o aziendale. La API key agisce con il profilo DATEV associato: il modello vede tutto ciò che quel profilo può leggere.
- Il connettore di Klardaten deve essere installato e attivo sul server DATEV dello studio, con un'istanza DATEV nella dashboard di Klardaten.
- Accedi a https://dashboard.klardaten.com e crea una API key per il tuo utente. Inizia con
uk-; inseriscila inKLARDATEN_API_KEY(inviata comeAuthorization: Bearer). - Copia l'id dell'istanza DATEV (un UUID) in
KLARDATEN_INSTANCE_ID. Ogni richiesta DATEV lo invia nell'headerx-client-instance-id;klardaten_list_instanceselenca le istanze raggiungibili con la key. - Chiama prima
klardaten_get_meper verificare l'accesso, poiklardaten_list_clients(anagrafiche),klardaten_list_accounting_clients(contabilità),klardaten_list_payroll_clients(paghe LODAS) oklardaten_list_firm_clients(analisi dello studio).
Gli id cambiano da un'area all'altra: le anagrafiche usano UUID, la contabilità un client_id numerico con gli esercizi indicati come YYYYMMDD, paghe e analisi dello studio il client_number. Filtra sempre klardaten_list_postings per client_id e fiscal_year: su tutti i clienti di uno studio la query può andare in timeout. Gli endpoint di contabilità, paghe, imposte e analisi dipendono dal piano Klardaten e fuori dal piano rispondono 403. klardaten_search_documents richiede l'add-on di ricerca documenti di Klardaten e viene installato disattivato. Se le chiamate DATEV falliscono mentre klardaten_get_me funziona, controlla klardaten_get_datevconnect_health.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Klardaten (DATEV). - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
klardaten_get_me | Return the user the API key belongs to and the effective access for the configured DATEV instance |
klardaten_list_instances | List the DATEV instances (client instances) the account can reach, with id, name and consultant number |
klardaten_list_clients | List the advisory firm's DATEV clients (Mandanten) from master data: client_id, client_number, name, type, status, addresses, tax numbers… |
klardaten_get_client | Return one DATEV client's full master data record by client_id: names, legal form, addresses, tax numbers, responsibilities and status |
klardaten_list_client_services | Return the services (Leistungen) booked for one client, as recorded in DATEV master data |
klardaten_list_client_relationships | List the relationships of one client to other addressees: shareholders, managing directors, spouses, legal representatives, with validity… |
klardaten_list_addressees | List addressees (Adressaten): people and companies in DATEV master data, with names, contact data, tax numbers and role flags such as… |
klardaten_get_addressee | Return one addressee's full master data record by addressee_id: name, birth or foundation date, addresses, tax numbers and role flags |
klardaten_list_addressee_communications | List the communication entries of one addressee: phone numbers, e-mail addresses, fax and web, with flags for main and invoice contact |
klardaten_list_relationships | List all relationships between addressees across the firm's master data (shareholdings, representation, family links), with source, target… |
klardaten_get_relationship | Return one relationship by relationship_id, with source and target addressee, type, validity dates and share details |
klardaten_list_filing_standards | List the firm's filing standards (Ablage-Knigge): document classes with their standard folder and register, used to file documents in DATEV… |
klardaten_list_documents | List documents in DATEV DMS (metadata only, no file content): document number, client, folder, register, year, month, extension, creator… |
klardaten_list_income_tax_filings | List income tax (Einkommensteuer) returns in DATEV: id, client_number, year, status, ELSTER transmission status and dates, and notice status |
klardaten_get_income_tax_filing | Return one income tax return by id: year, status, ELSTER transmission and tax office arrival dates, objection status and client number |
klardaten_get_income_tax_data | Return the form data of one income tax return by id, as name and content pairs |
klardaten_list_corp_tax_filings | List corporate tax (Körperschaftsteuer) returns in DATEV: id, client_number, year, status, ELSTER transmission status and dates, and notice… |
klardaten_get_corp_tax_filing | Return one corporate tax return by id: year, status, ELSTER transmission and tax office arrival dates, objection status and client number |
klardaten_get_corp_tax_data | Return the form data of one corporate tax return by id, as name and content pairs |
klardaten_list_trade_tax_filings | List trade tax (Gewerbesteuer) returns in DATEV: id, client_number, year, status, ELSTER transmission status and dates, and notice status |
klardaten_get_trade_tax_filing | Return one trade tax return by id: year, status, ELSTER transmission and tax office arrival dates, objection status and client number |
klardaten_get_trade_tax_data | Return the form data of one trade tax return by id, as name and content pairs |
klardaten_list_tax_calculations | List the tax calculations DATEV holds for one client and tax application, with tax years and calculation ids |
klardaten_get_tax_calculation | Return the calculated tax values of one client, tax application and tax year from DATEV, e.g. assessed tax and prepayments |
klardaten_list_payroll_clients | List the payroll clients in DATEV LODAS: client_number, consultant number, short company name and billing status |
klardaten_list_payroll_employees | List the employees of one LODAS payroll client: personnel number, name, address, entry and exit dates, tax and social security data |
klardaten_get_payroll_employee | Return one employee's payroll master record from LODAS by client number and personnel number |
klardaten_list_payroll_salaries | List the fixed salary components of a LODAS payroll client: employee number, wage type, amount, interval and validity |
klardaten_list_payroll_transaction_data | List the standard transaction data (Bewegungsdaten) of a LODAS payroll client: billing period, employee, wage type, value, cost center |
klardaten_list_accounting_clients | List the clients that have DATEV accounting (Rechnungswesen) data: accounting client_id (numeric), client_number, name and the master data… |
(showing 30 of 79 tools — install the connector to see them all)
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?