MCP 統合

マインドレイヤーはホスト型の Streamable HTTP MCP エンドポイント https://api.sonz.ai/mcp/memory/{agent_id} を提供します。任意の MCP 互換クライアントを Sonzai API キーと共にこの URL へ向ければ完了 — ローカルバイナリ、SSE ポート、Go ツールチェーンは不要です。

サーバーは Model Context Protocol 仕様を実装しており、34 のツール、4 のリソース、3 のガイド付き プロンプト を公開します（下記 ツールカタログ 参照）。

必要なもの

1. プロジェクト API キー — プロジェクト設定 で作成。
2. エージェント ID — ダッシュボードまたは SDK で作成、もしくは 初回接続後に create-companion MCP プロンプトを実行して生成。

クライアントを選ぶ

# 1コマンドでホスト型 MCP サーバーを Claude Code に登録：
claude mcp add --transport http sonzai \
https://api.sonz.ai/mcp/memory/AGENT_ID \
--header "Authorization: Bearer $SONZAI_API_KEY"

# --scope でスコープを指定：
#   local   (デフォルト) — 現在のプロジェクトのみ、自分専用
#   project              — .mcp.json に書き込み (チーム共有用にコミット)
#   user                 — 全プロジェクト共通 (~/.claude.json)

# 登録の確認：
claude mcp list

認証

上記すべての例は Bearer キーの経路を使用 — 特定エージェントに紐付き、 プロジェクト API キーが唯一の秘密です。OAuth モードは /.well-known/oauth-authorization-server ディスカバリで提供され、 クライアントがピッカー UI 経由で利用可能なエージェントを発見できます (現在 beta)。

ツールカタログ

MCP サーバーは 34 ツールを 6 カテゴリに分けて提供します。各ツールは Platform API エンドポイントに 1 対 1 でマップします。

エージェント管理 (5)

• list_agents — 検索＋ページネーションで一覧
• get_agent — 詳細 (人格、能力、ステータス)
• create_agent — 人格・Big5・種記憶・目標を指定して作成
• update_agent — プロフィール更新 (名前、人格、bio、挨拶)
• delete_agent — エージェントとデータを完全削除

チャット (1)

• chat — メッセージ送信 + 完全コンテキスト (記憶・気分・人格・関係) で応答

記憶 (5)

• get_memory — 階層化メモリツリー取得
• search_memories — 自然言語メモリ検索
• list_facts — 種類別 (profile, preference, emotion …) のアトミック事実
• get_memory_timeline — 時系列のメモリタイムライン
• reset_memory — すべての記憶を削除 (取り消し不可)

行動 (11)

• get_personality / update_personality — Big5 特性、BFAS 次元
• get_mood / get_mood_history — 4D 感情状態と履歴
• list_goals / create_goal / update_goal — エージェントの目標
• get_habits — 行動パターンと強度スコア
• get_relationships — Love スコア、ナラティブ、ケミストリ
• get_interests — 検出された関心と確信度
• get_diary — AI 生成の日記エントリ

セッションとステート (5)

• start_session / end_session — 連続性のためのチャットセッション
• list_custom_states / upsert_custom_state / get_custom_state — カスタム key-value

生成とイベント (7)

• generate_character — テキストから完全キャラクター生成
• generate_and_create_agent — 生成 + 作成を 1 ステップで
• trigger_event — 気分・記憶・行動に影響
• list_notifications / schedule_wakeup — プロアクティブ連絡
• generate_bio — 既存エージェントの bio 生成
• list_voices — 利用可能な TTS 音声

リソース

リソースは MCP sonzai:// URI として読み取り専用データを提供します。

ガイド付きプロンプト

アシスタントが名前で呼べる作り込まれたワークフロー。

create-companion

ひと言のコンセプトからフル装備のエージェントを生成。

引数: concept — 例: "a philosophical barista who reads tarot cards"。

analyze-agent

エージェントの人格・気分・記憶・関係を深掘り分析。

引数: agent_id — UUID または名前。

mind-layer-setup

任意の AI アシスタント向けに Sonzai を永続マインドレイヤーとして構成。

引数: assistant_name、personality_description。

アーキテクチャ

Claude Code · Cursor · ChatGPT · VS Code · Claude Desktop
         │
         │ Streamable HTTP (JSON-RPC 2.0)
         ▼
https://api.sonz.ai/mcp/memory/{agent_id}
         │
         ├─ Context Engine (memory, personality, behavior)
         ├─ AI Service (LLM generation)
         └─ ScyllaDB · Redis · CockroachDB

エアギャップや stdio のみのクライアント向けには、オプションの sonzai-mcp バイナリがユーザーマシン上で stdio JSON-RPC ↔ HTTPS REST を プロキシします。