Actualizaciones y versiones

Mantén el cliente MCP de ContextForge actualizado para acceder a las últimas funciones, correcciones y mejoras.

Versión actual

Comprobar la versión instalada

Para ver qué versión tienes instalada actualmente:

npm list -g contextforge-mcp

Verás algo como: contextforge-mcp@0.1.71

Cómo actualizar

1Actualizar a la última versión (recomendado)

La forma más sencilla de obtener la versión más reciente:

npm update -g contextforge-mcp

Este comando actualiza a la última versión disponible en npm.

2Forzar la reinstalación

Si el comando de actualización no funciona, fuerza una instalación limpia:

npm install -g contextforge-mcp@latest

Esto elimina la versión antigua e instala la más reciente.

3Instalar una versión específica

Si necesitas una versión concreta:

npm install -g contextforge-mcp@0.1.71

Reemplaza 0.1.71 por la versión que necesites.

Importante: reinicio requerido

Tras actualizar el paquete, debes reiniciar Claude Code para que los cambios surtan efecto.

Para Claude Code (CLI):

  1. Cierra tu sesión actual de Claude Code
  2. Sal del terminal (o ejecuta exit)
  3. Abre una nueva sesión de terminal
  4. Inicia Claude Code de nuevo

¿Por qué? Claude Code ejecuta el cliente MCP como un proceso en segundo plano. Al actualizar el paquete npm se actualizan los archivos en disco, pero el proceso anterior sigue corriendo en memoria. Reiniciar crea un nuevo proceso con el código actualizado.

Verificar la actualización

Después de reiniciar Claude Code, comprueba que la nueva versión está activa:

1. Comprobar la versión instalada:

npm list -g contextforge-mcp

2. Probar con Claude Code:

Pídele a Claude que use una herramienta de ContextForge. Si ves mensajes de error mejorados con enlaces y detalles útiles, ¡estás usando la última versión!

Solución de problemas

Problema: "La versión no se actualiza"

Si npm update no funciona:

  1. Prueba la reinstalación forzada: npm install -g contextforge-mcp@latest
  2. Limpia la caché de npm: npm cache clean --force
  3. Luego reinstala: npm install -g contextforge-mcp@latest

Problema: "Permiso denegado"

En macOS/Linux puede que necesites sudo:

sudo npm update -g contextforge-mcp

Problema: "Sigo viendo los mensajes de error antiguos"

Asegúrate de haber reiniciado Claude Code tras la actualización:

  1. Verifica la versión: npm list -g contextforge-mcp
  2. Cierra Claude Code por completo
  3. Cierra el terminal
  4. Abre un terminal nuevo e inicia Claude Code

Problema: "Aviso EBADENGINE"

Puede aparecer un aviso sobre compatibilidad de versiones de Node.js:

npm warn EBADENGINE Unsupported engine

En general es seguro ignorarlo. Es una advertencia de una dependencia de desarrollo que no afecta a la funcionalidad de ContextForge. Si la actualización termina con "changed 1 package", ¡todo está correcto!

Notas de versión recientes

Versión 0.1.71

Actual

Publicada: 25 de marzo de 2026

✨ Añadido:
  • Búsqueda con conciencia de relaciones — las consultas descubren ítems relacionados a través de conexiones en el grafo de conocimiento
  • Parámetro include_relationships para memory_query — muestra las conexiones de cada resultado
  • Importación de vaults de Obsidian con análisis de frontmatter YAML, creación de relaciones por wikilinks y categorías por carpetas
  • memory_list_relationships — lista todas las conexiones de un knowledge item
🐛 Corregido:
  • memory_query devolvía 0 resultados al usar project_id — los spaces de git se incluían en la búsqueda y provocaban timeouts
  • El endpoint de Projects mostraba un contador de spaces inflado (incluía spaces de git)

Versión 0.1.70

Publicada: 13 de marzo de 2026

✨ Añadido:
  • tasks_add_comment — añadir comentarios a tareas desde Claude
  • tasks_list_comments — ver todos los comentarios de una tarea
  • Indicador de número de comentarios en la salida de tasks_list
  • Notificación de actualización en las respuestas de las herramientas cuando hay una nueva versión del MCP disponible
🔧 Mejorado:
  • Banner de actualización en el dashboard con notificación descartable
  • Sistema de notificación de versiones para todos los usuarios
  • La versión del MCP ahora se lee desde package.json (única fuente de verdad)

Versión 0.1.65

Publicada: 11 de marzo de 2026

