Conectar DATEV Sandbox MCP con ChatGPT

💡 ¿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) + ChatGPT

Entorno sandbox para las DATEV Online APIs: lee Mandanten (clientes) de contabilidad, tipos de documento y metadatos de la versión de DUO con los datos de prueba de DATEV. Úsalo mientras desarrollas y pruebas; toda nueva app 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.

Requisitos previos

Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno necesarias para este conector son:

DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

Paso 1 — Obtén las credenciales

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 una sola vez.
4. Instala el conector. Ya viene configurado para los endpoints de sandbox de DATEV y se autentica en el endpoint de tokens 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 almacena 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. Una vez que 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 ID de cliente: 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 Bearer token.

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 todos, porque solo aparecen los clientes con una suscripción activa a DUO; 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.

Paso 2 — Instala el adaptador

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

Paso 3 — Añade el conector en ChatGPT

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala allí donde esta guía muestre YOUR_SERVER_ID.

ChatGPT añade los servidores MCP como plugins en su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio de trabajo Business solo pueden añadirlos los administradores y propietarios; en Enterprise y Edu, un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, haz clic en Add y luego en Add custom MCP server.
2. Introduce un nombre, p. ej. Name: DATEV Online APIs (Sandbox).
3. En Connection, introduce la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y luego Create as a plugin. Cuando ChatGPT te lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales, luego escribe @ en un chat y elígelo.

Herramientas disponibles

Preguntas frecuentes

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para planes de pago; el plan Free no figura en su lista.

Próximos pasos

• Página del conector
• Conectar con Claude