문서 업데이트: 이 레거시 단일 페이지 개요는 이전되었습니다. 새로운 문서 홈 및 다중 페이지 가이드를 살펴보세요.
문서 홈으로 이동 →

XMemo 빠른 시작

XMemo를 AI 어시스턴트가 함께 사용하는 메모리 공간으로 활용하세요. 클라이언트를 연결하고 유용한 맥락을 한 번 저장한 뒤 필요할 때 다시 불러오며, 인증 정보는 공개 설정에 넣지 않습니다.

소개 #

XMemo를 AI 어시스턴트가 함께 사용하는 메모리 공간으로 활용하세요. 클라이언트를 연결하고 유용한 맥락을 한 번 저장한 뒤 필요할 때 다시 불러오며, 인증 정보는 공개 설정에 넣지 않습니다.

하나의 메모리 공간

승인된 보조자가 기억할 수 있는 사용자 소유 메모리 계층에 내구성 있는 기본 설정, 프로젝트 사실, 결정 및 전달 메모를 보관하십시오.

클라이언트 연결

ChatGPT, Claude, VS Code/GitHub Copilot, Copilot CLI, Codex, Gemini, Cursor 또는 직접 MCP 실행기에 대한 클라이언트 프로필과 함께 호스팅된 MCP URL을 사용합니다.

통제력 유지

지원되는 경우 OAuth, 직접 클라이언트에 대한 환경 비밀 전달, 검토, 삭제 및 내보내기 경계에 대한 계정 제어를 사용합니다.

Persona onboarding flows #

ChatGPT 사용자

Goal
채팅에 전달자 토큰을 붙여넣지 않고도 XMemo 기본 설정, 프로젝트 사실, 결정 및 TODO에 대한 지속 가능한 액세스를 ChatGPT에 부여하세요.
Connection
ChatGPT/OpenAI 앱 OAuth 흐름을 통해 호스팅된 XMemo MCP 서버를 연결한 다음 XMemo 계정에 대한 메모리:읽기 및 메모리:쓰기 권한을 승인합니다.
Success action
종합 기본 설정이나 프로젝트 노트를 저장하고 새 채팅을 시작한 다음 작업을 계속하기 전에 XMemo를 통해 ChatGPT에 이를 불러오도록 요청하세요.
Troubleshooting
OAuth가 실패하거나 도구가 표시되지 않으면 호스트 앱의 MCP 서버에서 로그아웃하고 XMemo 서버 URL을 다시 연결한 후 직접 토큰을 생성하기 전에 다시 시도하세요.

부조종사/Codex 개발자

Goal
IDE와 CLI 에이전트 간에 리포지토리 결정, 코딩 규칙, 버그 수정 메모, 작업 기록을 전달합니다.
Connection
가능한 경우 VS Code / GitHub Copilot 및 Gemini CLI에 OAuth를 사용하세요. Copilot CLI, Codex, Cursor 또는 기타 직접 MCP 클라이언트의 경우 로컬 환경 또는 보안 저장소에 XMEMO_KEY를 유지하고 안정적인 XMEMO_AGENT_INSTANCE_ID를 설정하세요.
Success action
코드베이스 결정이나 버그 수정을 기록한 후 편집하기 전에 다음 IDE 또는 CLI 에이전트에게 관련 XMemo 컨텍스트를 기억하도록 요청하세요.
Troubleshooting
회수가 비어 있는 경우 선택한 MCP 구성 경로, 직접 클라이언트용 XMEMO_KEY 환경 변수 및 호스트 앱의 오래된 OAuth 자격 증명을 확인하세요.

팀/엔터프라이즈 파일럿 소유자

Goal
계정 제어, 소스 속성, 내보내기/삭제 워크플로, 검토자에게 안전한 설정 증거를 통해 공유 메모리를 평가합니다.
Connection
보호된 XMemo 작업 공간을 생성하거나 입력하고 승인된 사용자를 초대한 다음 준비 배지에 따라 OAuth 또는 범위가 지정된 직접 자격 증명을 통해 각 클라이언트를 연결합니다.
Success action
파일럿 멤버에게 가상 팀 메모리를 저장하고 XMemo에서 소스 속성을 확인한 다음 삭제/내보내기 및 지원 경로를 검토하도록 합니다.
Troubleshooting
구성원이 연결할 수 없는 경우 새 토큰을 발급하기 전에 역할 권한, OAuth 승인, 클라이언트 준비 상태 및 지원 지침을 확인하세요.

