# Devin Desktop (formerly Windsurf)

Configure el cliente MCP directo de Devin Desktop (anteriormente Windsurf) con XMEMO_KEY y atribución de instancia estable.

- Canonical: https://docs.xmemo.dev/es/docs/mcp/windsurf
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 5e5cb3cd0b8eb84a3637bb84424ecc107ee13595a609a88d8d53d2f712799031
- Edition-Digest: 794affe737e4a67bd262858ef4e9b91246e0e42cd018688ed23c45fa41c1eb64
- Source-Revision: sha256:117e4921d1aa58f84dd035761b8310480f5d3f9e14e829bf87df7418a810cafd

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

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

```bash
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.

```bash
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.

```text
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.

```text
### 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.

## Devin Desktop (formerly Windsurf)

Direct client: configure manually in ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json on Windows) with XMEMO_KEY in the environment. Note: npx @xmemo/client mcp add windsurf currently writes the pre-rename location ~/.codeium/windsurf/mcp_config.json (useful only for pre-rename installs), so Devin Desktop users should configure manually or move the file.

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