Agent Plugins 記憶プラグイン
Myrm は Agent Plugins 標準に沿ったポータブルプラグインを提供し、長期記憶をこの標準に対応した任意のクライアント — VS Code、GitHub Copilot、Kiro、Cursor、ChatGPT、Codex など — に接続できます。プラグインは輸送層のみを担当します。Myrm の記憶サービスへ MCP クライアントを指し示し、接続された agent に「記憶をいつ・どのように使うか」を伝えるだけで、クライアントごとの設定ファイルを手で編集する必要はありません。プラグインに含まれるもの
プラグインの生成
- 設定 → 記憶 → 接続（接続ウィザード）を開きます。
- 記憶を外部公開する Myrm エージェントを選びます。
- Agent Plugins カードで、token をプラグインファイルへ書き込むか、
MYRM_MCP_TOKEN環境変数から読み取るかを選びます。 - Agent Plugins プラグインを生成をクリックし、すべてダウンロード (.zip) でまとめて取得するか、各ファイルを個別にコピーします。zip を展開すると正しいディレクトリ構造が入っています — それをクライアントのプラグインディレクトリへ置いて有効化してください。
plugin.json と mcp.json はプラグインのルートに、SKILL.md は skills/myrm-memory/ サブディレクトリに置きます。zip はこの構造を自動で保持します。ファイルを個別にコピーする場合は手動で再構成してください。クライアントは skills/<name>/ サブディレクトリからスキルファイルしか読み込まず、ルートに置かれた SKILL.md は黙って無視されます。
token を書き込むモードはそのまま使えますが、資格情報が mcp.json に残るため、この種のプラグインをリポジトリにコミットしないでください。既定の環境変数モードは資格情報を持たないため安全にコミットできます。ほとんどのクライアントは ${MYRM_MCP_TOKEN} を展開しますが、一部（VS Code、Cursor）は ${env:MYRM_MCP_TOKEN} を使います。クライアントが補間に対応しない場合はウィザードで token 書き込みモードを有効にしてください — token はいつでも失効させられます。
アクセスの管理
- 生成された token は選択した Myrm エージェントに紐づき、プラグイン経由ではそのエージェントの記憶にだけアクセスできます。
- ウィザードで再生成すると新しい token が発行され、古い token は即座に失効します。古いプラグインを使っているクライアントは再設定が必要です。
- ウィザードで接続を取り消すと token は即座に失効します。
- 依存する前に、ウィザードのヘルスチェックで接続を検証できます。
Doctor 診断の実行
ウィザードの Doctor ボタンはオンラインの token テスト以上に一歩先です。機械上の MCP クライアントの実際の設定ファイルを読み、クライアント側からプラグインの接続を確証します。- JSON（
json_mcp）と TOML（toml_mcp）の両クライアント形式に対応し、パス内の~は自動的に展開されます。 - token は SHA-256 ハッシュのみで保存され、平文では一切残りません。
- 診断メッセージは 6 言語（EN / 中文 / 繁體 / 日本語 / 한국어 / DE）に対応し、各診断コードに実行可能な修復手順が付きます。
- Doctor は読み取り専用で、クライアントの設定ファイルを書き換えません。
セルフホスト
プラグインは輸送層のみを担当するため、セルフホスト instance（ローカル Web UI、デスクトップ、クラウドサンドボックス）でも同様に使えます。mcp.json の url を自前の instance の /mcp エンドポイントに向け、該当する instance の接続ウィザードで token を生成してください。