# Devin Desktop (formerly Windsurf)

XMEMO_KEY 및 안정적인 인스턴스 귀속을 사용하여 직접 연결 Devin Desktop (이전 Windsurf) MCP 클라이언트를 구성합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/mcp/windsurf
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: 5e5cb3cd0b8eb84a3637bb84424ecc107ee13595a609a88d8d53d2f712799031
- Edition-Digest: 334e61ddfdd78efb34e0285e77d73cb020b3d01b1a7db3566f2a81ffda01fefd
- Source-Revision: sha256:117e4921d1aa58f84dd035761b8310480f5d3f9e14e829bf87df7418a810cafd

## 사전 요구 사항

직접 MCP 구성 지원 기능이 있는 Devin Desktop (이전 Windsurf)을 사용합니다. Devin Desktop은 serverUrl을 통해 구성된 Streamable HTTP 전송을 통해 XMEMO_KEY가 있는 환경 지원 베어러 토큰을 사용하여 직접 연결합니다.

- Endpoint: https://xmemo.dev/mcp.
- Transport: Streamable HTTP (serverUrl을 사용하여 구성).
- Auth mode: XMEMO_KEY의 직접 베어러 토큰.
- Config file: ~/.config/devin/mcp_config.json (Windows의 경우 %APPDATA%\devin\mcp_config.json, 이름 변경 전 설치의 경우 ~/.codeium/windsurf/mcp_config.json 사용).
- Client ID: windsurf (호환성을 위해 windsurf로 유지).
- 준비 상태: 증거 필요 (계획된 마켓플레이스, 인증되지 않음).

## 설치 / 설정

수동 구성: ~/.config/devin/mcp_config.json (Windows의 경우 %APPDATA%\devin\mcp_config.json)의 mcpServers 아래에 XMemo 서버 블록을 추가합니다. 참고: 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 호출은 읽기 전용으로 수행합니다. 이것은 헬스체크 플레이스홀더가 아닌 실제 회상 호출이며 메모리를 작성하지 않습니다.

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

## 예상 응답 (리터럴 형태)

성공적인 호출은 아래의 공개 순위 지정 텍스트 형태를 반환합니다. 참조 및 콘텐츠는 승인된 메모리 공간의 실제 값입니다.

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

## 일반적인 오류

Devin Desktop은 직접 베어러 클라이언트입니다. 연결 문제가 발생하면 환경 변수를 확인하십시오.

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