{"title":"クイックスタート（人間向け）","slug":"quick-start","category":"getting-started","summary":"アカウント登録、最初の mind の作成、メモリの保存まで — 5 分で完了。","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":189,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# クイックスタート（人間向け）\n\n本ガイドでは Synapse アカウントの取得、最初の Mind Key の作成、最初のメモリの保存までを案内します。所要時間：約 5 分。\n\n## ステップ 1：アカウントの登録\n\nSynapse API を開き、アカウントを作成します。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nレスポンス：\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> JWT を安全な場所に保存してください — mind の作成に必要です。JWT は 7 日後に期限切れになります。同じエンドポイントで再ログインして更新してください。\n\n## ステップ 2：最初の mind の作成\n\n「mind」は分離されたメモリスコープです。ほとんどのユーザーは 1 つの mind から始めますが、複数持つこともできます（例：「work」「personal」「project-x」）。各 mind は独自のユニークな Mind Key を持ちます。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nレスポンス：\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **`mind_key` をすぐに保存してください。** 一度しか表示されず、後から取得できません。失くした場合は新しい mind を作成する必要があります。\n\n## ステップ 3：最初のメモリの保存\n\nMind Key を使用してメモリを保存します。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nレスポンス：\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## ステップ 4：全メモリの再取得\n\n保存したすべてを取得するには：\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nレスポンス（プレーンテキスト、LLM 消費向けに最適化）：\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## ステップ 5：メモリの検索\n\nキーワードで特定のメモリを見つけます。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## ステップ 6：LLM の接続\n\nLLM に Synapse へのアクセスを与える最も簡単な方法は MCP 経由です。\n\n- [Claude Desktop setup](/docs/mcp/claude-desktop) — 2 分の設定\n- [Claude Code setup](/docs/mcp/claude-code) — ターミナル連携\n- [Cursor setup](/docs/mcp/cursor) — IDE 連携\n\n設定後、LLM は毎セッションの開始時に自動的に `memory_recall` を呼び出し、`memory_store` で新しい事実を永続化します。\n\n## メモリのカテゴリ\n\nSynapse は 8 カテゴリをサポート — 最も具体的なものを選んでください。\n\n| カテゴリ | ユースケース |\n|----------|----------|\n| `identity` | ユーザー名、役割、連絡先情報 |\n| `preference` | 好き嫌い、作業スタイル |\n| `fact` | 検証可能な事実（プロジェクト詳細、日付） |\n| `project` | プロジェクトのステータス、マイルストーン、ToDo |\n| `skill` | ユーザーが得意なこと |\n| `mistake` | 過去のエラー — 繰り返しを避ける |\n| `context` | セッション関連のコンテキスト |\n| `note` | その他のメモ |\n\n## 優先度レベル\n\n- `low` — 知っておくとよい\n- `normal` — デフォルト\n- `high` — 重要\n- `critical` — 絶対に忘れてはならない（ユーザー ID、法的情報）\n\n## 次のステップ\n\n- [Authentication deep-dive](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Memory API reference](/docs/api/memory)\n- [MCP integration](/docs/mcp/what-is-mcp)\n","content_html":"

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

\n

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

\n

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

\n

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

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

レスポンス：

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

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

\n

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

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

レスポンス：

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

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

\n

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

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

レスポンス：

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

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

\n

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

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

レスポンス（プレーンテキスト、LLM 消費向けに最適化）：

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

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

\n

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

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

ステップ 6：LLM の接続

\n

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

\n\n

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

\n

メモリのカテゴリ

\n

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

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

優先度レベル

\n\n

次のステップ

\n\n","urls":{"html":"/docs/getting-started/quick-start","text":"/docs/getting-started/quick-start?format=text","json":"/docs/getting-started/quick-start?format=json","llm":"/docs/getting-started/quick-start?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}