Instalar en Linux

Guía completa para instalar y configurar ContextForge MCP en Linux (Ubuntu, Debian, Fedora, Arch, etc.)

Requisitos previos

Node.js 18 o superior
Instálalo vía tu gestor de paquetes o usa nvm (recomendado)
Claude Desktop o Claude Code
Descarga Claude Desktop en claude.ai/download
Cuenta de ContextForge
Create a free account

Instalar Node.js (si es necesario)

Opción A: usando nvm (recomendado)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Restart terminal, then install Node
nvm install --lts
nvm use --lts

Opción B: usando el gestor de paquetes

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

Paso 1: Instalar ContextForge MCP

Abre tu terminal y ejecuta:

npm install -g contextforge-mcp

Nota: Si recibes errores de permisos, consulta la sección de solución de problemas a continuación. Evita usar sudo con npm.

Paso 2: Verificar la instalación

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

# Should output something like:
# /home/username/.nvm/versions/node/v20.x.x/bin/contextforge-mcp
# or /usr/local/bin/contextforge-mcp

Opción A: Claude Code (CLI)

Asistente de configuración rápida

Recomendado

Ejecuta el asistente interactivo:

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

La ubicación del archivo de configuración en Linux:

~/.config/Claude/claude_desktop_config.json

2. Crear el directorio y el archivo

# Create the directory if it doesn't exist
mkdir -p ~/.config/Claude

# Edit the config file
nano ~/.config/Claude/claude_desktop_config.json

3. Añadir la configuración de ContextForge

Añade este contenido al archivo:

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

EACCES permission denied

No uses sudo con npm. En su lugar, corrige los permisos de npm:

# Create a directory for global packages
mkdir -p ~/.npm-global

# Configure npm to use it
npm config set prefix '~/.npm-global'

# Add to PATH in ~/.bashrc or ~/.zshrc
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Now install again
npm install -g contextforge-mcp

command not found: contextforge-mcp

Asegúrate de que el directorio bin de npm esté en tu PATH:

# Find where npm installs global packages
npm config get prefix

# Add to your PATH in ~/.bashrc or ~/.zshrc
export PATH="$(npm config get prefix)/bin:$PATH"

Versión de Node.js demasiado antigua

Algunas distribuciones incluyen versiones antiguas de Node.js. Usa nvm para obtener la última:

# Check current version
node --version

# If < 18, install nvm and update
nvm install --lts
nvm use --lts

Claude Desktop no disponible para Linux

Si Claude Desktop no está disponible para tu distribución, usa Claude Code (CLI). ¡Funciona perfectamente en Linux!