자율 에이전트 운영자

Goal
헤드리스 또는 예약 에이전트가 진행 상황을 기록하고, 이전 결정을 검색하고, 안정적이고 비밀이 아닌 인스턴스 ID를 유지하도록 합니다.
Connection
/api/v1/mcp/config/autonomous-agent를 가져옵니다. 실행기가 OAuth + 사용자 정의 헤더를 지원하는 경우 auth_modes.oauth를 선호합니다. 완전 헤드리스 러너에 대해서만 비밀 저장소의 XMEMO_KEY와 함께 auth_modes.xmemo_key를 사용하십시오.
Success action
XMemo에 진행 상황을 기록하는 하나의 합성 작업을 실행하고 실행기를 다시 시작한 다음 동일한 XMEMO_AGENT_INSTANCE_ID를 사용하여 해당 진행 상황을 호출하는지 확인합니다.
Troubleshooting
속성이 변경되거나 인스턴스 간에 분할된 경우 git 외부에서 XMEMO_AGENT_INSTANCE_ID를 유지하고 실행기가 시작할 때마다 이를 다시 생성하지 않는지 확인하세요.

메모리 콘솔 컨트롤 #

XMemo는 단순한 MCP 엔드포인트가 아닙니다. 메모리 콘솔은 에이전트 속성을 표시하면서 메모리를 검토, 수정, 제거 및 내보낼 수 있는 사용자 대면 공간입니다.

메모리 보기 및 검색

콘솔을 열어 저장된 메모리를 확인하고, 경로와 메모리 유형을 검사하고, 리콜이 특정 항목을 반환해야 하는지 여부를 확인하세요.

항목 편집 또는 수정

오래된 사실을 수정하고, 항목을 더 명확한 경로로 이동하거나, 오래된 메모를 교체하여 미래의 보조자가 사용자가 승인한 최신 컨텍스트를 기억할 수 있도록 하세요.

삭제 및 내보내기

계정 워크플로를 사용하여 더 이상 원하지 않는 추억을 제거하고 계정 범위 메모리 검토를 위한 내보내기 경로를 찾으세요.

상담원 속성

클라이언트가 보낼 때 비밀이 아닌 에이전트 및 인스턴스 레이블을 포함하여 어떤 클라이언트 또는 실행기가 메모리를 썼는지 검토합니다.

개인 정보 보호 및 자격 증명 제어

개인 또는 팀 파일럿을 확장하기 전에 OAuth 동의, 직접 토큰 사용, 환경 비밀 전달 및 지원 경계를 눈에 띄게 유지하세요.

XMemo 액세스 요청 #

계좌입력 열기 ↗

호스팅된 XMemo 빠른 시작 #

관리형 XMemo 서비스와 다음 연결 경로 중 하나로 시작하세요. 자체 호스팅, Docker, Supabase 및 Python 패키지 설정은 개발자 참조이며 호스팅 사용자를 위한 첫 번째 경로가 아닙니다.

대리인에게 물어보세요

일반적인 안전 확인을 따르도록 신뢰하는 에이전트에 이를 붙여넣으세요.

독립 실행형 XMemo Skill을 skills 디렉터리에 설치하세요: XMEMO_SKILL_DIR을 skills 디렉터리 + /xmemo-memory로 설정하고 https://xmemo.dev/skill/install(Windows의 경우 https://xmemo.dev/skill/install.ps1)에서 설치 프로그램을 실행합니다. 출력된 doctor 명령을 실행하여 설치를 확인한 다음, skills를 다시 로드하고 Skill의 첫 실행 단계를 따르세요. 일반적인 안전 점검을 준수하고 높은 권한을 사용하지 마십시오.

OAuth 클라이언트

