Devin Desktop (formerly Windsurf)

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.

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

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.

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.

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.

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