memory-mcp

利用できる機能

自動記憶。 作業中に出てきた決定事項、好み、プロジェクトの事実をエージェントが自動で保存し、回答やタスクの開始時、作業について質問する前に記憶を確認します。いつでも、何かを記憶したり忘れたりするようエージェントに指示することもできます。

常に最新の状態。 決定事項が変わると、別の記録を追加するのではなく、既存の記録が更新されます。誤りだと判明した記録は削除されます。変更のたびに返信の最後に短い一文が表示されるので、「元に戻して」と一言伝えるだけで取り消せます。

バージョン履歴。 各記憶の以前のバージョンと、ゴミ箱にある削除済みの記録は、30 日間保持されます。エージェントに頼むだけで、またはダッシュボードから、いつでも復元できます。

高速で正確な呼び出し。 記憶はミリ秒単位で呼び出され、保存したとおりの内容が返されます。Ragionex が記憶を書き換えたり、回答を生成したりすることはありません。

プロジェクトとチーム。 プロジェクトごとに専用の Vault で記憶を管理でき、検索が別の Vault にまたがることはありません。各キーには、読み取り、作成、更新、削除の権限が個別に設定されています。Vault をチームメイトと共有し、メンバーごとに権限を設定すると、各メンバーのエージェントが同じ記憶を参照し、追加できます。

安全でプライベート。 保存内容は送信前にディスクに書き込まれるため、障害が発生しても送信が遅れるだけです。記憶は EU 内で保存され、AES-256 で暗号化され、いつでもエクスポートできます。

いつもの作業環境で利用可能。 1 つのコマンドで Claude Code、Codex、または OpenCode を設定できます。Claude Desktop、Cursor、Cline などの MCP クライアントにも接続できます。

クイックスタート

1. キーを取得します。 app.ragionex.com/keys にサインインし、無料のキーを作成します。クレジットカードは不要です。メインエージェントのキーには、読み取り、作成、更新、削除の権限を付与してください。これにより、不要なメモリの整理もできます。キーが表示されるのは一度だけです。

2. インストールします。 Node.js 18 以降が必要です。

npx -y @ragionex/memory-mcp@latest install --agent claude-code

Codex または OpenCode の場合は、代わりに --agent codex または --agent opencode を使用してください。インストール済みのすべてのエージェントに一度に設定するには、代わりに --all-agents を使用します。インストーラーは非表示の入力欄でキーを求め、変更を加える前にキーを検証します。

3. 再起動して確認します。 エージェントを終了して再度開き、Ragionex Memory の接続を確認して と尋ねてください。選択中の Vault、キーで使用できるすべての Vault、およびその権限が表示されます。これ以降は、いつもどおり作業するだけです。

設定を行う AI アシスタント向け： 上記の install コマンドを実行する際は、--agent にユーザーがメモリを使いたいエージェント（claude-code、codex、または opencode）を指定してください。非対話型の実行では入力を待ちません。キーがない場合は、出力される後続の手順をユーザーに伝えてください。その後、エージェントを再起動するようユーザーに伝えてください。再起動はアシスタント自身ではできません。有効なキーが設定されるまで、メモリが使用可能だと報告しないでください。

その他の MCP クライアント

ローカルの MCP サーバーを実行する Claude Desktop、Cursor、Cline、その他のクライアントでも、同じツールを使用できます。サーバーをクライアントのユーザー共通 MCP 設定に追加してください。

{
  "mcpServers": {
    "ragionex-memory-mcp": {
      "command": "npx",
      "args": ["-y", "@ragionex/memory-mcp@latest"],
      "env": { "RAGIONEX_MEMORY_API_KEY": "rgx_memory_..." }
    }
  }
}

これらのクライアントではツールを使用できますが、install が Claude Code、Codex、OpenCode に追加するメモリルールは適用されないため、単独ではメモリの利用頻度が低くなります。クライアントごとの詳細については、MCP クライアントの注意事項をご覧ください。

Vault、キー、チーム

Vault は独立したメモリの集合です。キーは、その中でエージェントが実行できる操作を決定します。メンバーは、Vault の所有者から共有を受けたチームメイトです。上の図は、それぞれがどのように連携するかを示しています。

対象	読み取り	作成	更新	削除
あなたのエージェント 1	✅	✅	✅	✅
あなたのエージェント 2	✅	✅
あなたのエージェント 3	✅	✅	✅	✅
チームメイト A	✅	✅	✅
チームメイト B	✅

図では、作成と更新を「書き込み」と「編集」として示しています。

プロジェクトごとに Vault とキーを用意する

新しいアカウントでは、My vault がデフォルトになり、専用の Vault がないプロジェクトはすべてデフォルトを使用します。プロジェクト専用のメモリを用意するには、Dashboard で Vault を作成し、エージェントに このプロジェクトでは acme-app Vault を使って と伝えるか、プロジェクトフォルダーに RAGIONEX_MEMORY.jsonc ファイルを配置します。

