MCP en Claude Desktop

Claude Desktop es la app de escritorio de Anthropic para macOS y Windows. Con el servidor MCP de Synapse configurado, Claude obtiene acceso nativo a las 79 herramientas de Synapse — puede almacenar memorias, recuperarlas, gestionar tareas, chatear con usted y más.

Requisitos previos

• App Claude Desktop (macOS o Windows)
• Node.js 18+ instalado (node --version)
• Su Mind Key de Synapse

Paso 1: Abrir el archivo de configuración

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Si el archivo no existe, créelo.

Paso 2: Añadir el servidor MCP de Synapse

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

Paso 3: Reiniciar Claude Desktop

1. Cierre Claude Desktop completamente (Cmd+Q en macOS, no solo cerrar la ventana)
2. Vuelva a abrir Claude Desktop
3. Inicie un nuevo chat
4. Busque el icono de enchufe 🔌 en la parte inferior izquierda — debería decir "79 tools"

Paso 4: Probarlo

En un nuevo chat, escriba:

memory_recall aufrufen

Claude debería llamar a la herramienta memory_recall y responder con un resumen de sus memorias almacenadas (o "No memories yet" si su mind está vacío).

Herramientas disponibles (selección)

Lista completa: ¿Qué es MCP?

Solución de problemas

No aparecen herramientas en Claude Desktop

1. Verifique la versión de Node.js: node --version (debe ser ≥ 18)
2. Compruebe que el archivo de configuración es JSON válido (sin comas finales)
3. Reinicie Claude Desktop completamente (Cmd+Q, no solo cerrar)
4. Revise los logs de Claude Desktop: ~/Library/Logs/Claude/mcp.log (macOS)

Error "Mind Key invalid"

• Verifique que SYNAPSE_MIND_KEY empieza por mk_
• Obtenga una nueva clave vía POST /minds (requiere JWT de /login)
• Sin comillas alrededor de la clave en el JSON

npx no encontrado

• Instale Node.js 18+: https://nodejs.org/
• Reinicie el terminal tras la instalación
• En macOS con Homebrew: brew install node

Las herramientas aparecen pero las llamadas fallan

• Compruebe que SYNAPSE_URL es alcanzable: curl https://synapse.schaefer.zone/health
• Verifique que su Mind Key funciona: curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• Consulte Solución de problemas de MCP

Tool Profiles (ahorro de tokens)

Si está usando un LLM más pequeño o quiere ahorrar tokens de contexto, establezca un tool profile:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone",
        "MCP_PROFILE": "standard"
      }
    }
  }
}

Perfiles: minimal (8 herramientas), standard (25), full (119, predeterminado).

Próximos pasos

• Configuración de Claude Code
• Configuración de Cursor
• Solución de problemas de MCP