# クイックスタート（人間向け）

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

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

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

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

レスポンス：

```json
{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
```

> [!TIP]
> JWT を安全な場所に保存してください — mind の作成に必要です。JWT は 7 日後に期限切れになります。同じエンドポイントで再ログインして更新してください。

## ステップ 2：最初の mind の作成

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

```bash
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"
  }'
```

レスポンス：

```json
{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
```

> [!CRITICAL]
> **`mind_key` をすぐに保存してください。** 一度しか表示されず、後から取得できません。失くした場合は新しい mind を作成する必要があります。

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

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

```bash
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"
  }'
```

レスポンス：

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

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

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

```bash
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：メモリの検索

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

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

## ステップ 6：LLM の接続

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

- [Claude Desktop setup](/docs/mcp/claude-desktop) — 2 分の設定
- [Claude Code setup](/docs/mcp/claude-code) — ターミナル連携
- [Cursor setup](/docs/mcp/cursor) — IDE 連携

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

## メモリのカテゴリ

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

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

## 優先度レベル

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

## 次のステップ

- [Authentication deep-dive](/docs/getting-started/authentication)
- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)
- [Memory API reference](/docs/api/memory)
- [MCP integration](/docs/mcp/what-is-mcp)