Skip to main content

クイックスタート(人間向け)

アカウント登録、最初の mind の作成、メモリの保存まで — 5 分で完了。


クイックスタート(人間向け)

本ガイドでは Synapse アカウントの取得、最初の Mind Key の作成、最初のメモリの保存までを案内します。所要時間:約 5 分。

ステップ 1:アカウントの登録

Synapse API を開き、アカウントを作成します。

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

レスポンス:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
JWT を安全な場所に保存してください — mind の作成に必要です。JWT は 7 日後に期限切れになります。同じエンドポイントで再ログインして更新してください。

ステップ 2:最初の mind の作成

「mind」は分離されたメモリスコープです。ほとんどのユーザーは 1 つの mind から始めますが、複数持つこともできます(例:「work」「personal」「project-x」)。各 mind は独自のユニークな Mind Key を持ちます。

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

レスポンス:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
**`mind_key` をすぐに保存してください。** 一度しか表示されず、後から取得できません。失くした場合は新しい mind を作成する必要があります。

ステップ 3:最初のメモリの保存

Mind Key を使用してメモリを保存します。

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

レスポンス:

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

ステップ 4:全メモリの再取得

保存したすべてを取得するには:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

レスポンス(プレーンテキスト、LLM 消費向けに最適化):

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

ステップ 5:メモリの検索

キーワードで特定のメモリを見つけます。

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"

ステップ 6:LLM の接続

LLM に Synapse へのアクセスを与える最も簡単な方法は MCP 経由です。

設定後、LLM は毎セッションの開始時に自動的に memory_recall を呼び出し、memory_store で新しい事実を永続化します。

メモリのカテゴリ

Synapse は 8 カテゴリをサポート — 最も具体的なものを選んでください。

カテゴリ ユースケース
identity ユーザー名、役割、連絡先情報
preference 好き嫌い、作業スタイル
fact 検証可能な事実(プロジェクト詳細、日付)
project プロジェクトのステータス、マイルストーン、ToDo
skill ユーザーが得意なこと
mistake 過去のエラー — 繰り返しを避ける
context セッション関連のコンテキスト
note その他のメモ

優先度レベル

  • low — 知っておくとよい
  • normal — デフォルト
  • high — 重要
  • critical — 絶対に忘れてはならない(ユーザー ID、法的情報)

次のステップ