Devin Desktop (formerly Windsurf)

사전 요구 사항

직접 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 사용자는 수동으로 구성하거나 파일을 이동해야 합니다.

{
  "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({ query: "connection check", limit: 1 })

예상 응답 (리터럴 형태)

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

### 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에서 수동으로 구성합니다.