Devin Desktop (formerly Windsurf)

前置条件

使用支持直连 MCP 配置的 Devin Desktop（原 Windsurf）。Devin Desktop 通过带有 XMEMO_KEY 的环境支持 bearer token，经由通过 serverUrl 配置的 Streamable HTTP 传输直接连接。

• Endpoint: https://xmemo.dev/mcp.
• Transport: Streamable HTTP (通过 serverUrl 配置)。
• Auth mode: 来自 XMEMO_KEY 的直接 bearer token。
• Config file: ~/.config/devin/mcp_config.json (Windows 上为 %APPDATA%\devin\mcp_config.json；更名前的安装使用 ~/.codeium/windsurf/mcp_config.json)。
• Client ID: windsurf (为保持兼容性保留为 windsurf)。
• 就绪状态: 需要证据（计划上线应用市场，未认证）。

安装 / 设置

手动配置：在 mcpServers 下将 XMemo 服务块添加到 ~/.config/devin/mcp_config.json（Windows 上为 %APPDATA%\devin\mcp_config.json）。注意：npx @xmemo/client mcp add windsurf 当前写入更名前的位置 ~/.codeium/windsurf/mcp_config.json（仅对更名前的安装有用），因此 Devin Desktop 用户应手动配置或移动该文件。为保持兼容性，客户端 ID 保留为 windsurf。

• 直连客户端：在环境中配置 XMEMO_KEY 的情况下，在 ~/.config/devin/mcp_config.json（Windows 上为 %APPDATA%\devin\mcp_config.json）中手动配置。
• 注意：npx @xmemo/client mcp add windsurf 当前写入更名前的位置 ~/.codeium/windsurf/mcp_config.json（仅对更名前的安装有用），因此 Devin Desktop 用户应手动配置或移动该文件。

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

设置凭据

在启动 Devin Desktop 之前在环境中设置 XMEMO_KEY。将令牌保留在环境中，而不是将其硬编码到配置文件中。

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

生成 / 确认 XMEMO_AGENT_INSTANCE_ID

为每个本地 Devin Desktop 安装生成稳定的非机密实例标识符，以便归属在重启后保持一致。

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

保留现有配置块

使用本页面呈现的配置块。在 ~/.config/devin/mcp_config.json（Windows 上为 %APPDATA%\devin\mcp_config.json）中手动配置。为保持兼容性，客户端 ID 保留为 windsurf。

重启客户端

更新 ~/.config/devin/mcp_config.json 或环境后重启 Devin Desktop，以建立 MCP 服务器连接。

使用真实 recall 调用测试

首次 MCP 调用应为只读。这是实际的 recall 调用，而不是健康检查占位符，并且不会写入记忆。

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

预期响应（字面结构）

成功调用返回以下公开排序文本结构；reference 和 content 是来自已授权记忆空间的真实值。

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

常见错误

Devin Desktop 是直连 bearer 客户端；如果出现连接问题，请验证环境变量。

• 401 invalid_token — XMEMO_KEY 缺失、过期、被撤销或无效: 验证环境中的 XMEMO_KEY 并重启 Devin Desktop。
• 403 insufficient_scope — 令牌未授予 memory:read: 签发具有所需权限范围的令牌。
• 无效的 XMEMO_AGENT_INSTANCE_ID 值将规范化为无实例归属，而不是引发身份验证错误。

认证与就绪状态

认证状态: 需要证据。市场状态: 计划中。在授予完全认证之前需要集成证据。

• 认证状态: 需要证据。
• 市场状态: 计划中。
• 就绪说明: 请参阅 /product/docs#client-capability-matrix；在 ~/.config/devin/mcp_config.json 中手动配置。