パターン 2: MCP
Claude Code、Cursor、Claude Desktop、ChatGPT、その他 MCP 互換クライアントを直接マインドレイヤーに接続。アシスタントは Sonzai を「名前で呼べるツールとリソースの集合」として扱います。
マインドレイヤーはホスト型の Streamable HTTP MCP エンドポイント
https://api.sonz.ai/mcp/memory/{agent_id} を提供します。任意の MCP
互換クライアントを Sonzai API キーと共にこの URL へ向ければ、
34 のツール、4 のリソース、3 のガイド付きプロンプトが利用可能に
なります — ローカルバイナリ・SSE ポート・Go ツールチェーン不要。
使うべき時
- ユーザーがすでに Claude Code / Cursor / Claude Desktop / ChatGPT 等の MCP 互換クライアントを使っている。
- SDK コードではなく会話で Sonzai を駆動したい。
- プロトタイピング中で、
create-companionやmind-layer-setupの ガイド付きプロンプトをそのまま使いたい — コードを書かずに動かしたい。
切り替えるべき時
- 自前のプロダクト UI を構築する — パターン 1: マネージドランタイム に切り替え。
- 他者の LLM のツールとしてではなく、自分の LLM ループの中に Sonzai を 入れたい — パターン 4: スタンドアローン・リアルタイム に切り替え。
アーキテクチャ
┌────────────────────────┐ ┌──────────────────────┐
│ Claude Code · Cursor │ │ Sonzai Mind Layer │
│ ChatGPT · VS Code │ │ │
│ Claude Desktop │ │ │
└──────────┬─────────────┘ └──────────┬───────────┘
│ │
│ Streamable HTTP (JSON-RPC 2.0) │
│ • list_agents │
│ • chat / start_session / end_session │
│ • search_memories / list_facts │
│ • get_personality / get_mood │
│ • generate_character / trigger_event │
│ • schedule_wakeup / list_notifications │
│ │
▼ │
https://api.sonz.ai/mcp/memory/{agent_id} │
Authorization: Bearer sk-your-api-key │
│
▼
Context Engine,
AI Service, DBsエンドツーエンド例
ダッシュボード でプロジェクト API キーを取得し、agent ID を用意してください。クライアントを選んで スニペットを貼り付けるだけで設定完了です。
# 1コマンドでホスト型 MCP サーバーを登録：
claude mcp add --transport http sonzai \
https://api.sonz.ai/mcp/memory/AGENT_ID \
--header "Authorization: Bearer $SONZAI_API_KEY"
# Claude Code セッション内で次のように話せます：
# "Chat with agent 'Luna' and say 'I had a great day hiking today!'"
# "Search Luna's memories about hiking adventures"
# "Use mind-layer-setup with assistant_name 'Aria' …"SSE ではなく Streamable HTTP
2026 年の MCP 仕様では、リモートトランスポートは Streamable HTTP が 標準です。SSE は主要クライアントで段階的に廃止予定 — 新しい統合では HTTP を選んでください。
API キーはパスワード扱い
Bearer トークンはプロジェクト API キーであり、プロジェクト内のすべての エージェントへフルアクセスします。公開リポジトリにコミットしない、 共同作業時は per-developer スコープ設定を使うことを推奨します。