Instalar en Windows

Guía completa para instalar y configurar ContextForge MCP en Windows.

Requisitos previos

Node.js 18 o superior
Descárgalo en nodejs.org. Usa la versión LTS (instalador .msi para Windows)
Claude Desktop o Claude Code
Descarga Claude Desktop en claude.ai/download
Cuenta de ContextForge
Create a free account

Paso 1: Instalar ContextForge MCP

Abre PowerShell o el Símbolo del sistema (se recomienda ejecutar como administrador) y ejecuta:

npm install -g contextforge-mcp

Consejo:Si recibes errores de permisos, haz clic derecho en PowerShell y selecciona "Ejecutar como administrador"

Paso 2: Verificar la instalación

Comprueba que la instalación se realizó correctamente:

# Check if contextforge-mcp is installed
where contextforge-mcp

# Should output something like:
# C:\Users\YourName\AppData\Roaming\npm\contextforge-mcp

Opción A: Claude Code (CLI)

Asistente de configuración rápida

Recomendado

Ejecuta el asistente interactivo en PowerShell:

npx contextforge-setup

Alternativa: comando manual

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

Verificar la configuración

# List configured MCPs
claude mcp list

# Or run verification
npx contextforge-setup --verify

Opción B: Claude Desktop

1. Encontrar el archivo de configuración

Presiona Win + R y escribe:

%APPDATA%\Claude

Esto abre la carpeta. Busca claude_desktop_config.json. Si no existe, créalo.

2. Ruta completa del archivo de configuración

C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

3. Añadir la configuración de ContextForge

Edita el archivo con el Bloc de notas o VS Code y añade:

{
  "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 obtenida en tu dashboard

4. Reiniciar Claude Desktop

Cierra Claude Desktop por completo (revisa la bandeja del sistema) y vuelve a abrirlo.

Actualizar ContextForge MCP

Cuando haya una nueva versión disponible, puedes actualizarla con:

npm install -g contextforge-mcp

Si tienes problemas o quieres una reinstalación limpia:

npm uninstall -g contextforge-mcp && npm install -g contextforge-mcp

Tras la actualización, reinicia Claude Desktop o tu sesión de Claude Code para que los cambios surtan efecto.

Solución de problemas en Windows

'contextforge-mcp' no se reconoce como comando

Normalmente significa que la carpeta global de npm no está en tu PATH.

# Find npm global folder
npm config get prefix

# Add to PATH (PowerShell as Admin)
$env:Path += ";C:\Users\YOUR_USERNAME\AppData\Roaming\npm"

# Or add permanently via System Properties > Environment Variables

Errores de permisos denegados

Ejecuta PowerShell como administrador: haz clic derecho en PowerShell → "Ejecutar como administrador"

Node.js no encontrado

Tras instalar Node.js, reinicia tu terminal. Si el problema persiste:

# Verify Node installation
node --version
npm --version

El archivo de configuración no se carga

Asegúrate de que el JSON sea válido (sin comas al final, comillas correctas). Usa un validador de JSON o VS Code para revisar la sintaxis.

Claude Desktop no muestra ContextForge

Asegúrate de haber cerrado Claude Desktop por completo (revisa el icono en la bandeja del sistema, cerca del reloj). Luego vuelve a abrirlo.