MCP en Cursor

Cursor es un IDE con IA basado en VS Code. Con Synapse MCP, Cursor gana memoria persistente entre sesiones — recuerda las decisiones del proyecto, los patrones del codebase y las sesiones de depuración pasadas.

Requisitos previos

• IDE Cursor instalado (https://cursor.com)
• Node.js 18+
• Su Mind Key de Synapse

Configuración

Paso 1: Abrir la configuración de Cursor

En Cursor:

1. Abra Settings (Cmd+, en macOS, Ctrl+, en Windows/Linux)
2. Busque "MCP" o navegue a Cursor Settings → MCP Servers

Paso 2: Añadir el servidor MCP de Synapse

Haga clic en "Add MCP Server" y configure:

Campo	Valor
Name	synapse
Type	stdio
Command	npx -y synapse-mcp-api@latest
Env	SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone

Paso 3: Editar config.json directamente (alternativa)

Cursor almacena la configuración MCP en ~/.cursor/config.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"
      }
    }
  }
}

Paso 4: Reiniciar Cursor

Reinicie Cursor completamente (Cmd+Q y vuelva a abrir en macOS).

Verifique que funciona

En el panel de chat de Cursor (Cmd+L):

recall all my memories

Cursor debería llamar a memory_recall y responder con sus memorias almacenadas.

Patrones comunes

Onboarding del proyecto

Al abrir un proyecto nuevo:

recalling project context — what do I know about this codebase?

Cursor llama a memory_recall y continúa el trabajo donde lo dejó.

Decisiones de arquitectura

store this decision: "Using Fastify instead of Express for this project
because of schema validation. Date: 2026-06-27."

Cursor lo almacena como una memoria project con prioridad high.

Historial de depuración

what bugs have I hit in this codebase?

Cursor busca memorias mistake y le recuerda las correcciones pasadas.

Patrones de código entre sesiones

search memories: "authentication pattern"

Cursor encuentra memorias sobre implementaciones de auth que ha hecho antes.

Solución de problemas

El servidor MCP no conecta

1. Verifique Node.js: node --version (≥ 18)
2. Pruebe el servidor MCP: npx -y synapse-mcp-api@latest (debería arrancar sin errores)
3. Revise los logs MCP de Cursor (View → Output → MCP)
4. Reinicie Cursor completamente

Las herramientas no aparecen

• Compruebe que ~/.cursor/config.json es JSON válido
• Verifique que la variable de entorno SYNAPSE_MIND_KEY está establecida
• Compruebe que la versión de Cursor admite MCP (≥ 0.42)

Mind Key inválido

# Test your Mind Key directly
curl -H "Authorization: Bearer mk_YOUR_KEY" \
     https://synapse.schaefer.zone/memory/recall

Próximos pasos

• Configuración de Claude Desktop
• Configuración de Continue.dev
• Guía de agente LLM persistente