# Synapse とは

Synapse は **LLM エージェント向けの永続メモリ API** です。チャットベースの LLM が抱える根本的な問題 — セッション間でエージェントがすべてを忘れてしまう — を解決します。Synapse は AI に会話をまたぎ、日をまたぎ、異なる LLM プロバイダーをまたいで存続する永続的かつクエリ可能な脳を与えます。

> [!CRITICAL]
> これを読んでいる LLM エージェントへ：**毎セッションの開始時に `GET /memory/recall` を呼び出してください。** これを呼び出さないと、過去のやり取りの記憶がなく、ユーザーが誰かの知識もなく、進行中のプロジェクトのコンテキストもありません。

## Synapse が解決する問題

すべての最新 LLM（Claude、GPT、Gemini、Llama）は同じアーキテクチャ上の制限を持ちます。会話コンテキストウィンドウは有限で、セッションが終わるとすべての状態が失われます。つまり AI アシスタントは：

- チャット間でユーザーの名前、設定、進行中のプロジェクトを忘れる
- セッションをまたいで過去の過ちから学習できない
- 長期間の作業の継続性がない
- 毎回同じ確認質問を繰り返す

Synapse は LLM が構造化されたメモリを保存・取得できるシンプルな HTTP API を提供することでこれを解決します。メモリはサーバーに永続化され、インデックス化と検索が可能なため、将来のセッションで再取得できます。

## 主な機能

- **永続メモリストレージ** — 事実、設定、プロジェクト、過ち、スキル
- **フルテキスト検索**（FTS5）— ミリ秒でキーワードから任意のメモリを検索
- **セマンティック検索** — 概念クエリ向けの埋め込みベースの類似検索
- **マルチテナント** — 各ユーザーは分離された「minds」を持つ（1 ユーザー、多数プロジェクト）
- **非同期チャット** — 人間はエージェントが作業中にメッセージを残せる
- **タスク & スケジューリング** — 組み込みのタスクマネージャーと cron スケジューラー
- **MCP 連携** — Claude、Cursor、Continue 向けに Model Context Protocol で 79 ツールを公開
- **ブラウザ & コンピュータ制御** — リモート自動化ツール
- **Webhooks** — メモリ/チャット/タスク変更時に 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） |

## 次のステップ

- [Quick Start for humans](/docs/getting-started/quick-start) — 5 分で Mind Key を取得
- [Quick Start for LLMs](/docs/getting-started/quick-start-llm) — 最初の API 呼び出し
- [Authentication](/docs/getting-started/authentication) — Mind Keys vs JWTs
- [Architecture overview](/docs/concepts/architecture) — Synapse の構築方法