✨ Cambiado:
  • tasks_delete ahora realiza eliminación permanente con limpieza completa en cascada (comentarios, actividad, notificaciones)
  • Botón de eliminar en todas las tarjetas y filas de tareas directamente desde la vista de lista
🔧 Mejorado:
  • El scroll infinito conserva la posición al eliminar ítems
  • Visibilidad del botón de eliminar mejorada en modo oscuro
  • El workflow de CI auto-pr se omite cuando no existen commits únicos

Versión 0.1.64

Publicada: 10 de marzo de 2026

🔒 Seguridad:
  • Corregida omisión de autorización en @hono/node-server (CVE alto)
  • Corregida fuga de datos entre clientes en @modelcontextprotocol/sdk (CVE alto)
  • Corregida escritura arbitraria de archivos en rollup (CVE alto)
🔧 Mejorado:
  • Todas las dependencias actualizadas a las versiones seguras más recientes

Versión 0.1.49

Publicada: 29 de enero de 2026

✨ Añadido:
  • issues_delete — eliminar tareas por ID o short_id (eliminación suave)
  • Diálogo de creación de tarea en el dashboard (reemplaza la navegación a la página /new)
  • Botón de eliminar tarea en la página de detalle de tarea (solo propietarios)
🔧 Mejorado:
  • El backend admite DELETE por id o short_id
  • Mejor experiencia de usuario para gestión de tareas desde el dashboard

Versión 0.1.22

Publicada: 15 de enero de 2026

✨ Añadido:
  • npx contextforge-setup — asistente de configuración interactivo para una instalación sencilla
  • npx contextforge-setup --verify — comprobar el estado de la configuración actual
🔧 Mejorado:
  • Proceso de instalación simplificado: ya no hay que memorizar comandos largos
  • Detección automática de configuración existente de ContextForge

Versión 0.1.21

Publicada: 15 de enero de 2026

✨ Añadido:
  • memory_link_project — vincular directorios locales a projects en la nube
  • memory_unlink_project — eliminar el vínculo de proyecto de un directorio
  • memory_current_project — ver el proyecto vinculado y sus spaces
  • Archivo de configuración .contextforge para contexto de proyecto automático
🔧 Mejorado:
  • memory_list_spaces ahora filtra automáticamente por proyecto vinculado
  • Texto de ayuda actualizado con documentación sobre vinculación de proyectos

Versión 0.1.20

Publicada: 15 de enero de 2026

✨ Añadido:
  • memory_delete_project — eliminar proyectos con borrado en cascada de todos sus spaces e ítems
  • Botón de eliminar proyecto en la página de detalle de proyecto del dashboard
🔧 Mejorado:
  • El backend ahora admite eliminación en cascada para proyectos
  • Documentación actualizada para operaciones de eliminación

Versión 0.1.18

Publicada: 15 de enero de 2026

✨ Añadido:
  • Funcionalidad de Projects para organizar spaces (jerarquía: Projects → Spaces)
  • memory_move_space — mover spaces entre proyectos
  • memory_delete_space — eliminar spaces y sus ítems
  • Herramientas memory_list_projects y memory_create_project
  • Página de detalle de proyecto en el dashboard
  • Botones de mover y eliminar para spaces en la interfaz del dashboard
🔧 Mejorado:
  • Barra lateral reordenada: Uso ahora aparece antes que Projects
  • Mejor visualización del uso para escenarios de límite superado
  • Corregida verificación JWT en edge functions

Versión 0.1.15

Publicada: 14 de enero de 2026

✨ Añadido:
  • Búsqueda en múltiples spaces
  • Soporte de nombres de space en las consultas
  • Mensajes de error más claros para el usuario

Versión 0.1.4

Publicada: 12 de enero de 2026

✨ Añadido:
  • Herramientas de integración Git (conectar, sincronizar, historial)
  • Gestión de Snapshots (crear, restaurar, eliminar)
  • Funcionalidad de importación y exportación
  • Operaciones en lote para eliminación

Ver el registro de cambios completo en GitHub Releases

Buenas prácticas de actualización

+

Comprueba las actualizaciones regularmente

Ejecuta npm outdated -g para ver si hay actualizaciones disponibles

+

Siempre reinicia tras actualizar

Recuerda reiniciar Claude Code para usar la nueva versión

+

Prueba tras actualizar

Realiza una operación sencilla para asegurarte de que todo funciona correctamente

-

Los cambios disruptivos son poco frecuentes

Las actualizaciones menores (0.1.x) son siempre compatibles con versiones anteriores

¿Necesitas ayuda?

Si encuentras algún problema al actualizar: