# Devin Desktop (formerly Windsurf)

配置带有 XMEMO_KEY 和稳定实例归属的直连 Devin Desktop（原 Windsurf）MCP 客户端。

- Canonical: https://docs.xmemo.dev/zh/docs/mcp/windsurf
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: 5e5cb3cd0b8eb84a3637bb84424ecc107ee13595a609a88d8d53d2f712799031
- Edition-Digest: 25ef583ec8f4d765e7ab1b6f473ad82bfbab717c5bf05f16fc69a4a5affc40f8
- Source-Revision: sha256:117e4921d1aa58f84dd035761b8310480f5d3f9e14e829bf87df7418a810cafd

## 前置条件

使用支持直连 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 用户应手动配置或移动该文件。

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

## 设置凭据

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

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

## 生成 / 确认 XMEMO_AGENT_INSTANCE_ID

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

```bash
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 调用，而不是健康检查占位符，并且不会写入记忆。

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

## 预期响应（字面结构）

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

```text
### 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 中手动配置。

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