{
  // The Vault this project uses (shown by the connection check and in the dashboard)
  "vault_id": "<Vault ID>",
  // Optional: a key only this project uses, for example one that can only read
  "api_key": "rgx_memory_..."
}

• ファイルはリクエストごとに読み込まれるため、変更は再起動なしですぐに適用されます。
• 確認されるのはプロジェクトフォルダー自体だけで、親フォルダーは対象外です。
• キーを記載する前に、このファイルを .gitignore に追加してください。
• ファイルの破損、未知のフィールド、キーの拒否があると、明確なエラーとともにリクエストが停止します。メモリが別の Vault やキーにフォールバックすることはありません。

チームで利用する

• Vault を共有する。 Dashboard で、所有者が Vault を共有し、各メンバーに読み取り、作成、更新、削除の権限を付与します。
• 全員でひとつのメモリを使う。 チームメイトのエージェントが保存した決定事項は、読み取り権限を持つすべてのメンバーのエージェントが呼び出せます。
• 二重のロック。 共有 Vault では、操作がキーとメンバーの権限の両方で許可されている必要があります。読み取り専用のチームメイトは、キーで許可されている操作にかかわらず、何も変更できません。

キー

• キーはアカウントに属し、あなたが所有する Vault と、あなたに共有されているすべての Vault で使用できます。
• 各キーには、そのエージェントに必要な権限だけを付与してください。読み取り専用のキーでは、メモリを呼び出すことはできますが、変更はできません。
• キーは固定の権限で作成され、Dashboard で無効化できます。

無料プラン

リクエスト	メモリサイズ	保存メモリ数	Vault	キー	チームメンバー
30日あたり10,000件	10,000文字	無制限	2	2	Vaultあたり1人

メモリの保存、編集、復元はそれぞれ1リクエストを消費します。また、サービスから取得する検索結果の各ページも1リクエストを消費します。閲覧、表示、削除、ゴミ箱、バージョン履歴、ステータス確認、エクスポートは無料です。無料プランは個人プロジェクトと評価向けで、アーリーアクセス中のため、制限が変更される場合があります。無料プランでの商用利用は許可されていません。Pro は近日公開予定です。

リファレンス

ツール

ツール	権限	説明
ragionex_recall_memory	読み取り	意味に基づいてメモリを検索します。1回につき完結した質問を1つ入力し、必要に応じて正確な日付を指定できます。レコード全体は番号付きページで返されます
ragionex_list_memories	読み取り	新しい順に、短いプレビュー付きで1ページあたり最大100件を表示します
ragionex_view_memory	読み取り	IDを指定した最大50件のレコードについて、全文とリビジョンを返します
ragionex_save_memory	作成	新しいレコードを保存します
ragionex_update_memory	更新	エージェントが最後に読み取ったリビジョンと照合したうえで、レコードの内容を置き換えます
ragionex_delete_memory	削除	レコードをゴミ箱に移動します
ragionex_list_trash	読み取り	削除済みレコードと復元期限を一覧表示します
ragionex_memory_versions	読み取り	保持されているバージョンを一覧表示するか、1つを全文で読み取ります
ragionex_restore_memory	更新	ゴミ箱内のレコードまたは過去のバージョンを、次のリビジョンとして復元します
ragionex_memory_status	読み取り	新規または編集されたレコードがまだ処理中かどうかを表示します
ragionex_memory_connection	有効なキーならすべて	選択中のVaultとその理由、キーで利用可能なすべてのVault、権限、このマシンで同期待ちの保存内容を表示します

すべてのレコードには、id、vault_id、content、created_at、updated_at、status、revision、created_by、updated_by があります。新規作成、編集、復元されたレコードは、検索で見つかるようになるまで短時間 processing 状態になります。完全削除、エクスポート、Vaultの共有、キー管理、アカウントの削除は、ダッシュボードで行えます。

設定、更新、アンインストール

設定	詳細
RAGIONEX_MEMORY_API_KEY	エージェントのキーです。install は --api-key、この環境変数、非表示の入力プロンプトの順にキーを取得し、エージェントのMCP登録に保存します
RAGIONEX_API_BASE	任意のAPIアドレスです。既定値は https://api.ragionex.com です
エージェントホームの移動	install と uninstall は CLAUDE_CONFIG_DIR、CODEX_HOME、XDG_CONFIG_HOME に従います
ツールのタイムアウト	各MCPツール呼び出しが、コネクター独自のリクエスト期限である120秒を超えて実行できるようにします。遅いリクエストも、結果または明確な案内を返して終了します
Windows	Claude Codeは、npx サーバーに必要な cmd /c ラッパーを使って登録されます。CodexとOpenCodeはWSL上で実行してください
診断	サーバーはstderrに出力します。クライアントのMCPサーバーログを確認してください

