DATEV Sandbox MCP Server: clientes y documentos

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → DATEV Online APIs (Sandbox), pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

DATEV Online APIs (Sandbox)

Entorno sandbox de las DATEV Online APIs: lee Mandanten contables (clientes), tipos de documento y metadatos de la versión de DUO con los datos de prueba de DATEV. Úsalo mientras desarrollas y pruebas; toda app nueva de DATEV debe ejecutarse en sandbox hasta que DATEV conceda la aprobación para producción. Mismo flujo OAuth2 Authorization Code + PKCE que en producción, apuntando a los endpoints de sandbox de DATEV.

Configuración

La configuración lleva unos 10 minutos. Necesitas una app en el DATEV-Entwicklerportal y una DATEV-Konto con la que iniciar sesión.

1. En el DATEV-Entwicklerportal (https://developer.datev.de), crea una app Confidential con OpenID Connect Authorization Code Flow. Establece la URI de redirección en <your AnythingMCP URL>/api/mcp-oauth/callback (en AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback).
2. Suscribe la app a los productos de API de sandbox accounting:clients 2.0 y accounting:documents 2.0.
3. Copia el ID de cliente en DATEV_CLIENT_ID y el secreto de cliente en DATEV_CLIENT_SECRET. Copia el secreto completo: el portal lo muestra solo una vez.
4. Instala el conector. Ya viene configurado para los endpoints de sandbox de DATEV y se autentica en el endpoint de token con HTTP Basic (client_secret_basic), que es lo que exige DATEV.
5. En la página del conector, haz clic en Authorize with Provider e inicia sesión con tu DATEV-Konto. Es un inicio de sesión único: el refresh token se guarda después cifrado.
6. Ejecuta datev_list_clients: lista los Mandanten para los que está aprovisionado el usuario de tu DATEV-Konto, con UUID, número de asesor, número de cliente y nombre.

Sandbox, no producción: toda app de DATEV se ejecuta en el sandbox hasta que DATEV completa su revisión de aprobación para producción, así que aquí es donde desarrollas y pruebas. El sandbox trabaja con los datos de prueba de DATEV. Cuando DATEV apruebe tu app para producción, usa el conector independiente DATEV Online APIs: acepta las mismas credenciales y apunta a los endpoints de producción.

Scopes: el conector solicita datev:accounting:clients accounting:clients:read accounting:documents. No añadas openid: es el nombre del emisor, no un scope.

Dos tipos de client id: cada herramienta por cliente recibe un clientId, el UUID del Mandant que devuelve datev_list_clients. No es lo mismo que DATEV_CLIENT_ID, que identifica tu app OAuth y se envía en la cabecera X-DATEV-Client-Id en cada llamada, junto con el token Bearer.

Qué lee: los datos maestros de un Mandant (número de asesor y de cliente, nombre, dirección); los Mandanten con acceso a documentos de DATEV Unternehmen online (DUO), que pueden ser menos que el total porque solo aparecen los clientes con una suscripción DUO activa; los tipos de documento (Belegtypen) de un Mandant; y la versión de DUO con las extensiones de archivo que DUO acepta para la subida. Las seis herramientas son de solo lectura.

Requisitos previos: DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

Instala el conector en local

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

Abre http://localhost:3000/connectors/store, elige DATEV Online APIs (Sandbox) y pega las variables de entorno indicadas en Requisitos previos.

Herramientas disponibles

Siguientes pasos

• Conectar con Claude
• Conectar con ChatGPT