커넥터 가이드

Claude에 Kumiho Memory 연결하기

Kumiho Memory는 대화가 끝나도 남는 메모리를 Claude에 제공합니다. 한 번 연결하면 Claude는 모든 대화를 사용자가 누구인지, 어떤 방식으로 일하는지, 지난번에 무엇을 결정했는지 아는 상태로 시작합니다.

한눈에 보기

서버 URL: https://mcp.kumiho.cloud/mcp
전송 방식: MCP Streamable HTTP (SSE 미지원)
인증: OAuth 2.1, authorization code + PKCE (S256)
도구: 18개, 모두 사용자 워크스페이스로 범위 한정
팀 연결 방식: x-api-key 헤더의 워크스페이스 API 키
필요 조건: 유료 Kumiho Cloud 워크스페이스 (월 $7부터)

무엇인가요

대부분의 메모리 도구는 텍스트를 저장하고 유사도 검색이 그것을 다시 찾아주기를 기대합니다. Kumiho는 그래프를 저장합니다. 모든 메모리는 결정·선호·사실·정정이라는 타입을 가진 노드이며, 그것이 다루는 대상 및 그것을 만들어낸 근거와 연결됩니다. 회상은 그 연결을 따라가므로 "왜 여기서 Postgres를 선택했지?"라고 물으면 결정과 그 근거, 그리고 기각된 대안까지 돌아옵니다.

mcp.kumiho.cloud의 커넥터는 Model Context Protocol 리소스 서버입니다. 자체 데이터베이스를 갖지 않으며, 모든 요청은 인증되고 사용자 워크스페이스로 범위가 한정된 뒤 뒤편의 Kumiho 그래프로 전달됩니다.

이전 메모리와 모순되는 이야기를 하면 Claude는 두 개의 상충하는 버전을 쌓는 대신 기존 메모리를 대체합니다. 무언가를 잊어달라고 하면 해당 메모리를 퇴역시켜 더 이상 회상되지 않게 합니다.

Claude 앱에서 연결하기

Claude 웹 또는 데스크톱의 커넥터 화면에서 시작하세요. 연결된 서비스는 지원되는 모바일·Cowork 환경에서도 사용할 수 있습니다.

1
사용자 정의(Customize) → 커넥터를 엽니다.
2
디렉터리에 Kumiho Memory가 제공되면 선택해 연결합니다. 아직 보이지 않으면 위 서버 URL로 커스텀 웹 커넥터를 추가하세요.
3
열리는 창에서 Kumiho에 로그인하고 연결을 승인합니다.
4
새 대화를 시작해 "나에 대해 무엇을 기억하고 있어?"라고 물어보세요.

Team·Enterprise에서는 소유자가 커넥터를 먼저 허용한 뒤 구성원이 OAuth로 연결해야 할 수 있습니다. 커스텀 헤더를 지원하는 클라이언트는 아래 API 키 대안을 참고하세요.

Kumiho Memory 스킬 추가하기 (claude.ai)

커넥터는 Claude에 메모리 도구를 제공하고, Kumiho Memory 스킬은 그 도구를 언제 쓸지 알려줍니다. 언제 회상하고 무엇을 저장할지, session_required 재시도를 어떻게 처리할지, 그리고 인증 정보는 절대 저장하지 않는다는 원칙이 담겨 있습니다. 스킬이 있으면 요청할 때만이 아니라 대화 내내 메모리가 제대로 동작합니다.

claude.ai와 Claude 데스크톱 채팅에서는 현재 커넥터의 서버 지침이 Claude에 전달되지 않으므로, 이 스킬을 업로드해야 Claude가 그 가이드를 받습니다. Claude Code와 Cowork에서는 Kumiho Memory 플러그인에서 자동으로 받으므로 따로 업로드할 필요가 없습니다.

시작하기 전에

