Skip to main content

빠른 시작 (사람)

계정 가입, 첫 마인드 생성, 메모리 저장 — 모두 5분 안에.


빠른 시작 (사람)

이 가이드는 Synapse 계정, 첫 Mind Key, 첫 메모리 저장까지 안내합니다. 총 소요 시간: 약 5분.

1단계: 계정 가입

Synapse API를 열고 계정을 생성하십시오:

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

응답:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
JWT를 안전한 곳에 저장하십시오 — 마인드 생성에 필요합니다. JWT는 7일 후 만료되며, 동일한 엔드포인트로 다시 로그인하여 갱신할 수 있습니다.

2단계: 첫 마인드 생성

"마인드"는 격리된 메모리 범위입니다. 대부분의 사용자는 하나의 마인드로 시작하지만, 여러 개를 가질 수 있습니다 (예: "work", "personal", "project-x"). 각 마인드는 고유한 Mind Key를 가집니다.

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

응답:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
**`mind_key`를 즉시 저장하십시오.** 한 번만 표시되며 나중에 검색할 수 없습니다. 분실하면 새 마인드를 생성해야 합니다.

3단계: 첫 메모리 저장

이제 Mind Key를 사용하여 메모리를 저장하십시오:

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

응답:

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

4단계: 모든 메모리 회상

저장한 모든 것을 검색하려면:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

응답 (일반 텍스트, LLM 사용에 최적화):

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

5단계: 메모리 검색

키워드로 특정 메모리 찾기:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"

6단계: LLM 연결

LLM에게 Synapse 접근 권한을 부여하는 가장 쉬운 방법은 MCP를 통하는 것입니다:

설정 후, LLM은 모든 세션 시작 시 자동으로 memory_recall을 호출하고 memory_store를 통해 새 사실을 영구 저장합니다.

메모리 카테고리

Synapse는 8개 카테고리를 지원합니다 — 가장 구체적인 것을 선택하십시오:

카테고리 사용 사례
identity 사용자 이름, 역할, 연락처 정보
preference 좋아함, 싫어함, 작업 스타일
fact 검증 가능한 사실 (프로젝트 세부 정보, 날짜)
project 프로젝트 상태, 마일스톤, 할 일
skill 사용자가 잘하는 것
mistake 과거 오류 — 반복 방지
context 세션 관련 컨텍스트
note 기타 노트

우선순위 수준

  • low — 알면 좋음
  • normal — 기본값
  • high — 중요
  • critical — 절대 잊으면 안 됨 (사용자 정체성, 법적 정보)

다음 단계