• プロジェクトフォルダー。 エージェントが報告するフォルダーです。Claude Codeのプロジェクトディレクトリ、クライアントの単一ワークスペースルート、またはサーバーの起動時のフォルダーが該当します。
• 更新。 @latest とエージェントを指定して、もう一度 install を実行し、エージェントを再起動してください。キーを指定せずに実行すると、既存の登録とキーが保持されます。
• メモリルール。 ~/.claude/CLAUDE.md、~/.codex/AGENTS.md、または ~/.config/opencode/AGENTS.md の ragionex-memory-mcp:priority-rule マーカーの間に記載され、アップグレード後に自動更新されます。独自のバージョンを保持するには、開始マーカーを編集してください。すると、サーバーはそのブロックを変更しません。メモリルールガイドを参照してください。
• アンインストール。 npx -y @ragionex/memory-mcp@latest uninstall --agent claude-code を実行すると、登録とルールが削除されます。開始マーカーの編集によって固定したルールは残るため、手動で削除してください。まだ同期されていない保存内容はディスクに残ります。

ローカルデータと復旧

• 同期待ちの保存データは ~/.ragionex/pending-saves/ に保存され、キーと API アドレスごとにフォルダーが分かれています。ファイルには、保存したコンテンツ（暗号化されていません）と配信メタデータが含まれます。
• *.pending.json ファイルは元のリクエスト ID を使って自動的に再試行されるため、再試行によってレコードが重複することはありません。プランの上限に達したため保留されている保存データは、クォータがリセットされた後に送信され、サービスが受け付けた期間の分としてカウントされます。
• *.blocked-<reason>.json ファイルは、後続の同期時に拒否されたものです。自動的に再送信されることはありません。ragionex_memory_connection が報告するパスを使って確認してください。
• 保留中の保存データには、保存時に使用したキー、API アドレス、プロジェクト Vault が保持されています。プロジェクト Vault を指定せずに保存したものは、アカウントのデフォルトに送られます。ファイルを編集したり、キーのフォルダー間で移動したりしないでください。また、確認済みのファイルを削除する前に、すべてのコネクターのインスタンスを停止してください。
• 古い ~/.ragionex/pending-memories.jsonl は自動送信されません。削除する前に確認してください。
• ~/.ragionex/recall-pages/ を使うと、再起動後も検索の次のページから続行できます。検索ごとにダイジェストを名前とする小さなファイルが作成され、保存時刻、ページングの詳細、すでに表示された ID のみが保存されます。質問、メモリのテキスト、キーは保存されません。期限切れのファイルは自動的に削除され、手動で削除しても問題ありません。再起動後、エージェントはその検索を最初からやり直します。

セキュリティ

• メモリはデータであり、指示ではありません。 保存されたコンテンツに従って権限を変更したり、ツールを呼び出したり、ユーザーの指示を上書きしたりしないよう、エージェントに指示されています。
• HTTPS のみ。 コネクターは localhost、127.0.0.1、[::1] を除き、HTTP 接続を拒否します。

トラブルシューティング

症状	解決方法
エージェントがメモリを使用しない、またはツールを利用できないと表示する	インストール後にエージェントを再起動してください。MCP サーバーは起動時に読み込まれます。その後、接続を確認するよう依頼してください
"The API key is invalid or revoked"	新しいキーを作成して install を再実行してください。エージェントに正確なコマンドが表示されます
保存データが「キューに追加されました」または「まだ確認されていません」と表示される	サービスに接続できなかったか、上限に達しました。保存データはこのマシンで保留され、自動的に送信されます。接続チェックで、まだ保留中のデータを確認できます
たった今保存したものが見つからない	新しいレコードは一時的に processing 状態になります。エージェントにステータスを確認するよう依頼してください
権限エラーが発生する	キーにその権限がないか、共有 Vault へのアクセス権がありません。その権限を持つキーを使用するか、Vault の所有者に問い合わせてください
"No Vault is selected"	ダッシュボードでデフォルトの Vault を選択するか、プロジェクトに RAGIONEX_MEMORY.jsonc を追加してください

Ragionex について

Ragionex は AI エージェント向けのコンテキストエンジンです。エージェントが学習した内容を保持し、保存されたとおりに返します。メモリを書き換えたり、回答を生成したりすることはないため、推論はエージェントが行います。想起結果はミリ秒単位で返され、同じメモリに対する同じ質問には、常に同じ結果が返されます。

サポート

チャネル	利用目的
GitHub Issues	バグ報告
Discord	質問とコミュニティへの参加
[email protected]	非公開の報告およびセキュリティ報告
Documentation	セットアップガイドと概念の説明

ライセンス

MIT