Cursor

Requisitos previos

Utilice Cursor IDE con Settings -> Features -> MCP o soporte de marketplace. Interfaz y requisitos previos:

• Interfaz concreta: Cursor IDE (~/.cursor/mcp.json o Settings -> Features -> MCP).
• Punto de conexión: https://xmemo.dev/mcp.
• Modo de autenticación preferido: Browser OAuth.
• Modo de autenticación de respaldo: Token de portador directo para entornos headless y contenedores.
• Cuenta: Cuenta válida de XMemo en https://xmemo.dev.

Instalación / configuración

Abra Cursor Settings -> Features -> MCP o configure ~/.cursor/mcp.json. Para el funcionamiento headless, utilice el bloque de configuración directa con referencia de token de entorno en lugar del flujo de navegador:

• Ruta OAuth: Configure solo la URL alojada y deje que el primer uso active el consentimiento del navegador.
• Respaldo directo: Mantenga el token en XMEMO_KEY, nunca directamente en el archivo de ajustes.
• No mezcle la configuración de URL de OAuth con un encabezado Authorization en la misma entrada.

Establecer la credencial

La ruta OAuth no requiere clave — complete Browser OAuth en la primera solicitud. Para el respaldo headless directo, establezca XMEMO_KEY en el entorno de shell y nunca pegue valores de token en los ajustes de Cursor:

# OAuth path: no XMEMO_KEY needed (browser prompt)
# Direct fallback:
export XMEMO_KEY='<your-xmemo-token>'

Generar / confirmar XMEMO_AGENT_INSTANCE_ID

Los fragmentos revisados de OAuth y directos de Cursor no requieren un encabezado de instancia del lado del cliente. Si un contenedor headless proporciona XMEMO_AGENT_INSTANCE_ID, genérelo una vez por perfil local y reutilícelo.

Conservar el bloque de configuración existente

Ruta OAuth preferida: Utilice la configuración revisada de Cursor de solo URL en ~/.cursor/mcp.json para la autenticación OAuth basada en navegador:

{
  "mcpServers": {
    "xmemo": {
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Bloque de configuración de respaldo directo

Respaldo directo headless: Al ejecutar Cursor en entornos headless o no interactivos, configure el encabezado Authorization haciendo referencia a ${env:XMEMO_KEY} desde su entorno local:

{
  "mcpServers": {
    "xmemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}"
      }
    }
  }
}

Reiniciar el cliente

Reinicie Cursor o desactive y active el servidor MCP en Settings -> Features -> MCP después de editar la configuración para que los cambios surtan efecto.

Probar con una llamada real de recall

Haga que la primera llamada de MCP sea de solo lectura. Esta es una invocación de recall real, no un marcador de posición de verificación de estado, y no escribe memoria.

recall({ query: "connection check", limit: 1 })

Respuesta esperada (forma literal)

Una llamada exitosa devuelve la forma de texto clasificado público a continuación; la referencia y el contenido son valores reales del espacio de memoria autorizado.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Primera tarea útil: Ciclo de vida de memoria sintética

Ejercite la tarea completa de memoria sintética dentro de Cursor Composer o el modo Agente:

• 1. Guardar hecho sintético: Pida a Cursor que recuerde la convención ("Demo project timestamps use UTC.") en "projects/demo-onboarding/conventions".
• 2. Transición sin estado: Inicie un nuevo chat de Cursor Composer o vuelva a abrir el espacio de trabajo del proyecto.
• 3. Recall con atribución de origen: Consulte "demo project timestamp format". Confirme Reference y Location devueltos.
• 4. Corregir memoria: Llame a update_memory con el ID activo para formatear las marcas de tiempo con ISO 8601.
• 5. Limpieza opcional: Llame a forget con el ID de memoria cuando concluyan las pruebas de incorporación.

Capacidades y herramientas de perfil

Cursor tiene acceso a herramientas calificadas por perfil definidas en el contrato de documentación de MCP para el perfil cursor-plugin:

• Herramientas de memoria principales: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context, search_knowledge.
• Herramientas de instantáneas y conflictos: create_restart_snapshot, restore_restart_snapshot, list_memory_versions, list_memory_conflicts, resolve_memory_conflict.
• Herramientas de proyecto y planificación: get_mcp_identity, get_project_context, get_timeline, list_memory_todos, complete_memory_todo, create_memory_todo, update_project_decision, update_project_todo, update_state.
• Skills en la nube y gobernanza: recall_cloud_skill, save_cloud_skill, propose_write, propose_todo_mutation, propose_profile_mutation, query_audit, record_event, memory_stats.

Limitaciones y límites

Límites operativos y restricciones para Cursor:

• Pureza de configuración: No mezcle la configuración de URL de solo OAuth con un encabezado Authorization en el mismo bloque de servidor.
• Límite del espacio de trabajo: El acceso a la memoria está estrictamente limitado al espacio de trabajo del usuario autenticado.
• Requisito de token headless: El respaldo de MCP directo requiere el aprovisionamiento explícito del token de entorno.

Errores comunes

Cursor puede fallar tanto en su ruta OAuth como en su respaldo headless directo:

• invalid_grant — El código de autorización OAuth no es válido, ha caducado o ya se ha utilizado: reconecte Cursor y autorice de nuevo.
• 401 invalid_token — El token de respaldo directo falta, está vencido o no es válido: verifique XMEMO_KEY en el entorno headless.
• 403 insufficient_scope — La credencial no otorga memory:read: apruebe el ámbito requerido o emita un token con él.

Actualización y eliminación

Procedimientos de mantenimiento para Cursor:

• Actualización: Desactive y active el servidor en la configuración de MCP de Cursor para recargar los esquemas.
• Eliminación: Elimine la entrada xmemo de ~/.cursor/mcp.json o elimínela de la configuración de MCP de Cursor.