# Devin Desktop (formerly Windsurf)

Konfigurieren Sie den direkten MCP-Client für Devin Desktop (ehemals Windsurf) mit XMEMO_KEY und stabiler Instanzzuordnung.

- Canonical: https://docs.xmemo.dev/de/docs/mcp/windsurf
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 5e5cb3cd0b8eb84a3637bb84424ecc107ee13595a609a88d8d53d2f712799031
- Edition-Digest: d8064044d769b208da468dd233d69bfd3855adfba9f481e8f9493e959abc9ec8
- Source-Revision: sha256:117e4921d1aa58f84dd035761b8310480f5d3f9e14e829bf87df7418a810cafd

## Voraussetzung

Verwenden Sie Devin Desktop (ehemals Windsurf) mit direkter MCP-Konfigurationsunterstützung. Devin Desktop verbindet sich direkt über ein umgebungsbasiertes Bearer-Token mit XMEMO_KEY über den über serverUrl konfigurierten Streamable HTTP-Transport.

- Endpunkt: https://xmemo.dev/mcp.
- Transport: Streamable HTTP (konfiguriert über serverUrl).
- Authentifizierungsmodus: Direktes Bearer-Token aus XMEMO_KEY.
- Konfigurationsdatei: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json unter Windows; Installationen vor der Umbenennung verwendeten ~/.codeium/windsurf/mcp_config.json).
- Client-ID: windsurf (bleibt aus Kompatibilitätsgründen windsurf).
- Bereitschaftsstatus: Belege erforderlich (geplanter Marktplatz, nicht zertifiziert).

## Installation / Einrichtung

Manuell konfigurieren: Fügen Sie den XMemo-Serverblock zu ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json unter Windows) unter mcpServers hinzu. Hinweis: npx @xmemo/client mcp add windsurf schreibt derzeit den Pfad vor der Umbenennung ~/.codeium/windsurf/mcp_config.json (nur für Installationen vor der Umbenennung nützlich), daher sollten Devin Desktop-Benutzer manuell konfigurieren oder die Datei verschieben. Die Client-ID bleibt aus Kompatibilitätsgründen windsurf.

- Direkter Client: Manuell konfigurieren in ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json unter Windows) mit XMEMO_KEY in der Umgebung.
- Hinweis: npx @xmemo/client mcp add windsurf schreibt derzeit den Pfad vor der Umbenennung ~/.codeium/windsurf/mcp_config.json (nur für Installationen vor der Umbenennung nützlich), daher sollten Devin Desktop-Benutzer manuell konfigurieren oder die Datei verschieben.

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

## Anmeldedaten festlegen

Setzen Sie XMEMO_KEY vor dem Starten von Devin Desktop in der Umgebung. Behalten Sie das Token in der Umgebung, anstatt es fest in die Konfigurationsdatei zu programmieren.

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

## XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Generieren Sie eine stabile, nicht geheime Instanzkennung pro lokaler Devin Desktop-Installation, damit die Zuordnung über Neustarts hinweg konsistent bleibt.

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

## Bestehenden Konfigurationsblock beibehalten

Verwenden Sie den auf dieser Seite gerenderten Konfigurationsblock. Konfigurieren Sie manuell unter ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json unter Windows). Die Client-ID bleibt aus Kompatibilitätsgründen windsurf.

## Client neu starten

Starten Sie Devin Desktop nach der Aktualisierung von ~/.config/devin/mcp_config.json oder der Umgebung neu, damit die MCP-Serververbindung hergestellt wird.

## Mit einem echten recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf rein lesend aus. Dies ist ein tatsächlicher recall-Aufruf, kein Platzhalter für eine Statusprüfung, und er schreibt keine Daten in den Speicher.

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

## Erwartete Antwort (wörtliche Struktur)

Ein erfolgreicher Aufruf gibt die unten dargestellte öffentliche strukturierte Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

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

## Häufige Fehler

Devin Desktop ist ein direkter Bearer-Client; überprüfen Sie Umgebungsvariablen, falls Verbindungsprobleme auftreten.

- 401 invalid_token — XMEMO_KEY fehlt, ist abgelaufen, wurde widerrufen oder ist anderweitig ungültig: Überprüfen Sie XMEMO_KEY in der Umgebung und starten Sie Devin Desktop neu.
- 403 insufficient_scope — Das Token gewährt nicht memory:read: Stellen Sie ein Token mit dem erforderlichen Geltungsbereich aus.
- Ungültige XMEMO_AGENT_INSTANCE_ID-Werte werden normalisiert, sodass keine Instanzzuordnung erfolgt, anstatt einen Authentifizierungsfehler auszulösen.

## Zertifizierung und Bereitschaft

Zertifizierungsstatus: Belege erforderlich. Marktplatzstatus: Geplant. Integrationsnachweise sind erforderlich, bevor eine vollständige Zertifizierung erteilt wird.

- Zertifizierungsstatus: Belege erforderlich.
- Marktplatzstatus: Geplant.
- Hinweis zur Bereitschaft: Siehe /product/docs#client-capability-matrix; manuell konfigurieren unter ~/.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}"
      }
    }
  }
}
```