Cómo conectar Doppler a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Doppler, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Doppler + Gemini

El gestor de secretos Doppler desde cualquier agente de IA: proyectos, entornos y configs, nombres y valores de secretos (leer, actualizar, descargar), registros de cambios de configs y rollback, el registro de actividad del workplace, miembros, grupos, cuentas de servicio, integraciones y service tokens. Tres herramientas devuelven valores de secretos en texto claro.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

DOPPLER_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Doppler y un token.

Los secretos son visibles para la IA. doppler_list_secrets, doppler_get_secret y doppler_download_secrets devuelven valores de secretos en texto claro: entran en la conversación, en el contexto del proveedor de IA y en el historial de chat de tu cliente. La visibilidad masked y restricted solo oculta los valores en el panel de Doppler; la API los devuelve a cualquier token con acceso de lectura. Para ver qué contiene una config, la IA usa doppler_list_secret_names, lee valores solo cuando los pides y no repite un valor si no se lo pides. Si la IA solo debe ver nombres y metadatos, un administrador del espacio de trabajo desactiva esas tres herramientas.

1. Elige un token en https://dashboard.doppler.com:
   • Service account token (dp.sa., planes Team y Enterprise): Team, Service Accounts, crea una con un rol en el workplace y acceso a proyectos limitado a lo que necesita la IA, y después crea un API token. La mejor opción.
   • Service token (dp.st.): en un proyecto abre una config, después Access, Generate. Elige acceso de lectura salvo que la IA deba escribir. Solo llega a esa config; workplace, proyectos, registro de actividad e integraciones responden 403.
   • Personal token (dp.pt.): ajustes de tu cuenta, Tokens. Puede hacer todo lo que puedes hacer tú, en todos los proyectos.
2. Pega el token en DOPPLER_TOKEN tal como lo muestra Doppler, sin Bearer y sin espacios. Se envía como Authorization: Bearer <token>.
3. Ejecuta doppler_get_me: muestra el tipo de token y el workplace.

Estructura y personas: doppler_get_workplace, doppler_list_workplace_users, doppler_list_groups y doppler_list_service_accounts (solo metadatos, nunca tokens); doppler_list_projects, doppler_get_project, doppler_list_project_members, doppler_list_environments, doppler_get_environment, doppler_list_configs y doppler_get_config. Ninguna de ellas devuelve valores de secretos.

Secretos: primero doppler_list_secret_names, que devuelve los nombres sin ningún valor. Valores solo si se piden: doppler_get_secret para uno, doppler_list_secrets para varios (acotados con secrets), doppler_download_secrets para una config completa como archivo JSON, .env, YAML, Docker o .NET.

Cambios: doppler_update_secrets crea o sobrescribe valores; los secretos no incluidos se quedan como están. doppler_update_secret_note pone una nota que vale para ese nombre de secreto en todos los entornos del proyecto. doppler_create_project (Doppler añade dev, stg y prd), doppler_update_project, doppler_create_environment, doppler_create_config (una config branch vacía) y doppler_clone_config (una copia con secretos) dan forma a la estructura. Los valores que pasas a doppler_update_secrets también pasan por la conversación. La IA confirma contigo nombres, valores y config antes de escribir, sobre todo en configs prd.

Historial y auditoría: doppler_list_config_logs y doppler_get_config_log muestran qué cambió en una config, con los nombres de secretos añadidos, cambiados y eliminados pero sin valores. doppler_rollback_config_log restaura el estado anterior a un cambio; el rollback es a su vez una nueva entrada del registro, así que se deshace del mismo modo. doppler_list_activity_logs y doppler_get_activity_log son la auditoría del workplace. doppler_list_integrations y doppler_get_integration muestran sincronizaciones con AWS, GitHub, Vercel, Kubernetes y otros; doppler_list_service_tokens lista los service tokens de una config sin sus valores.

Desactivadas al instalar: doppler_delete_secret. Las aplicaciones que leen la config pierden el valor en su siguiente lectura y el borrado no se puede deshacer, así que un administrador del espacio de trabajo la activa cuando el equipo la necesita.

Identificadores: project es el slug del proyecto, environment el slug del entorno (dev, stg, prd), config el nombre de la config: una config raíz se llama como el slug del entorno, una config branch empieza por él, por ejemplo dev_feature_x. Los nombres de secretos distinguen mayúsculas y minúsculas y por convención van en mayúsculas.

Formatos de datos: las entradas de secretos llevan raw (tal como se escribió, con referencias ${OTHER}) y computed (referencias resueltas). doppler_download_secrets con format: json devuelve un objeto plano de NOMBRE a valor. Las horas son ISO 8601 en UTC. Las respuestas llevan success: true; los fallos llevan messages.

Paginación: las herramientas de lista aceptan page (desde 1) y per_page (20 por defecto). La IA pide la página siguiente mientras vuelva una página completa.

Límites: por minuto, el plan Developer permite 240 lecturas, 120 lecturas de secretos y 60 escrituras; Team 480, 240 y 120; Enterprise 480, 480 y 240. Por encima del límite Doppler responde 429.

Errores comunes: 401 indica un token incorrecto, caducado o revocado, 403 un token sin acceso a ese proyecto, esa config o ese endpoint del workplace (un service token solo llega a su config), 404 un proyecto, config, secreto o id de registro desconocido, 400 un nombre o cuerpo no válido, 429 el límite de peticiones.

El conector nunca devuelve los valores de service tokens ni de tokens de cuentas de servicio, no borra proyectos, entornos ni configs y no cambia integraciones ni permisos de acceso.

Paso 2 — Instalar el 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

Paso 3 — Añadir 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 Doppler.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué secretos contiene la config prd del proyecto backend? Solo los nombres, sin valores."
• "¿Qué cambió esta semana en la config stg de backend y quién hizo el cambio?"
• "Pon FEATURE_NEW_CHECKOUT a true en la config dev de backend. Enséñame el cambio antes de guardar."
• "Deshaz el último cambio de la config prd de backend. Enséñame antes esa entrada del registro."
• "¿Qué integraciones sincronizan nuestras configs con AWS o Vercel y qué configs envían?"

FAQ

¿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 a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot