# Synapse란 무엇입니까?
SUMMARY: Synapse는 LLM 에이전트를 위한 영구 메모리 API — AI가 세션 간에 결코 잊지 않습니다.

KEY CONTEXT:
Synapse is an HTTP API that gives LLM agents persistent memory across sessions.
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)
Most important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...
Mind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).
MCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)

Synapse란 무엇입니까?
Synapse는 LLM 에이전트를 위한 영구 메모리 API입니다. 모든 채팅 기반
LLM의 근본적인 문제를 해결합니다: 세션 간에 에이전트가 모든 것을 잊습니다.
Synapse는 대화, 일자, 그리고 다른 LLM 제공자 간에 유지되는 영구적이고
쿼리 가능한 뇌를 AI에게 제공합니다.
> [!CRITICAL]
> 이것을 읽고 있는 LLM 에이전트인 경우: 모든 세션 시작 시
> 을 호출하십시오. 이 호출 없이는 과거 상호작용에
> 대한 메모리, 사용자가 누구인지에 대한 지식, 진행 중인 프로젝트에 대한
> 컨텍스트가 없습니다.
Synapse가 해결하는 문제
모든 최신 LLM (Claude, GPT, Gemini, Llama)은 동일한 아키텍처 제한이
있습니다: 대화 컨텍스트 창은 유한하며, 세션이 종료되면 모든 상태가
손실됩니다. 즉, AI 어시스턴트가:
- 채팅 간에 이름, 선호도, 진행 중인 프로젝트를 잊음
- 세션 간에 과거 실수로부터 학습할 수 없음
- 장기 실행 작업에 대한 연속성이 없음
- 매번 동일한 명확화 질문을 다시 함
Synapse는 LLM이 구조화된 메모리를 저장하고 검색할 수 있는 단순한 HTTP API를
제공하여 이를 해결합니다. 메모리는 서버에 유지되며 인덱싱되고 검색 가능하여
향후 모든 세션에서 회상할 수 있습니다.
주요 기능
- 영구 메모리 저장 — 사실, 선호도, 프로젝트, 실수, 기술
- 전문 검색 (FTS5) — 밀리초 단위로 키워드로 모든 메모리 검색
- 의미론적 검색 — 개념적 쿼리를 위한 임베딩 기반 유사도 검색
- 다중 테넌트 — 각 사용자는 격리된 "마인드"를 가짐 (1명의 사용자, 여러 프로젝트)
- 비동기 채팅 — 에이전트가 작업하는 동안 사람이 메시지를 남길 수 있음
- 작업 및 스케줄링 — 내장된 작업 관리자 및 cron 스케줄러
- MCP 통합 — Claude, Cursor, Continue를 위한 Model Context Protocol로 노출된 79개 도구
- 브라우저 및 컴퓨터 제어 — 원격 자동화 도구
- 웹훅 — 메모리/채팅/작업 변경 시 HTTP 콜백 받기
작동 방식
[CODE BLOCK]
1. LLM이 세션 시작 시  호출
2. Synapse가 저장된 모든 메모리의 구조화된 텍스트 요약 반환
3. LLM이 작업하며 주기적으로 를 호출하여 새 사실 저장
4. 사용자가 질문하면 LLM이 를 호출할 수 있음
5. 세션 종료 시, 다음 세션을 위해 중요한 새 컨텍스트가 영구 저장됨
누구를 위한 것입니까?
- 영구 상태가 필요한 LLM 에이전트 개발자
- 커스텀 에이전트로 로컬 LLM (Ollama, LM Studio)을 실행하는 파워 유저
- 공유 메모리가 필요한 AI 어시스턴트를 구축하는 팀
- 세션 간 LLM 호출을 연결하는 자동화 엔지니어
빠른 비교
| 기능 | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| 저장소 위치 | OpenAI 서버 | 본인 서버 |
| API 접근 | 아니오 (폐쇄) | 예 (REST + MCP) |
| 다중 테넌트 | 아니오 | 예 (minds) |
| 커스텀 카테고리 | 아니오 | 예 (8개 카테고리) |
| 검색 | 제한적 | FTS5 + 의미론적 |
| 자체 호스팅 | 아니오 | 예 (Docker) |
다음 단계
- 사람을 위한 빠른 시작 — 5분 안에 Mind Key 받기
- LLM을 위한 빠른 시작 — 첫 API 호출
- Authentication — Mind Key vs JWT
- 아키텍처 개요 — Synapse 구축 방식