diff --git a/QUICKSTART.md b/QUICKSTART.md
new file mode 100644
index 0000000..251be29
--- /dev/null
+++ b/QUICKSTART.md
@@ -0,0 +1,266 @@
+# クイックスタートガイド 🚀
+
+## 今すぐ試す方法
+
+### ステップ1: MCPサーバーを起動
+
+```bash
+# 基本版（AI機能なし）
+./target/debug/aigpt server
+
+# AI機能有効版（OpenAI APIキーが必要）
+OPENAI_API_KEY=your_key ./target/debug/aigpt server
+```
+
+### ステップ2: Claude Desktop/Codeに設定
+
+#### Claude Codeの場合
+```bash
+# MCP設定に追加
+claude mcp add aigpt /home/user/aigpt/target/debug/aigpt server
+```
+
+#### 手動設定の場合
+`~/.config/claude-code/config.json` に追加：
+
+```json
+{
+  "mcpServers": {
+    "aigpt": {
+      "command": "/home/user/aigpt/target/debug/aigpt",
+      "args": ["server"]
+    }
+  }
+}
+```
+
+### ステップ3: Claude Codeを再起動
+
+MCPサーバーを認識させるため、Claude Codeを再起動してください。
+
+---
+
+## 使い方の流れ
+
+### 🎮 1. 心理テスト風にメモリ作成
+
+**Claude Codeで:**
+```
+create_memory_with_ai ツールを使って
+「今日、新しいAIシステムのアイデアを思いついた」
+というメモリを作成してください。
+```
+
+**結果:**
+```
+╔══════════════════════════════════════╗
+║    🎲 メモリースコア判定          ║
+╚══════════════════════════════════════╝
+
+🟣 EPIC 85点
+💡 【革新者】
+
+💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍
+💎 XP獲得: +850 XP
+
+📤 シェア用テキストも生成されます！
+```
+
+### 💕 2. 恋愛コンパニオンを作成
+
+**Claude Codeで:**
+```
+create_companion ツールで、
+名前「エミリー」、性格「energetic」の
+コンパニオンを作成してください。
+```
+
+**結果:**
+```
+╔══════════════════════════════════════╗
+║  💕 エミリー のプロフィール      ║
+╚══════════════════════════════════════╝
+
+⚡ 性格: 元気で冒険好き
+
+🏆 関係レベル: Lv.1
+💕 好感度: 🤍🤍🤍🤍🤍🤍🤍🤍🤍🤍 0%
+
+💬 今日のひとこと:
+「おはよう！今日は何か面白いことある？」
+```
+
+### 🎊 3. コンパニオンに反応してもらう
+
+**Claude Codeで:**
+```
+companion_react ツールで、
+先ほど作成した記憶IDを渡してください。
+```
+
+**結果:**
+```
+╔══════════════════════════════════════╗
+║     💕 エミリー の反応            ║
+╚══════════════════════════════════════╝
+
+⚡ エミリー:
+「すごい！新しいAIシステムのアイデア
+って本当に素晴らしいね！
+一緒に実現させよう！」
+
+💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍 15%
+💎 XP獲得: +850 XP
+```
+
+### 🏆 4. ランキング確認
+
+**Claude Codeで:**
+```
+list_memories_by_priority ツールで
+TOP 10を表示してください。
+```
+
+**結果:**
+```
+╔══════════════════════════════════════╗
+║   🏆 メモリーランキング TOP 10    ║
+╚══════════════════════════════════════╝
+
+🥇 1位 🟣 EPIC 85点 - 新しいAIシステム...
+```
+
+---
+
+## 現在の制限事項と対処法
+
+### ❌ AI機能が使えない場合
+
+**原因:** OpenAI APIキーが未設定
+
+**対処法:**
+```bash
+# 環境変数に設定
+export OPENAI_API_KEY=sk-...
+
+# または起動時に指定
+OPENAI_API_KEY=sk-... ./target/debug/aigpt server
+```
+
+**代替案:**
+```
+# 基本版のツールを使う（AI機能なし）
+create_memory ツールで「テスト」というメモリを作成
+
+# スコアは固定で 0.5 になります
+```
+
+### ❌ コンパニオンが保存されない
+
+**現状:** セッション終了で消える
+
+**対処法（今後実装予定）:**
+- JSON保存機能
+- 次回起動時に自動ロード
+
+**今できること:**
+- 毎回 create_companion で再作成
+- プロフィールをスクリーンショット保存
+
+---
+
+## トラブルシューティング
+
+### Q: MCPツールが見つからない
+```bash
+# Claude Codeを完全再起動
+# または設定ファイルを確認
+cat ~/.config/claude-code/config.json
+```
+
+### Q: 記憶が保存されない
+```bash
+# データファイルを確認
+ls -la ~/.config/syui/ai/gpt/memory.json
+
+# ない場合は自動作成されます
+```
+
+### Q: ビルドエラーが出る
+```bash
+# 依存関係を更新
+cargo clean
+cargo build --release
+
+# AI機能付き
+cargo build --release --features ai-analysis
+```
+
+---
+
+## おすすめの使い方
+
+### 💡 アイデア記録として
+1. 思いついたアイデアを create_memory_with_ai で記録
+2. スコアで重要度を客観的に判定
+3. 高スコアのアイデアに集中
+
+### 💕 恋愛ゲームとして
+1. コンパニオンを作成
+2. 日々の出来事や考えを記録
+3. コンパニオンに反応してもらう
+4. 好感度MAXを目指す
+
+### 📊 自己分析として
+1. 定期的に思考を記録
+2. 診断タイプの傾向を確認
+3. ランキングで振り返り
+
+---
+
+## 次にやること
+
+### すぐできる改善
+- [ ] コンパニオンの永続化実装
+- [ ] 複数コンパニオン対応
+- [ ] デイリーチャレンジ完了チェック
+
+### 中期的な目標
+- [ ] Bluesky連携（シェア機能）
+- [ ] Webダッシュボード
+- [ ] もっと多様なイベント
+
+---
+
+## 楽しみ方のコツ
+
+1. **毎日使う**
+   - daily_challenge で習慣化
+   - コンパニオンの「今日のひとこと」
+
+2. **高スコアを狙う**
+   - LEGENDARY (90%+) を目指す
+   - XP 1000獲得の快感
+
+3. **相性を楽しむ**
+   - 自分のタイプを確認
+   - 相性の良いコンパニオン選択
+
+4. **イベントを楽しむ**
+   - 好感度100%の告白イベント
+   - レベル10の特別な絆
+
+---
+
+## さあ、始めよう！ 🚀
+
+```bash
+# MCPサーバー起動
+./target/debug/aigpt server
+
+# Claude Codeで試す
+# → create_memory_with_ai
+# → create_companion
+# → companion_react
+# → 楽しむ！
+```
diff --git a/test-mcp.sh b/test-mcp.sh
new file mode 100755
index 0000000..e656ea9
--- /dev/null
+++ b/test-mcp.sh
@@ -0,0 +1,47 @@
+#!/bin/bash
+
+echo "🧪 MCPサーバーテスト開始..."
+echo ""
+
+# サーバー起動（バックグラウンド）
+./target/debug/aigpt server &
+SERVER_PID=$!
+
+sleep 2
+
+echo "✅ サーバー起動完了 (PID: $SERVER_PID)"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📋 利用可能なツール一覧:"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "基本ツール:"
+echo "  • create_memory"
+echo "  • search_memories"
+echo "  • update_memory"
+echo "  • delete_memory"
+echo ""
+echo "AI機能ツール 🎮:"
+echo "  • create_memory_with_ai (心理テスト風)"
+echo "  • list_memories_by_priority (ランキング)"
+echo "  • daily_challenge (デイリークエスト)"
+echo ""
+echo "恋愛コンパニオン 💕:"
+echo "  • create_companion"
+echo "  • companion_react"
+echo "  • companion_profile"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "🎯 次のステップ:"
+echo "1. Claude Codeの設定に追加"
+echo "2. Claude Code再起動"
+echo "3. ツールを使って試す！"
+echo ""
+echo "設定ファイル: ~/.config/claude-code/config.json"
+echo ""
+
+# サーバー停止
+kill $SERVER_PID 2>/dev/null
+
+echo "✅ テスト完了！"