Devin Desktop (formerly Windsurf)

Requisito previo

Use Devin Desktop (anteriormente Windsurf) con soporte de configuración directa de MCP. Devin Desktop se conecta directamente mediante un token de portador respaldado por el entorno con XMEMO_KEY sobre el transporte Streamable HTTP configurado mediante serverUrl.

• Endpoint: https://xmemo.dev/mcp.
• Transporte: Streamable HTTP (configurado mediante serverUrl).
• Modo de autenticación: token de portador directo desde XMEMO_KEY.
• Archivo de configuración: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows; las instalaciones anteriores al cambio de nombre usaban ~/.codeium/windsurf/mcp_config.json).
• ID de cliente: windsurf (permanece windsurf por compatibilidad).
• Estado de preparación: Pruebas requeridas (mercado planificado, no certificado).

Instalación / configuración

Configure manualmente: añada el bloque del servidor XMemo a ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows) en mcpServers. Nota: npx @xmemo/client mcp add windsurf escribe actualmente la ubicación previa al cambio de nombre ~/.codeium/windsurf/mcp_config.json (útil sólo para instalaciones anteriores al cambio de nombre), por lo que los usuarios de Devin Desktop deben configurar manualmente o mover el archivo. El ID de cliente permanece como windsurf por compatibilidad.

• Cliente directo: configure manualmente en ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows) con XMEMO_KEY en el entorno.
• Nota: npx @xmemo/client mcp add windsurf escribe actualmente la ubicación previa al cambio de nombre ~/.codeium/windsurf/mcp_config.json (útil sólo para instalaciones anteriores al cambio de nombre), por lo que los usuarios de Devin Desktop deben configurar manualmente o mover el archivo.

{
  "mcpServers": {
    "XMemo": {
      "serverUrl": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "windsurf",
        "X-Memory-OS-Agent-Instance-ID": "${env:XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Configurar la credencial

Defina XMEMO_KEY en el entorno antes de iniciar Devin Desktop. Mantenga el token en el entorno en lugar de codificarlo directamente en el archivo de configuración.

export XMEMO_KEY='<your-xmemo-token>'

Generar / confirmar XMEMO_AGENT_INSTANCE_ID

Genere un identificador de instancia no secreto y estable por instalación local de Devin Desktop para que la atribución se mantenga constante entre reinicios.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-devin-desktop-instance-id>'
# Persist and reuse this value for the same local install

Conserve el bloque de configuración existente

Use el bloque de configuración que aparece en esta página. Configure manualmente en ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows). El ID de cliente permanece como windsurf por compatibilidad.

Reiniciar el cliente

Reinicie Devin Desktop tras actualizar ~/.config/devin/mcp_config.json o el entorno para que se establezca la conexión con el servidor MCP.

Probar con una llamada real a recall

Haga que la primera llamada MCP sea de sólo lectura. Es una invocación real de recall, no un marcador de verificación de estado, y no escribe en la memoria.

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

Respuesta esperada (forma literal)

Una llamada correcta devuelve la forma pública de texto clasificado que aparece abajo; 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>

Errores comunes

Devin Desktop es un cliente de portador directo; verifique las variables de entorno si se producen problemas de conexión.

• 401 invalid_token — XMEMO_KEY falta, ha caducado, ha sido revocado o no es válido: verifique XMEMO_KEY en el entorno y reinicie Devin Desktop.
• 403 insufficient_scope — el token no concede memory:read: emita un token con el ámbito requerido.
• Los valores no válidos de XMEMO_AGENT_INSTANCE_ID se normalizan para no atribuir ninguna instancia en lugar de generar un error de autenticación.

Certificación y estado de preparación

Estado de certificación: Pruebas requeridas. Estado en el mercado: Planificado. Se requieren pruebas de integración antes de otorgar la certificación completa.

• Estado de certificación: Pruebas requeridas.
• Estado en el mercado: Planificado.
• Nota de preparación: Consulte /product/docs#client-capability-matrix; configure manualmente en ~/.config/devin/mcp_config.json.