mcpField
M
mem-setup

mem-setup

github.com/thedotmackエージェントワークフロー104.0k1.0k 回インストール今日更新
リポジトリ

mem-setup について

mem-setupは、プラグインのフックがメモリーを記録・注入できるよう、ユーザーのcmem.ai認証情報を設定するClaude-Memのペアリングスキルです。ローカル設定、秘密情報の扱い、検証も案内します。

主な機能

  1. 01cmem.ai認証情報の設定
  2. 02プラグインフックのペアリング
  3. 03ローカル設定ファイルの構成
  4. 04秘密情報の安全な取り扱い
  5. 05状態の検証

活用シーン

  1. 01Coworkプラグインとcmem.aiの接続
  2. 02ローカルclaude-memのクラウド同期設定
  3. 03フックのペアリング状態確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thedotmack/claude-mem --skill mem-setup

インストール後、Claude Code で/mem-setupを入力して読み込まれたか確認します。

詳細

Claude-Mem のセットアップ(Cowork とのペアリング)

フックがメモリを取得して挿入できるよう、このプラグインにユーザー自身の cmem.ai 認証情報を設定します。誰でもペアリングできます。認証情報はユーザーごとの設定であり、プラグインのロジックにハードコードされることはありません。

収集する情報

cmem.ai → 接続で、ユーザーは次の3つの値を確認できます。

  1. sync token(cm_ で始まります)— ベアラー API キーとして使用します
  2. user id(UUID)
  3. SyncHub URL(https://sync.cmem.ai)

ユーザーが Connect の説明文全体を貼り付けた場合は、そこから3つの値を抽出します。 不足している値がある場合は、最低限 sync token を尋ねてください。残りの2つは任意です。

シークレットの取り扱い — 絶対厳守

  • トークンを会話でそのまま返したり、シェルの argv に含めたり、ログに記録したりしないでください。
  • ファイルへの書き込み(Write/Edit ツール)とファイルの読み取りだけで扱ってください。

手順

  1. インストール済みプラグインのルート(このスキル自身のプラグイン)を特定します。その config.json を更新し、apiKey に sync token を、userId にユーザー ID を、syncHubUrl に SyncHub URL を設定します。ユーザーから依頼がない限り、ほかの設定(inject の切り替え設定)は変更しないでください。プロジェクト名は自動で設定され(cmem_work_*)、変更できません。

  2. Cowork のコンテナは一時的なものです。インストール済みコピーへの編集は、このセッション中のみ有効です。ペアリングを恒久化するには、再パッケージ化して、プラグインディレクトリを <plugin-name>.plugin として zip にまとめ、ユーザーに送って再インストールしてもらいます(cowork-plugin スキルのパッケージ化手順)。これが必要な理由もユーザーに伝えてください。

  3. このマシンにローカルの claude-mem インストールもある場合(~/.claude-mem/ ディレクトリが存在する場合)は、同じ値をモード 0600 で ~/.claude-mem/settings.json に書き込みます(CLAUDE_MEM_CLOUD_SYNC_TOKEN、CLAUDE_MEM_CLOUD_SYNC_USER_ID、CLAUDE_MEM_CLOUD_SYNC_HUB_URL の各キーを使用します。これらはローカルの claude-mem のクラウド同期ペアリングで書き込まれるものと同じキーです)。ローカルに claude-mem がインストールされている環境では、このプラグインのフックは無効のままです。そのため、このペアリングを通じて、このマシンの作業が cmem.ai に反映されます。ワーカーはこれらのキーを起動時にのみ読み取ります。ワーカーを再起動し、claude-mem クラウド同期スキルの検証手順を実行してください。結果には configured: true と hub.reachable: true が表示される必要があります。それが確認される前に成功を報告しないでください。確認できない場合は、代わりにそのスキルのインストーラー手順を使ってペアリングしてください。

  4. シークレットを露出させずに検証します。

    node "${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs" status
    

    マスクされた出力を報告してください。キーが MISSING の場合、書き込みが反映されていません。/api/hooks/context の 404 は、Pro エンドポイントがデプロイされるまでは想定どおりです(検索と挿入は引き続き /api/mcp 経由で動作します)。

別の情報源

環境変数はすべての設定より優先され、ファイルを編集する必要はありません。CMEM_API_KEY、CMEM_USER_ID、CMEM_SYNC_HUB_URL、CMEM_API_BASE。

コメント