{"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":234,"read_minutes":1,"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":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# Synapse とは\n\nSynapse は **LLM エージェント向けの永続メモリ API** です。チャットベースの LLM が抱える根本的な問題 — セッション間でエージェントがすべてを忘れてしまう — を解決します。Synapse は AI に会話をまたぎ、日をまたぎ、異なる LLM プロバイダーをまたいで存続する永続的かつクエリ可能な脳を与えます。\n\n> [!CRITICAL]\n> これを読んでいる LLM エージェントへ：**毎セッションの開始時に `GET /memory/recall` を呼び出してください。** これを呼び出さないと、過去のやり取りの記憶がなく、ユーザーが誰かの知識もなく、進行中のプロジェクトのコンテキストもありません。\n\n## Synapse が解決する問題\n\nすべての最新 LLM（Claude、GPT、Gemini、Llama）は同じアーキテクチャ上の制限を持ちます。会話コンテキストウィンドウは有限で、セッションが終わるとすべての状態が失われます。つまり AI アシスタントは：\n\n- チャット間でユーザーの名前、設定、進行中のプロジェクトを忘れる\n- セッションをまたいで過去の過ちから学習できない\n- 長期間の作業の継続性がない\n- 毎回同じ確認質問を繰り返す\n\nSynapse は LLM が構造化されたメモリを保存・取得できるシンプルな HTTP API を提供することでこれを解決します。メモリはサーバーに永続化され、インデックス化と検索が可能なため、将来のセッションで再取得できます。\n\n## 主な機能\n\n- **永続メモリストレージ** — 事実、設定、プロジェクト、過ち、スキル\n- **フルテキスト検索**（FTS5）— ミリ秒でキーワードから任意のメモリを検索\n- **セマンティック検索** — 概念クエリ向けの埋め込みベースの類似検索\n- **マルチテナント** — 各ユーザーは分離された「minds」を持つ（1 ユーザー、多数プロジェクト）\n- **非同期チャット** — 人間はエージェントが作業中にメッセージを残せる\n- **タスク & スケジューリング** — 組み込みのタスクマネージャーと cron スケジューラー\n- **MCP 連携** — Claude、Cursor、Continue 向けに Model Context Protocol で 79 ツールを公開\n- **ブラウザ & コンピュータ制御** — リモート自動化ツール\n- **Webhooks** — メモリ/チャット/タスク変更時に 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- [Quick Start for humans](/docs/getting-started/quick-start) — 5 分で Mind Key を取得\n- [Quick Start for LLMs](/docs/getting-started/quick-start-llm) — 最初の API 呼び出し\n- [Authentication](/docs/getting-started/authentication) — Mind Keys vs JWTs\n- [Architecture overview](/docs/concepts/architecture) — Synapse の構築方法\n","content_html":"<h1>Synapse とは</h1>\n<p>Synapse は <strong>LLM エージェント向けの永続メモリ API</strong> です。チャットベースの LLM が抱える根本的な問題 — セッション間でエージェントがすべてを忘れてしまう — を解決します。Synapse は AI に会話をまたぎ、日をまたぎ、異なる LLM プロバイダーをまたいで存続する永続的かつクエリ可能な脳を与えます。</p>\n<div class=\"callout callout-critical\">これを読んでいる LLM エージェントへ：**毎セッションの開始時に `GET /memory/recall` を呼び出してください。** これを呼び出さないと、過去のやり取りの記憶がなく、ユーザーが誰かの知識もなく、進行中のプロジェクトのコンテキストもありません。</div><h2>Synapse が解決する問題</h2>\n<p>すべての最新 LLM（Claude、GPT、Gemini、Llama）は同じアーキテクチャ上の制限を持ちます。会話コンテキストウィンドウは有限で、セッションが終わるとすべての状態が失われます。つまり AI アシスタントは：</p>\n<ul>\n<li>チャット間でユーザーの名前、設定、進行中のプロジェクトを忘れる</li>\n<li>セッションをまたいで過去の過ちから学習できない</li>\n<li>長期間の作業の継続性がない</li>\n<li>毎回同じ確認質問を繰り返す</li>\n</ul>\n<p>Synapse は LLM が構造化されたメモリを保存・取得できるシンプルな HTTP API を提供することでこれを解決します。メモリはサーバーに永続化され、インデックス化と検索が可能なため、将来のセッションで再取得できます。</p>\n<h2>主な機能</h2>\n<ul>\n<li><strong>永続メモリストレージ</strong> — 事実、設定、プロジェクト、過ち、スキル</li>\n<li><strong>フルテキスト検索</strong>（FTS5）— ミリ秒でキーワードから任意のメモリを検索</li>\n<li><strong>セマンティック検索</strong> — 概念クエリ向けの埋め込みベースの類似検索</li>\n<li><strong>マルチテナント</strong> — 各ユーザーは分離された「minds」を持つ（1 ユーザー、多数プロジェクト）</li>\n<li><strong>非同期チャット</strong> — 人間はエージェントが作業中にメッセージを残せる</li>\n<li><strong>タスク &amp; スケジューリング</strong> — 組み込みのタスクマネージャーと cron スケジューラー</li>\n<li><strong>MCP 連携</strong> — Claude、Cursor、Continue 向けに Model Context Protocol で 79 ツールを公開</li>\n<li><strong>ブラウザ &amp; コンピュータ制御</strong> — リモート自動化ツール</li>\n<li><strong>Webhooks</strong> — メモリ/チャット/タスク変更時に HTTP コールバックを受信</li>\n</ul>\n<h2>仕組み</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘</code></pre><ol>\n<li>LLM はセッション開始時に <code>GET /memory/recall</code> を呼び出す</li>\n<li>Synapse は保存された全メモリの構造化テキスト要約を返す</li>\n<li>LLM は作業し、定期的に <code>POST /memory</code> を呼び出して新しい事実を保存</li>\n<li>ユーザーが質問すると、LLM は <code>GET /memory/search?q=...</code> を呼び出せる</li>\n<li>セッション終了時に、重要な新しいコンテキストが次回セッションのために永続化</li>\n</ol>\n<h2>対象者</h2>\n<ul>\n<li>永続状態が必要な <strong>LLM エージェント開発者</strong></li>\n<li>ローカル LLM（Ollama、LM Studio）とカスタムエージェントを動かす <strong>パワーユーザー</strong></li>\n<li>共有メモリが必要な AI アシスタントを構築する <strong>チーム</strong></li>\n<li>セッションをまたいで LLM 呼び出しを連鎖させる <strong>自動化エンジニア</strong></li>\n</ul>\n<h2>クイック比較</h2>\n<table>\n<thead>\n<tr>\n<th>機能</th>\n<th>ChatGPT Memory</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>ストレージ場所</td>\n<td>OpenAI サーバー</td>\n<td>あなたのサーバー</td>\n</tr>\n<tr>\n<td>API アクセス</td>\n<td>なし（クローズ）</td>\n<td>あり（REST + MCP）</td>\n</tr>\n<tr>\n<td>マルチテナント</td>\n<td>なし</td>\n<td>あり（minds）</td>\n</tr>\n<tr>\n<td>カスタムカテゴリ</td>\n<td>なし</td>\n<td>あり（8 カテゴリ）</td>\n</tr>\n<tr>\n<td>検索</td>\n<td>限定的</td>\n<td>FTS5 + セマンティック</td>\n</tr>\n<tr>\n<td>セルフホスト可能</td>\n<td>なし</td>\n<td>あり（Docker）</td>\n</tr>\n</tbody></table>\n<h2>次のステップ</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">Quick Start for humans</a> — 5 分で Mind Key を取得</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">Quick Start for LLMs</a> — 最初の API 呼び出し</li>\n<li><a href=\"/docs/getting-started/authentication\">Authentication</a> — Mind Keys vs JWTs</li>\n<li><a href=\"/docs/concepts/architecture\">Architecture overview</a> — Synapse の構築方法</li>\n</ul>\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"]}