호스트가 OAuth를 지원하는 경우 ChatGPT, OpenAI 앱 검토, VS Code 및 GitHub Copilot에 이 경로를 사용하세요. 호스팅된 MCP URL을 추가하고, 메모리:읽기 및 메모리:쓰기를 승인하고, XMEMO_KEY를 클라이언트 구성에 붙여넣지 마세요.

MCP URL: https://xmemo.dev/mcp
Scopes: memory:read memory:write

XMEMO_KEY를 사용한 직접 MCP

OAuth를 완료할 수 없는 클라이언트 또는 헤드리스 실행자에만 이 경로를 사용하십시오. XMEMO_KEY를 로컬 환경이나 비밀 저장소에 저장하고, 호스팅된 MCP URL을 구성에 유지하고, 실제 토큰을 공개 문서나 채팅에 붙여넣지 마십시오.

MCP URL: https://xmemo.dev/mcp
Token source: XMEMO_KEY environment variable
Optional identity: XMEMO_AGENT_INSTANCE_ID

계정 관리

첫 번째 연결 후 파일럿을 확장하기 전에 계정 항목을 사용하여 저장된 내용을 검토하고, 상담원 속성을 확인하고, 삭제/내보내기 또는 지원 경로를 찾으세요.

Account entry: https://xmemo.dev/login

공공 안전 #

  • 공개 검색은 읽기 전용이며 비밀이 없습니다.
  • Client setup requires secrets in environment variables or a system secret store, not in generated URLs.
  • 공개 제품 문서는 운영자 콘솔, API 문서, 검색 JSON, 설치 프로그램 카탈로그, 원시 부트스트랩 URL, 원시 서비스 URL 및 자격 증명 자료에 대한 링크를 의도적으로 피합니다.

소스 증거 #

XMemo 검색 경로, 호스팅된 검색 계약, MCP 서버 및 TypeScript SDK의 소스 지원 문서입니다.

FAQ / 문제 해결 #

  • 왜 AI assistant가 전에 말한 내용을 기억하지 못하나요? —
  • 왜 AI assistant가 project나 conversation을 혼동하나요? —
  • AI assistant가 어떤 내용을 완전히 잊게 하려면 어떻게 해야 하나요? —
  • 컴퓨터나 AI assistant를 바꾸면 XMemo는 여전히 저를 기억하나요? —
  • 왜 AI assistant가 같은 내용을 두 번 저장했나요? —
  • 왜 AI assistant가 과거 context를 너무 많이 또는 너무 적게 주나요? —
  • XMemo 연결을 끊은 뒤 이전 assistant가 사용할 수 없게 하려면 어떻게 해야 하나요? —
  • 왜 AI assistant가 더 이상 XMemo를 사용할 수 없나요? —
  • AI assistant에서 어떤 XMemo connection을 사용해야 하나요? —
  • AI assistant가 여전히 XMemo에 연결되지 않으면 어떻게 해야 하나요? —

사전 요구 사항 #

  • Approved service URL - Used by xmemo setup --url to fetch discovery, onboarding status, and MCP config templates.
  • Node.js and npm - Discovery and the product page advertise @xmemo/client as the public CLI package.
  • Scoped token or OAuth grant - ChatGPT and VS Code / GitHub Copilot use OAuth; direct MCP and REST clients use XMEMO_KEY from an environment variable or secret store.

XMemo와 연결 #

xmemo setup --url drives the entire trial. The documented hosted setup flow is implemented as discovery → onboarding status → MCP config template → reviewed client configuration.

npm install -g @xmemo/client
npx @xmemo/client setup --url https://xmemo.dev

MCP 구성 #

XMemo MCP setup lives in Docs because auth differs by client. ChatGPT, VS Code / GitHub Copilot, and Gemini CLI use hosted OAuth; direct/headless clients use the hosted Streamable HTTP URL plus XMEMO_KEY from the local environment or secret store.

VS Code / GitHub Copilot

%APPDATA%\Code\User\mcp.json

