Devin Desktop (formerly Windsurf)

Prérequis

Utilisez Devin Desktop (anciennement Windsurf) avec sa prise en charge directe de configuration MCP. Devin Desktop se connecte directement via un jeton porteur fourni par l'environnement avec XMEMO_KEY sur le transport Streamable HTTP configuré via serverUrl.

• Endpoint : https://xmemo.dev/mcp.
• Transport : Streamable HTTP (configuré via serverUrl).
• Mode d'authentification : jeton porteur direct depuis XMEMO_KEY.
• Fichier de configuration : ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sous Windows ; les installations antérieures au renommage utilisaient ~/.codeium/windsurf/mcp_config.json).
• ID client : windsurf (conservé comme windsurf pour la compatibilité).
• État de préparation : Preuves requises (marketplace planifiée, non certifiée).

Installation / configuration

Configurer manuellement : ajoutez le bloc de serveur XMemo dans ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sous Windows) sous mcpServers. Remarque : npx @xmemo/client mcp add windsurf écrit actuellement l'emplacement antérieur au renommage ~/.codeium/windsurf/mcp_config.json (utile uniquement pour les installations préalables au renommage), les utilisateurs de Devin Desktop doivent donc configurer manuellement ou déplacer le fichier. L'ID client reste windsurf par compatibilité.

• Client direct : configurez manuellement dans ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sous Windows) avec XMEMO_KEY dans l'environnement.
• Remarque : npx @xmemo/client mcp add windsurf écrit actuellement l'emplacement antérieur au renommage ~/.codeium/windsurf/mcp_config.json (utile uniquement pour les installations préalables au renommage), les utilisateurs de Devin Desktop doivent donc configurer manuellement ou déplacer le fichier.

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

Définir l'identifiant

Définissez XMEMO_KEY dans l'environnement avant de lancer Devin Desktop. Conservez le jeton dans l'environnement plutôt que de l'inscrire en dur dans le fichier de configuration.

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

Générer / confirmer XMEMO_AGENT_INSTANCE_ID

Générez un identifiant d'instance stable et non secret par installation locale de Devin Desktop pour maintenir une attribution cohérente à chaque redémarrage.

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

Conserver le bloc de configuration existant

Utilisez le bloc de configuration rendu sur cette page. Configurez manuellement dans ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sous Windows). L'identifiant client reste windsurf pour des raisons de compatibilité.

Redémarrer le client

Redémarrez Devin Desktop après avoir mis à jour ~/.config/devin/mcp_config.json ou l'environnement afin d'établir la connexion au serveur MCP.

Tester avec un appel de rappel (recall) réel

Effectuez le premier appel MCP en lecture seule. Il s'agit d'une véritable invocation de recall, et non d'un indicateur de contrôle d'état, et elle n'écrit aucune mémoire.

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

Réponse attendue (format littéral)

Un appel réussi renvoie le format de texte classé public ci-dessous ; la référence et le contenu sont des valeurs réelles issues de l'espace de mémoire autorisé.

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

Erreurs fréquentes

Devin Desktop est un client à porteur direct ; vérifiez les variables d'environnement en cas de problèmes de connexion.

• 401 invalid_token — XMEMO_KEY est manquante, expirée, révoquée ou invalide : vérifiez XMEMO_KEY dans l'environnement et redémarrez Devin Desktop.
• 403 insufficient_scope — Le jeton n'accorde pas memory:read : émettez un jeton disposant de la portée requise.
• Les valeurs invalides de XMEMO_AGENT_INSTANCE_ID sont normalisées en absence d'attribution d'instance plutôt que de lever une erreur d'authentification.

Certification et état de préparation

État de certification : Preuves requises. État sur la marketplace : Planifié. Des preuves d'intégration sont nécessaires avant qu'une certification complète ne soit octroyée.

• État de certification : Preuves requises.
• État sur la marketplace : Planifié.
• Remarque sur la préparation : Voir /product/docs#client-capability-matrix ; configurez manuellement dans ~/.config/devin/mcp_config.json.