Conectar DATEV Sandbox MCP con Gemini CLI

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

DATEV Online APIs (Sandbox) + Gemini

Entorno sandbox de 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 aplicación 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.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar 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 aplicación 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 aplicación 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 aplicación a los productos de API de sandbox accounting:clients 2.0 y accounting:documents 2.0.
3. Copia el client ID en DATEV_CLIENT_ID y el client secret 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 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 almacena después cifrado.
6. Ejecuta datev_list_clients: lista los Mandanten para los que está habilitado el usuario de tu DATEV-Konto, con UUID, número de asesor, número de cliente y nombre.

Sandbox, no producción: toda aplicación 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 aplicación 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 aplicación 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 el total 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 Gemini

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

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de DATEV Online APIs (Sandbox).

Herramientas disponibles

Preguntas frecuentes

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar con Claude
• Conectar con ChatGPT