Bucketとscopeは異なる境界です
Bucketはストレージのnamespaceです。Scopeは取得時に使うプロジェクト、セッション、またはチームの境界です。両者を分けることで、1つのアカウントに複数のプロジェクトを保持しても、メモリが互いに混ざりません。
- bucket — ストレージnamespace。通常はagent process memoryのworkです。
- scope — 取得時に適用する、明示的なproject/session/teamのグループです。
- path — scope内の論理的位置。ILIKE patternでフィルタリングします。
- team_id — 呼び出し元がすでにアクセスできる1つのteamに取得を制限します。
1つのscope内で取得する
searchにscopeを渡すと、結果を1つのプロジェクト境界内に保てます。Scopeは認証済みtokenに対して検証されるため、アクセス範囲を広げることはできません。
GET /v1/memories/search?query=MCP%20token%20context&scope=memory-os&memory_type=semantic&limit=5
X-API-Key: <your-assigned-api-key>SDKからscopeを指定する
TypeScript clientも同じ境界引数を受け取るため、captureとrecallは呼び出し元が認可されたプロジェクト内にとどまります。
const search = await client.search('MCP token context', {
scope: 'memory-os',
memoryType: 'semantic',
candidateCount: 20,
explain: true,
});ペルソナフロー
ChatGPT ユーザー
bearer token をチャットに貼り付けずに、ChatGPT が XMemo の設定、プロジェクト事実、意思決定、TODO に永続的にアクセスできるようにします。
合成の設定またはプロジェクトメモを保存し、新しいチャットを開始してから、作業を続ける前に ChatGPT に XMemo 経由でそれを呼び出させます。
Copilot / Codex 開発者
リポジトリの判断、コーディング規約、バグ修正メモ、タスク履歴を IDE と CLI エージェント間で持ち運べます。
コードベースの判断またはバグ修正を記録し、次の IDE または CLI エージェントに、編集前に関連する XMemo コンテキストを呼び出させます。
チーム / エンタープライズ pilot owner
アカウント制御、ソース attribution、エクスポート/削除ワークフロー、レビュー担当者向けに安全な設定証跡で共有メモリを評価します。
pilot メンバーに合成のチームメモリを保存してもらい、XMemo でソース attribution を確認し、削除/エクスポートとサポート経路をレビューします。