{"title":"빠른 시작 (사람)","slug":"quick-start","category":"getting-started","summary":"계정 가입, 첫 마인드 생성, 메모리 저장 — 모두 5분 안에.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":315,"read_minutes":2,"lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# 빠른 시작 (사람)\n\n이 가이드는 Synapse 계정, 첫 Mind Key, 첫 메모리 저장까지 안내합니다.\n총 소요 시간: 약 5분.\n\n## 1단계: 계정 가입\n\nSynapse API를 열고 계정을 생성하십시오:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\n응답:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> JWT를 안전한 곳에 저장하십시오 — 마인드 생성에 필요합니다. JWT는\n> 7일 후 만료되며, 동일한 엔드포인트로 다시 로그인하여 갱신할 수 있습니다.\n\n## 2단계: 첫 마인드 생성\n\n\"마인드\"는 격리된 메모리 범위입니다. 대부분의 사용자는 하나의 마인드로\n시작하지만, 여러 개를 가질 수 있습니다 (예: \"work\", \"personal\", \"project-x\").\n각 마인드는 고유한 Mind Key를 가집니다.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\n응답:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **`mind_key`를 즉시 저장하십시오.** 한 번만 표시되며 나중에 검색할 수\n> 없습니다. 분실하면 새 마인드를 생성해야 합니다.\n\n## 3단계: 첫 메모리 저장\n\n이제 Mind Key를 사용하여 메모리를 저장하십시오:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\n응답:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## 4단계: 모든 메모리 회상\n\n저장한 모든 것을 검색하려면:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n응답 (일반 텍스트, LLM 사용에 최적화):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## 5단계: 메모리 검색\n\n키워드로 특정 메모리 찾기:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## 6단계: LLM 연결\n\nLLM에게 Synapse 접근 권한을 부여하는 가장 쉬운 방법은 MCP를 통하는 것입니다:\n\n- [Claude Desktop 설정](/docs/mcp/claude-desktop) — 2분 구성\n- [Claude Code 설정](/docs/mcp/claude-code) — 터미널 통합\n- [Cursor 설정](/docs/mcp/cursor) — IDE 통합\n\n설정 후, LLM은 모든 세션 시작 시 자동으로 `memory_recall`을 호출하고\n`memory_store`를 통해 새 사실을 영구 저장합니다.\n\n## 메모리 카테고리\n\nSynapse는 8개 카테고리를 지원합니다 — 가장 구체적인 것을 선택하십시오:\n\n| 카테고리 | 사용 사례 |\n|----------|----------|\n| `identity` | 사용자 이름, 역할, 연락처 정보 |\n| `preference` | 좋아함, 싫어함, 작업 스타일 |\n| `fact` | 검증 가능한 사실 (프로젝트 세부 정보, 날짜) |\n| `project` | 프로젝트 상태, 마일스톤, 할 일 |\n| `skill` | 사용자가 잘하는 것 |\n| `mistake` | 과거 오류 — 반복 방지 |\n| `context` | 세션 관련 컨텍스트 |\n| `note` | 기타 노트 |\n\n## 우선순위 수준\n\n- `low` — 알면 좋음\n- `normal` — 기본값\n- `high` — 중요\n- `critical` — 절대 잊으면 안 됨 (사용자 정체성, 법적 정보)\n\n## 다음 단계\n\n- [인증 심층 가이드](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Memory API 참조](/docs/api/memory)\n- [MCP 통합](/docs/mcp/what-is-mcp)\n","content_html":"

빠른 시작 (사람)

\n

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

\n

1단계: 계정 가입

\n

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

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

응답:

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

2단계: 첫 마인드 생성

\n

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

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

응답:

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

3단계: 첫 메모리 저장

\n

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

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

응답:

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

4단계: 모든 메모리 회상

\n

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

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

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

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

5단계: 메모리 검색

\n

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

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

6단계: LLM 연결

\n

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

\n\n

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

\n

메모리 카테고리

\n

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

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

우선순위 수준

\n\n

다음 단계

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}