困ったとき

まず状態を確かめる

agent-memory health
agent-memory cloud health --base-url https://agent-memory.jp
agent-memory ingest progress
agent-memory cloud sources --base-url https://agent-memory.jp --limit 1

手元の状態が ok、クラウドが認証済みで利用可能、取り込みの error_count が 0、最新の記録に verified_at があれば正常です。

セッションが取り込まれない

• SessionEnd フックがオンになっているか確かめます: agent-memory hooks status。
• Codex は新しいフックを信頼するか確認してきます。Codex の画面で承認してください。
• 定期的な回収を待つか、アプリから取り込みを始めます。
• agent-memory ingest deferred で、失敗が続いて外したファイルがないか見ます。--reset を付けると再試行の対象に戻ります。

語句でしか見つからない

• 手元では、モデルをまだ取得していないかもしれません。agent-memory model prepare を実行するか、設定から取得します。
• Remote MCP の意味検索には自分のキーが要ります。query_embedding_not_configured はキーが未設定という意味で、語句で検索するのは想定どおりの動きです。

ChatGPT や Claude に読み取りのツールしか出ない

コネクタを切断してから接続し直してください。ツールリストの更新では認可はやり直されません。詳しくは権限が増えたとき。

ローカルのときにクラウドのコマンドが失敗する

ローカルは外部への通信を止めるので、cloud のコマンドとクラウドへの取り込みは断られます。先にアプリで保存先を切り替えてください。

手元のポートで何も待ち受けていない

想定どおりです。アプリは手元で HTTP サーバーを動かしません。エージェントは CLI と MCP stdio を使います。

それでも解決しないとき

実行したコマンドと表示された内容を添えて、contact@arcm.co.jp までご連絡ください。