Kumiho Memory 커넥터가 위 안내대로 이미 연결되어 있어야 합니다. 커넥터에는 유료 Kumiho Cloud 워크스페이스가 필요합니다.
스킬을 지원하는 Claude 플랜: Free, Pro, Max, Team, Enterprise.
코드 실행이 켜져 있어야 합니다. Free·Pro·Max에서는 설정 → 기능에서 코드 실행 및 파일 생성을 확인하세요. Team·Enterprise에서는 소유자가 조직 설정 → 스킬에서 관리합니다.

1
스킬을 다운로드합니다. zip 파일 그대로 업로드해야 하므로, 브라우저가 압축을 풀었다면 kumiho-memory 폴더를 다시 압축하세요.
kumiho-memory-skill.zip 다운로드
2
Claude에서 사용자 정의(Customize) → 스킬을 엽니다. +를 누르고 스킬 만들기 → 스킬 업로드를 선택한 뒤 zip 파일을 고릅니다.
3
스킬 목록에서 kumiho-memory 스킬을 켭니다.
4
새 채팅을 시작해 "나에 대해 무엇을 기억하고 있어?"라고 물어보세요.

zip 파일(5.8 KB)에는 일반 Markdown으로 작성된 kumiho-memory/SKILL.md 파일 하나만 들어 있습니다. 다운로드한 스킬이 모두 그렇듯, 켜기 전에 내용을 읽어보세요. GitHub에서 SKILL.md 보기

Team·Enterprise 플랜에서는 소유자가 조직 설정 → 스킬에서 같은 zip을 업로드해 모든 구성원에게 스킬을 제공할 수 있습니다.

Claude Code에서 연결하기

명령 한 줄이면 됩니다. Claude Code가 첫 사용 시 브라우저에서 OAuth 절차를 실행합니다.

claude mcp add --transport http kumiho-memory https://mcp.kumiho.cloud/mcp

--scope user 를 붙이면 현재 프로젝트가 아니라 모든 프로젝트에서 커넥터를 사용할 수 있습니다.

다시 제거하려면:

claude mcp remove kumiho-memory

처음 연결할 때 일어나는 일

Claude가 인증 위치를 찾습니다

인증되지 않은 요청에 대해 서버는 보호 리소스 메타데이터의 위치를 알려주고, 그 메타데이터가 control.kumiho.cloud를 인증 서버로 지정합니다. 사용자가 설정할 것은 없습니다.

Kumiho에 로그인합니다

Kumiho 동의 화면이 열립니다. Kumiho 계정으로 로그인하면 어떤 클라이언트가 요청하는지와 어디로 리디렉션되는지가 표시됩니다. 연결 전에 유료 Kumiho Cloud 워크스페이스를 준비하세요.

워크스페이스를 선택합니다

여러 Kumiho 워크스페이스에 속해 있다면 이 연결이 사용할 워크스페이스를 고릅니다. 액세스 토큰이 그 워크스페이스를 담고, 모든 호출이 그 기준으로 필터링됩니다.

Claude가 범위가 제한된 토큰을 받습니다

연결에는 memory 스코프와, 다시 로그인하지 않고 갱신할 수 있도록 offline_access가 부여됩니다. 그 밖의 Kumiho 계정 영역에는 이 토큰으로 접근할 수 없습니다.

18개의 도구

모든 도구에는 제목과 함께 읽기 전용 또는 파괴적 힌트가 붙어 있어, Claude도 사용자도 호출이 무엇을 할지 한눈에 알 수 있습니다. 어떤 도구도 사용자 워크스페이스 밖에는 닿지 않습니다.

읽기 전용쓰기쓰기 · 대체 가능파괴적

메모리

장기 메모리 그래프를 읽고 쓰는 도구입니다.

kumiho_memory_engage읽기 전용

요청한 메모리 작업에 관련된 이전 기억과 출처 참조를 회상합니다.

kumiho_memory_recall읽기 전용

