Instalar para Cursor IDE

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

Claude Desktop (macOS)Claude Desktop (Windows)Claude Desktop (Linux)ChatGPT Desktop Windsurf IDE

Requisitos previos

Node.js 18 o superior
Descárgalo en nodejs.org
Cursor IDE
Descárgalo en cursor.com
Cuenta de ContextForge
Create a free account

Paso 1: Instalar ContextForge MCP

Abre tu terminal y ejecuta:

npm install -g contextforge-mcp

Paso 2: Verificar la instalación

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

# Should output the path to the executable

Paso 3: Configurar Cursor

1. Localizar el archivo de configuración MCP

Cursor usa un archivo de configuración JSON para los servidores MCP:

# macOS / Linux
~/.cursor/mcp.json

# Windows
%USERPROFILE%\.cursor\mcp.json

2. Crear o editar el archivo de configuración

Añade la siguiente configuración:

{
  "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

3. Reiniciar Cursor

Cierra y vuelve a abrir Cursor IDE para que los cambios surtan efecto.

Usar ContextForge en Cursor

Una vez configurado, puedes usar las herramientas de ContextForge en el chat de IA de Cursor:

# Save knowledge to memory
"Remember this API endpoint documentation..."

# Query your memory
"What do we know about the authentication flow?"

# Create tasks
"Create a task: Fix the login bug"

# List your tasks
"Show my pending tasks"

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 Cursor IDE para que los cambios surtan efecto.

Solución de problemas

MCP no aparece en Cursor

Asegúrate de que el archivo de configuración esté en la ubicación correcta y tenga JSON válido:

# Validate JSON syntax
cat ~/.cursor/mcp.json | jq .

# Check if contextforge-mcp is accessible
which contextforge-mcp

command not found: contextforge-mcp

Añade el directorio bin global de npm a tu PATH o usa la ruta completa en la configuración:

# Find the full path
npm config get prefix

# Use full path in mcp.json
{
  "mcpServers": {
    "contextforge": {
      "command": "/usr/local/bin/contextforge-mcp",
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key"
      }
    }
  }
}

Errores de autenticación

Verifica que tu API key sea correcta y no haya expirado. Puedes generar una nueva clave en tu dashboard.

Windows: problemas con rutas

En Windows puede ser necesario usar la ruta completa con la extensión .cmd:

{
  "mcpServers": {
    "contextforge": {
      "command": "C:\\Users\\YourName\\AppData\\Roaming\\npm\\contextforge-mcp.cmd",
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key"
      }
    }
  }
}