Primeros pasos

Pon en marcha ContextForge en 5 minutos. Compatible con Claude Code, Claude Desktop, GitHub Copilot y Cursor.

claude -c

Continúa una conversación. La memoria se queda en esa sesión. Ideal para trabajo a corto plazo en un solo proyecto.

claude + ContextForge

Memoria permanente en todas las conversaciones y todos los proyectos. Consultable para siempre.

Requisitos previos

Node.js 18 o superior
Claude Code, Claude Desktop, VS Code con Copilot o Cursor
Una cuenta de ContextForge (nivel gratuito disponible)

Paso 1: Crea una cuenta

Crea una cuenta gratuita de ContextForge para obtener tu API key.

Crear cuenta gratuita

Paso 2: Obtén tu API key

Tras registrarte, ve a Configuración → API Keys y crea una nueva clave.

Tu API key tendrá este aspecto: cf_live_xxxxxxxxxxxxxxxx

Paso 3: Instala el MCP de ContextForge

Instala el servidor MCP de ContextForge de forma global usando npm.

npm install -g contextforge-mcp

Quedan dos pasos obligatorios — ambos son necesarios para que la memoria funcione:

Conecta ContextForge a tu editor usando la API key que acabas de crear — este es el único paso que utiliza tu clave. Elige tu editor a continuación (Claude Code, Claude Desktop, Cursor o Copilot).
Inicializa cada proyecto con npx contextforge-mcp init (siguiente paso) para que tu IA use ContextForge en lugar de su memoria automática integrada.

El orden no importa, pero crear una API key por sí solo no conecta nada.

Paso 4: Inicializa tu proyecto (obligatorio)

Ejecuta esto en cada directorio de proyecto donde quieras memoria persistente:

cd ~/your-project
npx contextforge-mcp init

Esto escribe reglas específicas del editor que indican a Claude Code y a Cursor que usen el MCP de ContextForge en lugar de su memoria automática basada en archivos.

Sin este paso, tu IA ignorará silenciosamente ContextForge para las consultas de memoria — aunque el MCP esté conectado — porque la memoria automática integrada tiene prioridad predeterminada.

Qué se escribe

De forma predeterminada, init detecta automáticamente qué editor usa tu proyecto:

Archivo escrito	Para el editor	Se detecta cuando
`CLAUDE.md`	Claude Code	Existe `CLAUDE.md` o `.claude/`
`.cursorrules`	Cursor	Existe `.cursorrules` o `.cursor/`
Ambos	—	No se detecta ningún editor (opción predeterminada sin fricción)

Forzar un editor concreto

Omite la detección automática con el flag --editor:

npx contextforge-mcp init --editor=claude   # only CLAUDE.md
npx contextforge-mcp init --editor=cursor   # only .cursorrules
npx contextforge-mcp init --editor=all      # both, skip detection

Idempotente: volver a ejecutarlo es seguro. El contenido existente en CLAUDE.md o .cursorrules se conserva; nuestra sección se añade una sola vez y se omite en ejecuciones posteriores.

Consejo: puedes ejecutarlo antes o después de conectar el MCP a tu herramienta de IA — el orden no importa, pero ambos pasos son obligatorios.

Opción A: Configuración con Claude Code (CLI)

Configura ContextForge globalmente para todos tus proyectos.

Asistente de configuración rápida

Recomendado

Ejecuta el asistente interactivo — te guiará por la configuración:

npx contextforge-setup

El asistente te pedirá tu API key y configurará todo automáticamente.

Alternativa: comando manual

Si el asistente no funciona, puedes ejecutar este comando directamente:

claude mcp add contextforge -s user -e CONTEXTFORGE_API_KEY=your-api-key-here -- npx -y contextforge-mcp

Consejo: Reemplaza your-api-key-here con tu API key. El flag -s user lo hace disponible en todos los proyectos.

Verificar que funciona:

Abre Claude Code en cualquier proyecto y ejecuta /mcp — deberías ver ContextForge conectado.

npx contextforge-setup --verify

Opción B: Configuración con Claude Desktop

