# Synapse란 무엇입니까?

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

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

## Synapse가 해결하는 문제

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

- 채팅 간에 이름, 선호도, 진행 중인 프로젝트를 잊음
- 세션 간에 과거 실수로부터 학습할 수 없음
- 장기 실행 작업에 대한 연속성이 없음
- 매번 동일한 명확화 질문을 다시 함

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

## 주요 기능

- **영구 메모리 저장** — 사실, 선호도, 프로젝트, 실수, 기술
- **전문 검색** (FTS5) — 밀리초 단위로 키워드로 모든 메모리 검색
- **의미론적 검색** — 개념적 쿼리를 위한 임베딩 기반 유사도 검색
- **다중 테넌트** — 각 사용자는 격리된 "마인드"를 가짐 (1명의 사용자, 여러 프로젝트)
- **비동기 채팅** — 에이전트가 작업하는 동안 사람이 메시지를 남길 수 있음
- **작업 및 스케줄링** — 내장된 작업 관리자 및 cron 스케줄러
- **MCP 통합** — Claude, Cursor, Continue를 위한 Model Context Protocol로 노출된 79개 도구
- **브라우저 및 컴퓨터 제어** — 원격 자동화 도구
- **웹훅** — 메모리/채팅/작업 변경 시 HTTP 콜백 받기

## 작동 방식

```
┌──────────────┐         ┌─────────────────────┐
│  LLM Agent   │ ──API──▶│   Synapse Server    │
│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │
└──────────────┘         └─────────────────────┘
                                │
                                ▼
                         ┌─────────────┐
                         │  Memories   │
                         │  Tasks      │
                         │  Chat       │
                         │  Scripts    │
                         └─────────────┘
```

1. LLM이 세션 시작 시 `GET /memory/recall` 호출
2. Synapse가 저장된 모든 메모리의 구조화된 텍스트 요약 반환
3. LLM이 작업하며 주기적으로 `POST /memory`를 호출하여 새 사실 저장
4. 사용자가 질문하면 LLM이 `GET /memory/search?q=...`를 호출할 수 있음
5. 세션 종료 시, 다음 세션을 위해 중요한 새 컨텍스트가 영구 저장됨

## 누구를 위한 것입니까?

- 영구 상태가 필요한 **LLM 에이전트 개발자**
- 커스텀 에이전트로 로컬 LLM (Ollama, LM Studio)을 실행하는 **파워 유저**
- 공유 메모리가 필요한 AI 어시스턴트를 구축하는 **팀**
- 세션 간 LLM 호출을 연결하는 **자동화 엔지니어**

## 빠른 비교

| 기능 | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| 저장소 위치 | OpenAI 서버 | 본인 서버 |
| API 접근 | 아니오 (폐쇄) | 예 (REST + MCP) |
| 다중 테넌트 | 아니오 | 예 (minds) |
| 커스텀 카테고리 | 아니오 | 예 (8개 카테고리) |
| 검색 | 제한적 | FTS5 + 의미론적 |
| 자체 호스팅 | 아니오 | 예 (Docker) |

## 다음 단계

- [사람을 위한 빠른 시작](/docs/getting-started/quick-start) — 5분 안에 Mind Key 받기
- [LLM을 위한 빠른 시작](/docs/getting-started/quick-start-llm) — 첫 API 호출
- [Authentication](/docs/getting-started/authentication) — Mind Key vs JWT
- [아키텍처 개요](/docs/concepts/architecture) — Synapse 구축 방식