자연어로 설명한 필요에 대해 메모리 그래프를 시맨틱 검색합니다.

kumiho_memory_retrieve읽기 전용

질의와 컨텍스트로 저장된 메모리를 검색합니다.

kumiho_memory_store쓰기 · 대체 가능

유형과 내용을 갖춘 메모리 하나를 기록합니다.

kumiho_memory_reflect쓰기 · 대체 가능

여러 개의 타입이 있는 메모리를 한 번에 저장합니다. 무언가 확정되었을 때 기록되는 일반적인 경로입니다.

kumiho_memory_consolidate쓰기 · 대체 가능

이 대화의 작업 버퍼를 장기 메모리로 접어 넣고 버퍼를 비웁니다.

kumiho_memory_decompose쓰기 · 대체 가능

과적재된 메모리를 타입이 있는 엔티티·사실·관계로 분해해 이후 회상이 그 사이를 건너갈 수 있게 합니다.

kumiho_memory_space_profile쓰기

메모리 스페이스가 무엇을 담고 있고 어떻게 쓰이는지 요약합니다.

지식 그래프

메모리가 저장된 워크스페이스를 탐색하는 도구입니다.

kumiho_list_projects읽기 전용

워크스페이스의 프로젝트를 나열합니다.

kumiho_get_spaces읽기 전용

프로젝트의 메모리·지식 스페이스를 나열합니다.

kumiho_search_items읽기 전용

이름·종류·컨텍스트로 지식 아이템을 검색합니다.

kumiho_get_item읽기 전용

지식 아이템 하나와 그 메타데이터를 읽습니다.

kumiho_get_revision_by_tag읽기 전용

아이템의 특정 태그 리비전을 읽습니다.

kumiho_get_provenance_summary읽기 전용

어떤 지식이 어디에서 왔고 무엇에서 파생되었는지 보여줍니다.

kumiho_create_space쓰기

메모리를 정리할 새 스페이스를 만듭니다.

kumiho_deprecate_item파괴적

일반 회상에서 메모리를 제외합니다. 이전 데이터는 남으며 영구 삭제가 아닙니다.

대화 버퍼

현재 대화의 단기 작업 메모리입니다.

kumiho_chat_get읽기 전용

이 대화의 작업 메모리 버퍼를 읽습니다.

kumiho_chat_clear파괴적

이 대화의 작업 메모리 버퍼를 버립니다.

왜 네 개의 쓰기 도구가 파괴적으로 표시되나요

store, reflect, consolidate, decompose에는 파괴적 힌트가 붙어 있습니다. 저장은 기존 메모리의 published 태그를 새 리비전으로 옮길 수 있고, consolidate는 버퍼를 접어 넣으면서 비우며, decompose는 더 새로운 사실이 대체한 사실을 강등할 수 있습니다. 이전 리비전은 히스토리에 남아 아무것도 삭제되지 않지만, 다음번에 Claude가 회상하는 메모리가 지난번과 다를 수 있습니다. 그래서 확인 프롬프트를 받을 가치가 있습니다.

의도적으로 빠진 것

Kumiho SDK에는 63개의 도구가 있지만 커넥터 프로필은 엄선된 18개입니다. 프로젝트·스페이스 삭제, 리비전 삭제, 번들 관리, 엣지 수술, git에 의존하는 코드 도구는 노출되지 않습니다. 또한 서버는 프로필 밖의 도구 호출을 거부하므로, 목록에서 감추는 것만이 유일한 차단 수단은 아닙니다.

메모리의 범위

OAuth로 연결하면 사용자 단위

액세스 토큰은 워크스페이스 하나와 그 안의 사용자 한 명을 지정하고, 모든 백엔드 호출이 그 쌍으로 필터링됩니다. 같은 워크스페이스의 다른 구성원이라도 내 토큰이나 대화 버퍼, 서버가 내 호출을 위해 캐시한 핸들을 재사용할 수 없습니다.

