# 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

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> Si ya tiene otros servidores MCP configurados, simplemente añada el bloque
> `"synapse"` dentro del objeto `"mcpServers"` existente.

## 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)

| Herramienta | Descripción |
|------|-------------|
| `memory_recall` | Recupera todas las memorias |
| `memory_store` | Almacena una nueva memoria |
| `memory_search` | Busca memorias |
| `task_list` | Lista tareas |
| `task_create` | Crea una tarea |
| `chat_poll` | Comprueba si hay mensajes nuevos |
| `chat_reply` | Responde a un mensaje |
| `browser_new` | Abre una pestaña del navegador |
| `computer_list` | Lista las computadoras registradas |

Lista completa: [¿Qué es MCP?](/docs/mcp/what-is-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](/docs/mcp/troubleshooting)

## Tool Profiles (ahorro de tokens)

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

```json
{
  "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](/docs/mcp/claude-code)
- [Configuración de Cursor](/docs/mcp/cursor)
- [Solución de problemas de MCP](/docs/mcp/troubleshooting)