Instalar en macOS

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

Requisitos previos

Node.js 18 o superior
Instálalo vía Homebrew: brew install node
O descárgalo en nodejs.org
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 la 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 something like:
# /usr/local/bin/contextforge-mcp
# or /opt/homebrew/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

Abre la Terminal y ejecuta:

# Open the Claude config folder
open ~/Library/Application\ Support/Claude/

# Or create/edit the config file directly
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Ruta del archivo de configuración

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

3. Añadir la configuración de ContextForge

Añade o edita el archivo con este contenido:

{
  "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 (Cmd + Q) 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 macOS

command not found: contextforge-mcp

Comprueba que el directorio bin global de npm esté en tu PATH:

# Find npm prefix
npm config get prefix

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

# Reload profile
source ~/.zshrc

Permiso denegado

Si recibes errores de permisos con npm, considera usar un gestor de versiones de Node como nvm o corrige los permisos de npm.

Carpeta Library no visible

La carpeta Library está oculta de forma predeterminada. En Finder, presiona Cmd + Shift + . para mostrar archivos ocultos, o usa la Terminal.

Claude Desktop no muestra ContextForge

Asegúrate de haber cerrado Claude Desktop por completo (Cmd + Q). Revisa también la barra de menú por algún icono de Claude y ciérralo desde ahí.