エージェント メモリ

セッション間でエージェントに永続的なメモリを付与します。タスク開始前に前回の失敗を思い出します。作業完了後に、成功したか失敗したかを記録します。繰り返された失敗から防止ルールが自動生成されます。

セットアップ

MCP サーバーを追加します（一度だけ）：

claude mcp add thumbgate -- npx -y thumbgate serve

API キーは不要です。すべてのデータはローカルに保存されます。

使用場面

• 新しいタスクまたはセッションを開始する場合 — 過去のコンテキストを思い出してください
• 成功または失敗した作業を完了した後 — フィードバックを記録してください
• エージェントが同じ間違いを繰り返す場合 — 防止ルールを確認してください

ワークフロー

ステップ 1: 過去のコンテキストを思い出す（すべてのタスクで最初に実行してください）

recall MCP ツールを現在のタスクの説明で呼び出します。このツールは以下を返します：

• このタスクに関連する過去のフィードバック（ベクトル類似度検索）
• アクティブな防止ルール（繰り返された失敗から自動生成）
• 承認率を含む最近のフィードバック概要

防止ルールを注意深く読んでください。これらは以前失敗したパターンです — それらに従ってください。

ステップ 2: 作業を実行する

通常通りタスクを完了します。何をしたかと、それが機能したかを追跡してください。

ステップ 3: フィードバックを記録する

capture_feedback MCP ツールを呼び出します：

成功した場合：

• signal: up
• context: 何が機能したか、およびその理由
• tags: カテゴリラベル

失敗した場合：

• signal: down
• context: 何をしようとしていたか
• whatWentWrong: 具体的な失敗の説明
• whatToChange: 次回これを避ける方法
• tags: カテゴリラベル

「失敗した」というような曖昧なフィードバックは拒否されます。具体的に記述してください。

ステップ 4: 改善を確認する（オプション）

feedback_stats MCP ツールを呼び出して、承認率、失敗が多いドメイン、エージェントが改善しているか悪化しているかを確認します。

利用可能な MCP ツール

ツール	機能
recall	現在のタスクの過去のフィードバックと防止ルールを検索
capture_feedback	構造化されたコンテキストで機能したか失敗したかを記録
prevention_rules	繰り返された失敗から自動生成されたルールを表示
feedback_stats	承認率、トレンド分析、失敗が多いドメイン
feedback_summary	最近のシグナルの人間が読みやすい概要

MCP プロファイル

プロファイル	ツール	ユースケース
essential	5 つのコアツール	デフォルト — ここから開始
commerce	6 つのツール + commerce_recall	エージェント型コマース
default	12 ツール	DPO エクスポートを含む完全なパイプライン

プロファイルを設定：THUMBGATE_MCP_PROFILE=essential npx thumbgate serve

防止ルールの仕組み

1. エージェントが間違い A を行う → down フィードバックを記録します
2. エージェントが再び間違い A を行う → 再び down フィードバックを記録します
3. システムがパターンを検出 → 防止ルールを自動生成：「決して A をしない」
4. 次のセッション → recall がルールを返す → エージェントがそれに従う

これが中核的な価値です。エージェントは学習しませんが、ルールを読んでそれに従います。

リンク

• GitHub
• npm
• MCP Registry