Instalar para Windsurf IDE

Requisitos previos

• Node.js 18 o superior

  Descárgalo en nodejs.org

• Windsurf IDE

  Descárgalo en codeium.com/windsurf

• 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 Windsurf

# macOS
~/.codeium/windsurf/mcp_config.json

# Windows
%USERPROFILE%\.codeium\windsurf\mcp_config.json

# Linux
~/.codeium/windsurf/mcp_config.json

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

Usar ContextForge en Windsurf

Una vez configurado, puedes usar las herramientas de ContextForge en el Cascade AI de Windsurf:

# 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

Tras la actualización, reinicia Windsurf para que los cambios surtan efecto.

Solución de problemas

# Validate JSON syntax
cat ~/.codeium/windsurf/mcp_config.json | jq .

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

# Find the full path
npm config get prefix

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

Próximos pasos