문서

Kandela를 시작하는 데 필요한 모든 것.

🎬 Kandela 데모

☁️ 클라우드 (Hosted)

가장 빠른 시작 방법. 서버는 저희가 관리하고, 클라이언트만 설치하세요.

베타 가입 후 API 키를 받고, 명령 한 줄이면 끝. 2분이면 됩니다.

단계별 가이드 →

설치 항목: MCP 서버 등록, 8개 라이프사이클 훅 (자동 회상, 자동 저장, Prompt Guard 등), 16개 이상의 슬래시 명령.

호환성: 현재 Claude Code를 지원합니다. 향후 더 많은 AI 코딩 도구를 지원할 예정입니다.

🏠 셀프호스팅

자체 서버에서 Kandela를 실행하세요. 데이터를 완전히 제어할 수 있습니다.

몇 가지 간단한 명령어로 자체 인프라에서 Kandela를 실행할 수 있습니다.

요구사항: Docker 20.10+, 4GB+ RAM
설치: 몇 단계 명령어로 설치, 실행, 연결
데이터는 자체 서버에 보관 — 외부 의존 없음

📦 상세 가이드 & 소스 코드: github.com/deep-on/kandela-selfhost

🔧 기술 개요

기억 검색, 세션 연속성, 의사결정 보호에 관한 복수의 특허 출원 기술을 기반으로 합니다.

하이브리드 검색

시맨틱 (ChromaDB) + BM25 키워드 검색을 RRF로 결합. 50개 이상 언어 지원.

Importance 엔진

25개 규칙으로 기억을 1~10점 자동 평가. 인프라 결정은 가중치 상향, 사소한 사실은 시간에 따라 감쇠 (ACT-R 영감 받은 지수감쇠).

Prompt Guard

AI가 과거 결정을 번복하려 할 때 감지. 원래 이유를 먼저 보여줍니다.

Circuit Breaker

동일 실패 3회 반복 시 실행을 중단하고 관련 gotcha를 메모리에서 검색합니다.

Lazy Retrieval

세션 시작 시 Brief 모드 (~260 토큰). 전체 컨텍스트는 context_search로 온디맨드 로드.

멀티 프로젝트

프로젝트별 독립 메모리 + 크로스 프로젝트 발견. 글로벌 메모리는 모든 프로젝트에서 공유.

A/B 벤치마크 결과

90 세션, 2개 시나리오 (HIPAA 파이프라인 + Slack 인프라 봇), Claude Sonnet 4.6:

-79.5pp 의사결정 실수

-37% 코드 낭비

-21% 시간 낭비

🔌 호환성

Kandela는 모든 MCP 호환 클라이언트에서 동작합니다 — Claude, GPT, Gemini 어떤 LLM이든. 모델을 바꿔도 기억은 그대로. 하나의 기억 저장소로 모든 도구를 연결합니다.

기능	Claude Code CLI / Desktop App	Claude Desktop 채팅 앱	Cursor / VS Code 및 기타 MCP 클라이언트
MCP 도구 13개 (store, search, recall...)	✅	✅	✅
수동 호출 (도구 직접 사용)	✅	✅	✅
텔레그램 봇	✅	✅	✅
자동 회상 (세션 시작)	✅	—	—
자동 저장 (세션 종료)	✅	—	—
Prompt Guard	✅	—	—
Circuit Breaker	✅	—	—
슬래시 명령 (/kd-*)	✅	—	—
CLAUDE.md 가이드	✅	—	—
원클릭 설치	✅	수동	수동

Claude Code CLI / Desktop App — 전체 경험. 원라인 설치 후 모든 기능 자동 동작.

Claude Desktop / Cursor / 기타 MCP 클라이언트 — MCP 도구 + 수동 호출 + 텔레그램 봇. 아래 가이드로 수동 설정.

설정: Claude Desktop

~/.claude.json에 추가:

{
  "mcpServers": {
    "kandela": {
      "type": "http",
      "url": "https://api.kandela.ai/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_API_KEY"
      }
    }
  }
}

설정: Cursor / VS Code (Claude Extension)

프로젝트 루트의 .mcp.json에 추가. 저장 후 에디터를 재시작하세요.

{
  "mcpServers": {
    "kandela": {
      "type": "http",
      "url": "https://api.kandela.ai/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_API_KEY"
      }
    }
  }
}

설정: 기타 MCP 클라이언트

MCP 호환 클라이언트라면 HTTP transport로 연결 가능:

URL: https://api.kandela.ai/mcp
인증: Authorization: Bearer mcp_YOUR_API_KEY

mcp_YOUR_API_KEY를 대시보드 → Account에서 발급한 API 키로 교체하세요.