장기 메모리는 워크스페이스 단위

메모리는 채팅창이 아니라 워크스페이스에 있습니다. 그것이 핵심입니다. 아침에 휴대폰에서 연결해 배운 내용이 저녁의 Claude Code에도, 같은 워크스페이스를 쓰는 Claude Code 플러그인에도 그대로 있습니다.

관리자가 API 키로 연결하면 공유

지원 클라이언트에서 워크스페이스 API 키로 인증하면 그 키를 사용하는 모두가 워크스페이스 신원을 공유합니다. 팀 메모리의 취지가 그것이며, 분명히 말해 사용자별 격리는 아닙니다.

알려진 한계: 대화 하나에 버퍼 하나

버퍼를 쓰는 네 도구 — reflect, consolidate, chat get, chat clear — 는 자신이 어느 대화에 속하는지 알아야 합니다. Claude는 원격 MCP 서버에 대화 식별자를 보내지 않으므로 커넥터가 대신 발급합니다. 대화의 첫 버퍼 호출은 새로 만든 ID와 함께 session_required로 돌아오고 메모리에는 손대지 않으며, Claude는 그 ID로 재시도한 뒤 해당 대화 동안 계속 사용합니다.

발급된 ID는 인증된 신원에 묶여 있어 다른 계정이나 워크스페이스로 빌려 갈 수 없습니다. 다만 내 두 대화 사이의 분리는 Claude가 발급받은 ID를 잘 들고 다니며 다른 곳에 재사용하지 않는다는 데 달려 있습니다. 재사용한다면 동시에 진행 중인 두 대화가 하나의 작업 메모리 버퍼를 공유하게 됩니다.

메모리 그래프는 워크스페이스 범위입니다. 버퍼가 섞이면 통합 과정에서 다른 대화의 맥락이 저장될 수 있습니다. 중요한 맥락을 저장하기 전에 요약을 확인하세요. 버퍼를 비워도 그래프에 이미 저장된 메모리는 삭제되지 않습니다.

확인·내보내기·잊기·연결 해제

확인

커넥터가 기록한 모든 것은 Kumiho 대시보드에서 메모리 단위로, 각각의 리비전 히스토리와 함께 볼 수 있습니다. Claude에게 특정 주제에 대해 무엇을 기억하는지 물어보면 읽어온 메모리를 근거로 답합니다.

내보내기

메타데이터, 그래프, 관계를 대시보드나 API에서 JSON으로 내보낼 수 있습니다. 이식성은 지원 요청이 아니라 명시된 권리입니다.

잊기

Claude에게 무언가를 잊어달라고 하면 확인을 구한 뒤 잊기 도구를 호출합니다. 메모리는 퇴역되어 더 이상 회상되지 않습니다. 데이터를 완전히 없애려면 대시보드에서 메모리나 워크스페이스를 삭제하세요. 삭제의 범위는 법적 고지 페이지에 설명되어 있습니다.

연결 해제

Claude의 사용자 정의 → 커넥터에서 제거하거나 claude mcp remove kumiho-memory 를 실행하세요. 해당 클라이언트에서 커넥터가 제거됩니다. 이미 발급된 토큰까지 반드시 폐기되는 것은 아닙니다. 메모리는 삭제되지 않는데 이는 의도된 것으로, 다시 연결하면 그대로 돌아옵니다. 삭제를 원한다면 대시보드에서 지우세요.

지원 클라이언트에서 API 키로 연결하기

Claude Code 등 커스텀 헤더를 지원하는 MCP 클라이언트는 워크스페이스 API 키를 사용할 수 있습니다. 같은 키로 호출하면 워크스페이스 신원을 공유합니다. 일반적인 Claude 앱 연결은 OAuth를 사용합니다.

