CvLAC (MinCiencias)

cvlac-mcp

Actualiza tu CvLAC conversando con tu asistente de IA, sin llenar formularios a mano.

Llenar el CvLAC de MinCiencias es lento: un formulario por cada curso, premio o proyecto, con catálogos de instituciones y municipios que no siempre encuentran lo que buscas. cvlac-mcp le da a tu asistente de IA (Claude, por ejemplo) la capacidad de hacerlo por ti: le dices en el chat qué agregar o corregir, y él entra a CvLAC con tu cuenta, llena el formulario, lo guarda y revisa que haya quedado guardado.

Funciona en tu computador. Tus credenciales no salen de él y no pasan por ningún servidor intermedio.

• Cómo se ve
• Qué puede hacer y qué no
• Qué necesitas
• Instalación paso a paso — unos 15 minutos
• Qué pedirle
• Cómo te protege
• Problemas frecuentes
• Seguridad y privacidad
• Actualizar o desinstalar
• Para desarrolladores

Cómo se ve

Una conversación se parece a esto:

Tú: Muéstrame los reconocimientos que tengo en CvLAC.

Asistente: Tienes 6. Entre ellos, "Distinción a la labor docente" (2023) y "Mejor ponencia,

Congreso Nacional de Ingeniería" (2021)…

Tú: Agrega este: "Mención de honor a la labor docente", Universidad del Norte, 2024, nacional.

Asistente: No lo guardé todavía: se parece a "Distinción a la labor docente" (2023), que ya está

en tu CvLAC. ¿Es el mismo reconocimiento y quieres corregirlo, o es otro y lo creo aparte?

Tú: Es otro, créalo.

Asistente: Listo, CvLAC confirmó el guardado. Ya aparece en tu lista: "Mención de honor a la labor

docente", 2024, ámbito nacional.

El asistente no borra nada ni crea duplicados sin preguntarte primero. Los nombres de este ejemplo son ficticios.

Qué puede hacer y qué no

Puede leer, agregar, corregir y borrar:

Todavía no puede:

• Subir certificados desde `complete_product`: esa operación gestiona palabras clave, áreas, coautores, reconocimientos y estudiantes vinculados en tesis. Los certificados de libros se adjuntan mediante update_section con rutas locales; no forman parte de las listas de complete_product.
• Crear revistas, libros, editoriales, programas o áreas que no existan en los catálogos de CvLAC. Si un catálogo devuelve varias opciones, te las muestra para que elijas.
• Iniciar sesión con una cuenta de nacionalidad extranjera. Por ahora el inicio de sesión asume nacionalidad colombiana.
• Tocar tus datos de identificación y direcciones, ni nada de GrupLAC.
• Crear un programa en formación complementaria que CvLAC no tenga registrado. El buscador de CvLAC solo ofrece los que ya existen para esa institución, y la web tampoco deja crear otros.

Comparar automáticamente tu CvLAC con otra fuente (la herramienta diff) hoy solo funciona con un portafolio web que tenga una estructura concreta (detalles). Si no tienes uno, no importa: le pegas en el chat el texto de tu hoja de vida, o se lo dictas, y el asistente lee tu CvLAC y agrega lo que falte, ítem por ítem, preguntándote ante cualquier parecido.

Qué necesitas