Si usas Claude Desktop, sigue estos pasos:

1. Localiza tu archivo de configuración

# macOS

~/Library/Application Support/Claude/claude_desktop_config.json

# Windows

%APPDATA%\Claude\claude_desktop_config.json

# Linux

~/.config/Claude/claude_desktop_config.json

2. Añade la configuración de ContextForge

Edita el archivo y añade esta configuración JSON:

{
  "mcpServers": {
    "contextforge": {
      "command": "npx",
      "args": ["-y", "contextforge-mcp"],
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Nota: Reemplaza your-api-key-here con tu API key real del Paso 2.

3. Reinicia Claude Desktop

Cierra y vuelve a abrir Claude Desktop para cargar la nueva configuración.

Opción C: GitHub Copilot (VS Code)

GitHub Copilot admite servidores MCP en el modo Agente. Añade ContextForge a tu configuración de VS Code.

Opción 1: Configuración a nivel de proyecto

Crea un archivo .mcp.json en la raíz de tu proyecto:

{
  "servers": {
    "contextforge": {
      "command": "npx",
      "args": ["-y", "contextforge-mcp"],
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opción 2: Configuración a nivel de usuario

Añade esto al settings.json de VS Code para habilitarlo en todos los proyectos:

{
  "mcp": {
    "servers": {
      "contextforge": {
        "command": "npx",
        "args": ["-y", "contextforge-mcp"],
        "env": {
          "CONTEXTFORGE_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

3. Úsalo en el modo Agente

Abre Copilot Chat en VS Code, cambia al modo Agente y las herramientas de ContextForge estarán disponibles automáticamente.

Prueba tu configuración

Prueba estos comandos para verificar que todo funciona:

# Guarda algo en memoria
"Remember that our API uses JWT tokens with 1-hour expiration"

# Consulta tu memoria
"What do we use for authentication?"

# Lista tus spaces
"Show me my memory spaces"

# Obtén estadísticas
"Show me my memory usage stats"

Recomendado: vincula tu proyecto

Nuevo

Vincula tu directorio local a un Project de ContextForge para que las consultas filtren automáticamente hacia los Spaces de ese proyecto.

¿Por qué vincular?

Las consultas buscan solo en los Spaces del proyecto vinculado
Mantén el contexto separado entre distintas bases de código
No necesitas especificar el proyecto en cada comando

Cómo vincular:

# Ver los proyectos disponibles
"Link this project to ContextForge"

# Vincular a un proyecto concreto
"Link this directory to project MyProject"

# Crear y vincular un proyecto nuevo
"Create and link a project called Backend-API"

# Comprobar qué proyecto está vinculado
"What project is linked here?"

Nota: Esto crea un archivo .contextforge en tu directorio. Añádelo a .gitignore o confírmalo con git para compartirlo con tu equipo.

Más sobre la vinculación de Projects →

Herramientas MCP disponibles

ContextForge proporciona estas herramientas a Claude para gestionar tu memoria contextual:

Operaciones de memoria principales

memory_ingest

Almacena nuevo conocimiento en memoria con generación automática de embeddings

memory_query

Busca en memoria usando similitud semántica (potenciado por Voyage AI)

memory_list_items

Lista todos los knowledge items almacenados con paginación

memory_delete

Elimina ítems de memoria por ID o título

Gestión de Projects

memory_list_projects

Lista todos los proyectos de tu cuenta

memory_create_project

Crea un nuevo proyecto para organizar Spaces

memory_link_projectNuevo

Vincula el directorio actual a un proyecto en la nube

memory_current_projectNuevo

Muestra el proyecto vinculado y sus Spaces

memory_unlink_projectNuevo

Elimina el vínculo de proyecto del directorio

memory_delete_project

Elimina un proyecto y todos sus Spaces

Gestión de Spaces

memory_list_spaces

Lista todos los spaces de memoria disponibles

memory_create_space

Crea un nuevo espacio de memoria aislado

memory_move_space

Mueve un Space a otro proyecto

memory_stats

Obtén estadísticas de uso y límites

Integración con Git

memory_git_connect

Conecta un repositorio GitHub para sincronización automática

memory_git_sync

Sincroniza manualmente commits y PRs de los repositorios conectados

memory_git_commits

Lista los commits almacenados en memoria

memory_git_prs

Lista los pull requests almacenados en memoria

Snapshots y copias de seguridad

memory_snapshot_create

Crea una copia de seguridad Snapshot de tu memoria

memory_snapshot_restore

Restaura la memoria desde un Snapshot anterior

memory_snapshot_list

Lista todos los Snapshots disponibles

Importación y exportación

memory_export

Exporta la memoria en formato JSON, Markdown o CSV

memory_import

Importa datos desde JSON, Markdown, Notion u Obsidian

Operaciones en lote

memory_ingest_batch

Almacena múltiples ítems a la vez (hasta 100)

memory_delete_batch

Elimina múltiples ítems usando filtros

Flujos de trabajo de ejemplo

Documenta tu arquitectura

"Remember: Our backend uses a microservices architecture with these services: auth-service (handles JWT), api-gateway (rate limiting), user-service (CRUD), and notification-service (email/push)."

Más tarde, Claude podrá responder: "What services do we have?"

Guarda patrones de código

"Store this as our standard error handling pattern:"

try {
  await operation();
} catch (error) {
  logger.error('Operation failed', { error });
  throw new AppError('OPERATION_FAILED', error);
}

Registra decisiones

"Remember: We decided to use PostgreSQL instead of MongoDB because of our need for complex joins and ACID compliance. Decision made on 2024-01-15."

Próximos pasos

Vinculación de Projects

Nuevo

Vincula directorios a proyectos para filtrado automático

Búsqueda semántica

Aprende a consultar tu memoria de forma efectiva

Solución de problemas

Error "Tool not found"

Asegúrate de haber reiniciado Claude tras añadir la configuración. En Claude Code, verifica con claude mcp list.

Error "Invalid API key"

Comprueba tu API key en la configuración. Asegúrate de que no haya espacios extra ni comillas. Verifica que la clave es válida en la configuración de tu dashboard.

Error "Command not found: contextforge-mcp"

Asegúrate de haber instalado el paquete de forma global con npm install -g contextforge-mcp. Verifícalo con which contextforge-mcp.

ContextForge aparece como "disabled" en Claude Code

Usa las teclas de flecha en el diálogo /mcp para navegar hasta contextforge y pulsa Enter para activarlo. O ejecuta claude mcp add contextforge -s user -e CONTEXTFORGE_API_KEY=your-api-key-here -- npx -y contextforge-mcp de nuevo.

Primeros pasos

Requisitos previos

Paso 1: Crea una cuenta

Paso 2: Obtén tu API key

Paso 3: Instala el MCP de ContextForge

Paso 4: Inicializa tu proyecto (obligatorio)

Qué se escribe

Forzar un editor concreto

Opción A: Configuración con Claude Code (CLI)

Asistente de configuración rápida

Alternativa: comando manual

Verificar que funciona:

Opción B: Configuración con Claude Desktop

1. Localiza tu archivo de configuración

2. Añade la configuración de ContextForge

3. Reinicia Claude Desktop

Opción C: GitHub Copilot (VS Code)

Opción 1: Configuración a nivel de proyecto

Opción 2: Configuración a nivel de usuario

3. Úsalo en el modo Agente

Prueba tu configuración

Recomendado: vincula tu proyecto

¿Por qué vincular?

Cómo vincular:

Herramientas MCP disponibles

Operaciones de memoria principales

Gestión de Projects

Gestión de Spaces

Integración con Git

Snapshots y copias de seguridad

Importación y exportación

Operaciones en lote

Flujos de trabajo de ejemplo

Documenta tu arquitectura

Guarda patrones de código

Registra decisiones

Próximos pasos

Vinculación de Projects

Búsqueda semántica

Integración con Git

Snapshots

Seguridad

Solución de problemas

Error "Tool not found"

Error "Invalid API key"

Error "Command not found: contextforge-mcp"

ContextForge aparece como "disabled" en Claude Code