Entornos y secretos

Un Entorno de md-doc es un conjunto de variables (por ejemplo mi-app.es con CLAVE_API y PASS_SSH) que una IA puede usar sin ver su valor. Los valores se cifran en tu navegador con tu clave maestra; el servidor solo guarda datos cifrados y el MCP nunca los devuelve.

Principio: usar sí, ver no.

Cómo se usa

1. En md-doc → Entornos, crea un entorno y añade tus variables (o importa un .env).
2. Instala el CLI mddoc y conéctalo con una clave de API de tipo CLI.
3. Tu IA, desde su terminal, ejecuta:

mddoc run mi-app.es -- npm run deploy

El CLI descarga el entorno cifrado, lo descifra en tu equipo, inyecta las variables en ese proceso y enmascara su salida (****). El modelo ve el resultado del comando, no la clave.

Qué puede y qué no puede la IA

Puede	No puede
Ver los nombres de entornos y variables	Ver, imprimir o copiar valores
Ejecutar comandos con mddoc run	Desbloquear el CLI por su cuenta
Añadir el nombre de una variable que falta (queda «pendiente de valor»)	Escribir, cambiar o borrar valores existentes
Generar un secreto aleatorio con mddoc set … --generate sin llegar a verlo	Crear entornos

Los valores los pones tú en la web o con mddoc set <entorno> <VARIABLE> en tu terminal.

Si el CLI está bloqueado

mddoc run termina con código 3. La IA debe detenerse y pedirte que ejecutes mddoc unlock tú mismo; nunca debe pedirte el valor ni buscarlo en un .env o en el historial. El intento se registra y puedes recibir una notificación de escritorio.

Límites que conviene conocer

El enmascarado evita fugas accidentales, no intencionadas: un programa hecho a propósito podría transformar el valor antes de imprimirlo. Los valores de menos de 6 caracteres (puertos, true…) no se enmascaran. Más detalle en Seguridad.