{
  "servers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "cursor",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Codex

~/.codex/config.toml

[mcp_servers.XMemo]
url = "https://xmemo.dev/mcp"
bearer_token_env_var = "XMEMO_KEY"

[mcp_servers.XMemo.http_headers]
X-Memory-OS-Agent-ID = "codex"

[mcp_servers.XMemo.env_http_headers]
X-Memory-OS-Agent-Instance-ID = "XMEMO_AGENT_INSTANCE_ID"

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "gemini-cli",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Devin Desktop (formerly Windsurf)

~/.config/devin/mcp_config.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}"
      }
    }
  }
}

Kiro

~/.kiro/settings/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "kiro",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "oauth": {
        "oauthScopes": [
          "memory:read",
          "knowledge:read"
        ]
      }
    }
  }
}

Muse Code

~/.config/muse/settings.json

{"schema_version": 1, "mcpServers": {"xmemo": {"type": "streamable-http", "url": "https://xmemo.dev/mcp", "mode": "optional"}}}

OpenClaw

~/.openclaw/openclaw.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Copilot CLI

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

ChatGPT / OpenAI Apps SDK

OpenAI Platform 앱 관리 대시보드

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "transport": "streamable-http",
      "auth": {
        "type": "oauth2",
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      }
    }
  }
}

Autonomous agent

에이전트 실행기 MCP 구성

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "autonomous-agent",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "auth": {
        "type": "oauth2",
        "flow": "authorization_code",
        "pkce_required": true,
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      },
      "fallback": {
        "use_when": "headless runner cannot complete OAuth sign-in or persist OAuth tokens",
        "authorization_header": "Bearer ${XMEMO_KEY}"
      }
    }
  }
}

Other

모든 MCP 가능 에이전트

{
  "mcpServers": {
    "XMemo": {
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "${XMEMO_AGENT_ID}",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Kimi Code

~/.kimi-code/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "bearerTokenEnvVar": "XMEMO_KEY",
      "headers": {
        "X-Memory-OS-Agent-ID": "kimi-code",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Code

~/.claude.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-code",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Cline (VS Code)

~/Documents/Cline/MCP/cline_mcp_settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "cline",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Continue (VS Code / JetBrains)

~/.continue/config.json

{
  "mcpServers": {
    "XMemo": {
      "transport": {
        "type": "streamable-http",
        "url": "https://xmemo.dev/mcp",
        "headers": {
          "Authorization": "Bearer ${XMEMO_KEY}",
          "X-Memory-OS-Agent-ID": "continue",
          "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
        }
      }
    }
  }
}

Zed

Zed settings.json (varies by OS)

{
  "context_servers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:zed",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Trae

Trae user config mcp.json (varies by OS)

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:trae",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Grok

~/.grok/config.toml

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "grok",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Antigravity 2.0

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "XMemo": {
      "serverUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "antigravity",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Qwen

~/.qwen/settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "qwen",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

OpenCode

~/.config/opencode/opencode.json

{
  "mcp": {
    "XMemo": {
      "type": "remote",
      "url": "https://xmemo.dev/mcp",
      "enabled": true,
      "headers": {
        "X-Memory-OS-Agent-ID": "opencode",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Client capability matrix #

The canonical matrix is the source of truth for each client's OAuth mode, MCP transport, credential handling, readiness, evidence boundary, and marketplace state. This page only provides the setup console; do not copy a status into another page without checking the matrix.

Read CLIENT_CAPABILITY_MATRIX.md on GitHub ↗

자율 에이전트 사전 설정 #

Autonomous agents should fetch /api/v1/mcp/config/autonomous-agent instead of asking humans to choose identity fields.

MCP 도구 표면 #

The discovery response lists the actual MCP transport as streamable-http and advertises tools implemented by the XMemo MCP server.

  • Recall tools - search_memory, recall, recall_plan, and recall_context.
  • Write tools - remember, store_memory, update_memory, and record_event.
  • Governance tools - forget_memory, redact_memory, explain_memory, and conflict/version helpers.

SDK 워크플로 도우미 #

The TypeScript SDK exposes workflow helpers in packages/memory-os-js. These helpers route events through capture policy before writing memory.

기술 및 에이전트 #

Skills are the instruction-and-command lane for agents that do not mount a hosted MCP server directly.

다음 단계 #