MCP 개요

AI 환경에 XMemo 연결

XMemo는 Claude, ChatGPT, Codex, GitHub Copilot, OpenClaw, Hermes, DeepSeek Harness, Microsoft Agent Framework 및 개방형 AI 에이전트 런타임 전반에 지속적인 프로젝트 메모리를 제공합니다. 클라이언트는 호스팅된 Streamable HTTP 엔드포인트에 직접 연결하거나 @xmemo/client에 포함된 1차 xmemo-mcp stdio 프록시를 통해 연결합니다.

• claude.ai의 Claude 및 Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending): 사용자 지정 커넥터로 https://xmemo.dev/mcp 에 OAuth로 연결하며, 커넥터에 API key가 필요하지 않습니다 (/docs/mcp/claude).
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Claude Code 및 Cowork를 위한 메모리 워크플로, 수명 주기 체크포인트 및 크로스 에이전트 연속성 (/docs/mcp/claude-code).
• ChatGPT (Axis A: Hosted beta pilot; Evidence required for any refreshed external claim · Axis B: Manual MCP Configuration; Marketplace pending): 메모리 워크플로 및 대화형 워크스페이스(TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt).
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration): Skill 기반 프로젝트 메모리 및 MCP 권한 부여 (/docs/mcp/codex).
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration): Recall 우선 스킬 안내 및 ClawHub의 네이티브 OpenClaw 메모리 플러그인 (/docs/connect/openclaw).
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration): 세션 체크포인트 및 자동 캡처를 지원하는 PyPI의 네이티브 Hermes 메모리 플러그인(hermes-xmemo) (/docs/connect/hermes).
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration): CLI 실행 루프 메모리를 위한 npm의 네이티브 dsh 에이전트 하네스 플러그인(dsh-xmemo) (/docs/connect/deepseek-harness).
• Microsoft Agent Framework(출시 상태: 계획됨, 패키지 공개 대기 · 통합 방식: 네이티브 통합): Python 컨텍스트 검색과 선택적 캡처를 제공하는 독립적인 커뮤니티 통합이며 Microsoft의 공식 제품이나 배포판이 아닙니다(/docs/connect/microsoft-agent-framework).
• GitHub Copilot & VS Code (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): IDE 및 CLI 에이전트를 위한 MCP 통합 (/docs/mcp/copilot).
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): settings.json에 Bearer 자격 증명을 배치하지 않는 OAuth 우선 구성.

두 가지 직교 전달 축: 가용성 및 배포 모드

클라이언트 통합은 두 가지 독립적인 축에 따라 분류됩니다. Axis A는 경험적 준비 상태 및 가용성 상태(Released, Pilot / Entitled, 또는 Planned)를 나타내며, Axis B는 통합 및 배포 모드(Official Marketplace, Community Directory, Native Integration 또는 Manual MCP Configuration)를 정의합니다. 전달 채널이 가용성을 결정하지 않으며, 로드맵 기능은 프로덕션 런타임과 엄격하게 구별됩니다.

• Axis A (Availability / Evidence Status): Released(프로덕션에서 완전히 작동), Pilot / Entitled(호스팅된 베타 파일럿 또는 상업적 권한 필요), Planned(명시적인 미래 예측 공개가 필요한 로드맵 항목).
• Axis B (Integration / Distribution Mode): Official Marketplace(ClawHub 공식 스킬 등 벤더 검토 목록), Community Directory(서드파티 인덱스 목록), Native Integration(임베디드 런타임 지원), Manual MCP Configuration(사용자 구성 JSON 스니펫).

4가지 통합 연결 경로

클라이언트 아키텍처 및 운영 모델과 일치하는 연결 경로를 선택하세요:

• 경로 1 (에이전트에 요청 — 독립형 Skill): 호환 에이전트(Claude Code, Codex)용. https://xmemo.dev/skill/install 을 통해 클라이언트의 skills 디렉토리에 검증된 Skill을 설치합니다.
• 경로 2 (OAuth 기반 호스팅된 MCP): 데스크톱 및 호스팅된 클라이언트(ChatGPT, claude.ai 및 Claude Desktop의 Claude 사용자 지정 커넥터, Cursor, VS Code Copilot)용. 수동 토큰 처리 없이 https://xmemo.dev/mcp 에 연결합니다.
• 경로 3 (XMEMO_KEY를 사용한 직접 MCP): 헤드리스 러너 및 CI 환경용. Streamable HTTP를 통해 로컬 환경 변수로 Bearer 토큰을 안전하게 전달합니다.
• 경로 4 (퍼스트 파티 stdio 프록시 — xmemo-mcp): stdio 전용 데스크톱 클라이언트, 사용자 지정 커넥터를 사용하지 않는 Claude Desktop 구성 또는 직접적인 Streamable HTTP 지원이 부족한 도구용. 공식 @xmemo/client CLI 패키지는 호스팅된 서비스(https://xmemo.dev)로 연결되는 자체 포함된 로컬 stdio 프록시로 xmemo-mcp(npx -y -p @xmemo/client xmemo-mcp 또는 xmemo mcp serve를 통해 실행 가능)를 제공합니다.

OAuth 클라이언트 구성

호스팅된 URL이 전체 구성입니다. 권한 부여가 스코프를 제공합니다.

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

직접 토큰 구성

OAuth를 완료할 수 없는 헤드리스 러너는 대신 환경 변수에서 토큰을 읽습니다.

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "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}"
      }
    }
  }
}

퍼스트 파티 stdio 프록시 구성 (xmemo-mcp)

Claude Desktop에서는 사용자 지정 커넥터와 OAuth (/docs/mcp/claude)를 먼저 사용하세요. 이 API key 구성은 대안입니다. stdio 전용 클라이언트의 경우 공식 @xmemo/client CLI 패키지는 https://xmemo.dev 로 연결되는 독립형 로컬 stdio 프록시로 xmemo-mcp를 제공합니다. 실제 API key를 붙여넣으세요. Claude Desktop은 ${env:...} 변수를 확장하지 않습니다:

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "@xmemo/client",
        "xmemo-mcp"
      ],
      "env": {
        "XMEMO_KEY": "<your-xmemo-api-key>",
        "XMEMO_URL": "https://xmemo.dev"
      }
    }
  }
}

프로필 한정 도구 표면

사용 가능한 도구는 config/mcp-documentation-contract.json의 클라이언트 기능에 따라 프로필 한정됩니다:

• Cursor 프로필 (cursor-plugin): 충돌 해결, 스냅샷 및 Cloud Skills를 위한 도구를 제공합니다.
• ChatGPT 프로필 (chatgpt-public): 대화형 워크스페이스(TODO Board, Ledger, Project Workspace)를 위한 도구를 제공합니다.
• Claude 공개 프로필 (claude-public): 프로젝트 메모리, 원장 요약 및 능동 회상을 위한 도구를 제공합니다.
• Claude 플러그인 프로필 (claude-plugin): 스냅샷, 결정 기록 및 프로젝트 연속성을 위한 도구를 제공합니다.
• 일반 공개 프로필 (generic-public): 표준 MCP 클라이언트를 위한 도구를 제공합니다.

후보 통합 및 검증되지 않은 배포

XMemo는 검증된 증거를 통해 새로운 클라이언트 통합 및 편집기 확장을 추적합니다. 다음 후보 경로는 검증되지 않았거나 메인테이너 검토 대기 중이며, 마켓플레이스 가용성이나 공식적인 보증은 주장되지 않습니다:

• VS Code 네이티브 확장 (xmemo-vscode): 소스 저장소(yonro/xmemo-vscode @ bf08e7c237, v0.1.1)와 CI 워크플로가 존재하지만 Visual Studio Marketplace 게시는 확인되지 않았으며 Open VSX는 404를 반환했습니다. 사용자는 검증되지 않은 확장 패키지 대신 검증된 호스팅된 MCP 또는 Copilot Chat 구성(/docs/mcp/copilot)을 통해 VS Code를 연결해야 합니다.
• Cindy Ghost Plugin (xmemo-cindy-plugin): Ghost 플러그인 후보(yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0)는 공개 GitHub Releases나 검증된 배포 채널이 관찰되지 않은 채 메인테이너 검토 대기 중입니다.
• Shared Skills Package (@xmemo/skills): 저장소 소스는 존재하지만 공개 npm 검색에서 404를 반환했습니다. 대신 검증된 독립형 Skill(@xmemo/skill)을 사용하세요.

runner가 스스로 구성하게 하기

자율 러너는 사람에게 자격 증명 값을 입력하도록 요청하는 대신 자체 사전 설정을 가져올 수 있습니다.

curl -s https://xmemo.dev/api/v1/mcp/config/autonomous-agent