• Tu usuario de CvLAC: primer nombre, número de cédula y contraseña, los mismos con los que entras a la web.
• Un computador con Windows, macOS o Linux.
• Node.js 20 o superior, un programa gratuito que hace funcionar esta herramienta. En el paso 1 está cómo instalarlo.
• Una app de IA que acepte servidores MCP. MCP es el estándar con el que estas apps se conectan a herramientas como esta. Si no tienes ninguna, empieza con [Claude Desktop](https://claude.ai/download): es la más sencilla y es la que usa esta guía. También sirven Claude Code, Cursor, VS Code, Windsurf, Zed y JetBrains (cómo conectarlas).

No necesitas saber programar. Vas a copiar y pegar unos comandos en la terminal; la guía dice exactamente cuáles.

Instalación paso a paso

¿Qué es la terminal? Una ventana donde se escriben comandos.

En Windows: tecla Windows, escribe PowerShell y ábrelo.

En macOS: Cmd + Espacio, escribe Terminal y ábrela.

Para pegar un comando: clic derecho en Windows, Cmd + V en macOS. Luego presiona Enter.

Paso 1 · Instala Node.js

Descarga la versión LTS desde nodejs.org e instálala con las opciones que vienen marcadas. Luego cierra y vuelve a abrir la terminal y comprueba:

node --version

Debe mostrar v20 o un número mayor (por ejemplo v22.11.0).

Otras formas de instalarlo

• Windows: winget install OpenJS.NodeJS.LTS
• macOS: brew install node@22 con Homebrew
• Linux: nvm y luego nvm install 22

Paso 2 · Descarga el navegador que usa la herramienta

cvlac-mcp maneja CvLAC con su propia copia de Chromium, un navegador que funciona sin ventana. Se descarga una sola vez (unos 150 MB):

npx -y cvlac-mcp@1 install-browser

Al final debe decir que Chromium quedó instalado.

¿Falla con UNABLE_TO_VERIFY_LEAF_SIGNATURE o SELF_SIGNED_CERT_IN_CHAIN ?

Un antivirus (Avast, ESET, Kaspersky…) o la red de tu universidad revisa el tráfico con su propio certificado de seguridad. Dile a Node que confíe en los certificados de tu sistema (necesita Node 22.15 o superior):

$env:NODE_OPTIONS="--use-system-ca"; npx -y cvlac-mcp@1 install-browser   # Windows (PowerShell)

NODE_OPTIONS=--use-system-ca npx -y cvlac-mcp@1 install-browser           # macOS / Linux

Con un Node anterior, exporta el certificado raíz del antivirus o de la red y apunta a él con NODE_EXTRA_CA_CERTS=/ruta/al/certificado.pem.

Por qué no npx playwright install , y qué significa @1

install-browser usa el Playwright que trae este paquete. npx playwright install baja la última versión, y puede dejarte un Chromium que este servidor no sabe abrir (Executable doesn't exist).

El @1 fija la versión mayor: recibes arreglos, pero ningún cambio incompatible sin enterarte. En algunas distribuciones de Linux hace falta además npx playwright install-deps chromium.

Paso 3 · Guarda tus datos de acceso

Van en un archivo de texto aparte, dentro de tu carpeta de usuario, que solo tú puedes leer.

Windows — en PowerShell:

mkdir "$HOME\.config\cvlac-mcp" -Force

notepad "$HOME\.config\cvlac-mcp\.env"

El Bloc de notas pregunta si quieres crear el archivo: di que sí. Pega estas tres líneas, cambia lo que está entre comillas por tus datos, conserva las comillas simples y guarda con Ctrl + S:

CVLAC_NOMBRE='Tu primer nombre'

CVLAC_CEDULA='1234567890' CVLAC_PASSWORD='tu clave'

Cierra el Bloc de notas y deja el archivo legible solo por tu usuario:

icacls "$HOME\.config\cvlac-mcp\.env" /inheritance:r /grant:r "${env:USERNAME}:(R,W)"

macOS / Linux — cambia los tres valores antes de pegar, conservando las comillas simples:

mkdir -p ~/.config/cvlac-mcp

cat > ~/.config/cvlac-mcp/.env <<'EOF' CVLAC_NOMBRE='Tu primer nombre' CVLAC_CEDULA='1234567890' CVLAC_PASSWORD='tu clave' EOF chmod 600 ~/.config/cvlac-mcp/.env

• CVLAC_NOMBRE es tu primer nombre tal como lo registraste en CvLAC, con tildes y ñ.
• Las comillas simples importan: sin ellas, una clave con # se corta ahí.
• No guardes este archivo en Escritorio ni en Documentos si esas carpetas se sincronizan con OneDrive o Google Drive. La carpeta de arriba no se sincroniza.

Crear el archivo sin el Bloc de notas (Windows)

$contenido = @'

CVLAC_NOMBRE='Tu primer nombre' CVLAC_CEDULA='1234567890' CVLAC_PASSWORD='tu clave' '@

@'...'@, con comilla simple, no toca un $ que haya en tu clave; @"..."@ sí lo cambiaría. WriteAllText guarda en UTF-8. Si el archivo te quedó en otra codificación —Out-File y > guardan en UTF-16, y Set-Content en ANSI—, cvlac-mcp lo detecta, lo lee igual y lo anota en su registro al arrancar.

Paso 4 · Conecta cvlac-mcp con Claude Desktop

1. Abre Claude Desktop y ve a Configuración → Desarrollador → Editar configuración (en inglés: *Settings → Developer → Edit Config*). Se abre la carpeta con el archivo claude_desktop_config.json: ábrelo con el Bloc de notas o TextEdit.
2. Pega el bloque de tu sistema, cambiando TU_USUARIO por tu usuario del computador. Para saber cuál es: echo $env:USERNAME en PowerShell, o whoami en la terminal de macOS.

Windows:

{

"mcpServers": { "cvlac-mcp": { "command": "cmd", "args": ["/c", "npx", "-y", "cvlac-mcp@1"], "env": { "CVLAC_ENV_FILE": "C:\\Users\\TU_USUARIO\\.config\\cvlac-mcp\\.env" } } } }

macOS (en Linux, la ruta empieza por /home/ en vez de /Users/):

{

"mcpServers": { "cvlac-mcp": { "command": "npx", "args": ["-y", "cvlac-mcp@1"], "env": { "CVLAC_ENV_FILE": "/Users/TU_USUARIO/.config/cvlac-mcp/.env" } } } }

1. Guarda y cierra Claude Desktop del todo; no basta con cerrar la ventana. En Windows, clic derecho en su ícono junto al reloj → Salir. En macOS, Cmd