API とプロトコル

共有エージェントメモリのための AMCP サーフェス

エージェントが recall、remember、session、export を 1 つの契約で扱う必要があるなら Nexus AMCP を使ってください。Nunchi Team では Norfolk の知識も citation と provenance を保ったまま同じメモリサーフェスに入ります。

メモリ契約

このサーフェスが公開するもの

重要なのはまた別のラッパーではありません。エージェント、ダッシュボード、メモリ対応ツールが毎回メモリの意味論を再実装しなくてよい、安定した 1 つのプロトコル面です。

  • hosted の remember、recall、session 参照、export、import、delete フロー
  • Codex、Claude Code、Cursor、Windsurf など対応クライアント全体で共有される契約
  • private と team のスコープが誤って混ざらない visibility-aware recall
  • MCP 配線が合わないときに直接使えるプロトコル面

リファレンスクライアント

動いている経路から始める

リファレンス MCP パッケージと hosted gateway は同じメモリ契約を使うため、自前クライアントを作る前に実挙動を確認できます。

リファレンス導入

npx @nunchiai/nexus-mcp@latest init --client codex --key sk_write_your_key --gateway-url https://gateway.nunchiai.com --yes

リファレンスルート

主要な AMCP ルート

現在の hosted AMCP サーフェスで公開している基準ルートです。

POST /v1/amcp/remember
POST /v1/amcp/recall
GET /v1/amcp/sessions
POST /v1/amcp/export
POST /v1/amcp/import
DELETE /v1/amcp/memories/:id

Norfolk レイヤー

Nunchi Team で Norfolk が加わるもの

チーム recall はチャットメモリだけではありません。Norfolk は文書起点の文脈も同じサーフェスへ持ち込みます。

  • 派生出力がどの atom を根拠にしたかを辿れる citation リンク
  • エージェント生成メモリと原資料を分けられる provenance tier
  • private、team、team-readonly を分ける visibility スコープ
  • recall の出所が Norfolk、Nexus、synthesis のどれかを示す source type メタデータ