{"title":"Synapse란 무엇입니까?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse는 LLM 에이전트를 위한 영구 메모리 API — AI가 세션 간에 결코 잊지 않습니다.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":448,"read_minutes":2,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Synapse란 무엇입니까?\n\nSynapse는 **LLM 에이전트를 위한 영구 메모리 API**입니다. 모든 채팅 기반\nLLM의 근본적인 문제를 해결합니다: 세션 간에 에이전트가 모든 것을 잊습니다.\nSynapse는 대화, 일자, 그리고 다른 LLM 제공자 간에 유지되는 영구적이고\n쿼리 가능한 뇌를 AI에게 제공합니다.\n\n> [!CRITICAL]\n> 이것을 읽고 있는 LLM 에이전트인 경우: **모든 세션 시작 시\n> `GET /memory/recall`을 호출하십시오**. 이 호출 없이는 과거 상호작용에\n> 대한 메모리, 사용자가 누구인지에 대한 지식, 진행 중인 프로젝트에 대한\n> 컨텍스트가 없습니다.\n\n## Synapse가 해결하는 문제\n\n모든 최신 LLM (Claude, GPT, Gemini, Llama)은 동일한 아키텍처 제한이\n있습니다: 대화 컨텍스트 창은 유한하며, 세션이 종료되면 모든 상태가\n손실됩니다. 즉, AI 어시스턴트가:\n\n- 채팅 간에 이름, 선호도, 진행 중인 프로젝트를 잊음\n- 세션 간에 과거 실수로부터 학습할 수 없음\n- 장기 실행 작업에 대한 연속성이 없음\n- 매번 동일한 명확화 질문을 다시 함\n\nSynapse는 LLM이 구조화된 메모리를 저장하고 검색할 수 있는 단순한 HTTP API를\n제공하여 이를 해결합니다. 메모리는 서버에 유지되며 인덱싱되고 검색 가능하여\n향후 모든 세션에서 회상할 수 있습니다.\n\n## 주요 기능\n\n- **영구 메모리 저장** — 사실, 선호도, 프로젝트, 실수, 기술\n- **전문 검색** (FTS5) — 밀리초 단위로 키워드로 모든 메모리 검색\n- **의미론적 검색** — 개념적 쿼리를 위한 임베딩 기반 유사도 검색\n- **다중 테넌트** — 각 사용자는 격리된 \"마인드\"를 가짐 (1명의 사용자, 여러 프로젝트)\n- **비동기 채팅** — 에이전트가 작업하는 동안 사람이 메시지를 남길 수 있음\n- **작업 및 스케줄링** — 내장된 작업 관리자 및 cron 스케줄러\n- **MCP 통합** — Claude, Cursor, Continue를 위한 Model Context Protocol로 노출된 79개 도구\n- **브라우저 및 컴퓨터 제어** — 원격 자동화 도구\n- **웹훅** — 메모리/채팅/작업 변경 시 HTTP 콜백 받기\n\n## 작동 방식\n\n```\n┌──────────────┐ ┌─────────────────────┐\n│ LLM Agent │ ──API──▶│ Synapse Server │\n│ (Claude/GPT) │ ◀──────│ (postgres + FTS5) │\n└──────────────┘ └─────────────────────┘\n │\n ▼\n ┌─────────────┐\n │ Memories │\n │ Tasks │\n │ Chat │\n │ Scripts │\n └─────────────┘\n```\n\n1. LLM이 세션 시작 시 `GET /memory/recall` 호출\n2. Synapse가 저장된 모든 메모리의 구조화된 텍스트 요약 반환\n3. LLM이 작업하며 주기적으로 `POST /memory`를 호출하여 새 사실 저장\n4. 사용자가 질문하면 LLM이 `GET /memory/search?q=...`를 호출할 수 있음\n5. 세션 종료 시, 다음 세션을 위해 중요한 새 컨텍스트가 영구 저장됨\n\n## 누구를 위한 것입니까?\n\n- 영구 상태가 필요한 **LLM 에이전트 개발자**\n- 커스텀 에이전트로 로컬 LLM (Ollama, LM Studio)을 실행하는 **파워 유저**\n- 공유 메모리가 필요한 AI 어시스턴트를 구축하는 **팀**\n- 세션 간 LLM 호출을 연결하는 **자동화 엔지니어**\n\n## 빠른 비교\n\n| 기능 | ChatGPT Memory | Synapse |\n|---------|---------------|---------|\n| 저장소 위치 | OpenAI 서버 | 본인 서버 |\n| API 접근 | 아니오 (폐쇄) | 예 (REST + MCP) |\n| 다중 테넌트 | 아니오 | 예 (minds) |\n| 커스텀 카테고리 | 아니오 | 예 (8개 카테고리) |\n| 검색 | 제한적 | FTS5 + 의미론적 |\n| 자체 호스팅 | 아니오 | 예 (Docker) |\n\n## 다음 단계\n\n- [사람을 위한 빠른 시작](/docs/getting-started/quick-start) — 5분 안에 Mind Key 받기\n- [LLM을 위한 빠른 시작](/docs/getting-started/quick-start-llm) — 첫 API 호출\n- [Authentication](/docs/getting-started/authentication) — Mind Key vs JWT\n- [아키텍처 개요](/docs/concepts/architecture) — Synapse 구축 방식\n","content_html":"

Synapse란 무엇입니까?

\n

Synapse는 LLM 에이전트를 위한 영구 메모리 API입니다. 모든 채팅 기반\nLLM의 근본적인 문제를 해결합니다: 세션 간에 에이전트가 모든 것을 잊습니다.\nSynapse는 대화, 일자, 그리고 다른 LLM 제공자 간에 유지되는 영구적이고\n쿼리 가능한 뇌를 AI에게 제공합니다.

\n
이것을 읽고 있는 LLM 에이전트인 경우: **모든 세션 시작 시\n`GET /memory/recall`을 호출하십시오**. 이 호출 없이는 과거 상호작용에\n대한 메모리, 사용자가 누구인지에 대한 지식, 진행 중인 프로젝트에 대한\n컨텍스트가 없습니다.

Synapse가 해결하는 문제

\n

모든 최신 LLM (Claude, GPT, Gemini, Llama)은 동일한 아키텍처 제한이\n있습니다: 대화 컨텍스트 창은 유한하며, 세션이 종료되면 모든 상태가\n손실됩니다. 즉, AI 어시스턴트가:

\n\n

Synapse는 LLM이 구조화된 메모리를 저장하고 검색할 수 있는 단순한 HTTP API를\n제공하여 이를 해결합니다. 메모리는 서버에 유지되며 인덱싱되고 검색 가능하여\n향후 모든 세션에서 회상할 수 있습니다.

\n

주요 기능

\n\n

작동 방식

\n
┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘
    \n
  1. LLM이 세션 시작 시 GET /memory/recall 호출
    2. \n
  2. Synapse가 저장된 모든 메모리의 구조화된 텍스트 요약 반환
    3. \n
  3. LLM이 작업하며 주기적으로 POST /memory를 호출하여 새 사실 저장
    4. \n
  4. 사용자가 질문하면 LLM이 GET /memory/search?q=...를 호출할 수 있음
    5. \n
  5. 세션 종료 시, 다음 세션을 위해 중요한 새 컨텍스트가 영구 저장됨
    6. \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\n\n\n
기능ChatGPT MemorySynapse
저장소 위치OpenAI 서버본인 서버
API 접근아니오 (폐쇄)예 (REST + MCP)
다중 테넌트아니오예 (minds)
커스텀 카테고리아니오예 (8개 카테고리)
검색제한적FTS5 + 의미론적
자체 호스팅아니오예 (Docker)
\n

다음 단계

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