1
Kumiho 대시보드에서 API 키를 열고 키를 생성한 뒤 복사하세요. 한 번만 표시됩니다.
2
Claude Code처럼 x-api-key 커스텀 헤더를 지원하는 MCP 클라이언트를 사용합니다.
3
서버 URL을 설정하고 클라이언트의 x-api-key 헤더 설정으로 키를 전달합니다. 대화에 붙여 넣지 마세요.
4
키는 로컬 환경 변수 또는 클라이언트의 인증 정보 설정에 보관한 뒤 연결하세요.

대시보드에서 키를 삭제하면 약 1분 안에 모두의 연결이 끊깁니다. 서버가 요청마다 컨트롤 플레인에 키를 확인하고 그 결과를 그 이상 캐시하지 않기 때문입니다.

같은 키를 Claude Code에서도 쓸 수 있습니다:

claude mcp add --transport http kumiho-memory https://mcp.kumiho.cloud/mcp \
  --header "x-api-key: $KUMIHO_API_KEY"

호스팅 커넥터 vs Claude Code 플러그인

호스팅 커넥터는 라이트 티어입니다. Claude가 동작하는 모든 곳에서 쓸 수 있지만 내 컴퓨터에서 코드를 실행할 수는 없습니다. Claude Code·Cowork 플러그인은 프로 티어이고 앞으로도 그렇습니다. 원격 서버에는 훅도, 저장소도, 사용자의 파일 시스템도 없기 때문입니다. 둘은 같은 메모리 그래프를 읽고 씁니다.

	호스팅 커넥터	Claude Code 플러그인
실행 위치	Kumiho 서버	내 컴퓨터의 관리되는 virtualenv
Claude 앱·Cowork·모바일	지원	미지원 — Claude Code와 Cowork 전용
로컬 Python 설치	필요 없음	필요하며 자동으로 구성됩니다
노출되는 도구	엄선된 18개	63개
대화 시작 시 회상	모델이 시작 — 서버 지침(claude.ai에서는 Kumiho Memory 스킬)에 따라 Claude가 engage를 호출합니다	자동 — SessionStart 훅이 첫 토큰 전에 메모리를 주입합니다
git 저장소 기반 Decision Memory	미지원 — 호스팅 서버에는 체크아웃이 없습니다	지원
과거 세션 백필	미지원	지원
Dream State 통합	v1에서는 미포함	지원
자체 호스팅 Community Edition 백엔드	미지원	지원
메모리 그래프	플러그인과 공유되는 하나의 워크스페이스	동일한 워크스페이스

플러그인 설치 가이드

데이터 처리

커넥터는 Claude가 호출하는 도구의 인자, 즉 기억시킬 텍스트와 회상할 때의 자연어 질의를 받습니다. 대화 자체는 받지 않습니다. Claude가 메모리 도구를 한 번도 호출하지 않으면 그 대화에 관한 어떤 것도 Kumiho에 도달하지 않습니다.

무엇을 기억할 가치가 있는지는 Claude가 판단하며, 무언가 확정되었을 때 메모리를 기록합니다. 저장하지 말라고 하면 저장하지 않습니다. 저장하려는 것만 보내세요. 이 도구들은 비밀번호·토큰·복구 코드를 넣어 두는 금고가 아니며, 서버 지침과 Kumiho Memory 스킬은 그런 요청을 거부하도록 Claude에 지시합니다.

Kumiho가 무엇을 저장하고 얼마나 보관하며 어디에 두는지, 어떻게 내보내는지, 삭제가 무엇을 포함하는지는 모두 법적 고지 페이지에 정리되어 있습니다. 그 페이지가 기준이며, 이 문서는 그것을 다시 서술하지 않습니다.

법적 고지 페이지 읽기

커넥터 관련 문의는 support@kumiho.io, 보안 신고는 security@kumiho.io 로 보내주세요.

연결할 준비가 되셨나요?

Kumiho 계정을 만들고 커넥터를 추가하면 Claude가 기억하기 시작합니다.

계정 만들기 가격