cachly-dev

cachly — コーディングエージェントのための体験（MCP サーバー）

一度解決すれば、次からは AI が知っています。

あらゆる修正、判断、行き詰まりが、AI が適切なタイミングで活用する経験になります。開発を加速でき、チームはあなたの発見を土台に開発できます。

@cachly-dev/mcp-server は、MCP を通じて cachly を Claude Code、Cursor、 GitHub Copilot、Windsurf、Cline、Continue.dev、Zed、Codex CLI、Gemini CLI に接続します。124 個の MCP ツールを提供します。エディターには既定で 27 個の項目が表示され、残りのツールにはそのうちの 1 つである cachly_tool を介してアクセスします（詳細は以下の「MCP ツール」を参照）。修正後、AI は教訓を保存し、同じ問題が再発したときにそれを見つけます。あなたの Brain（教訓を保存する場所）は EU のサーバー上にあります。

アカウントなしで始める

Claude Code

/plugin marketplace add cachly-dev/cachly-mcp
/plugin install cachly-brain@cachly

JSON を書いたり、パスを設定したり、キーをコピーしたりする必要はありません。キーがない場合、セッション開始時に cachly が EU のサーバー上にテスト用 Brain を作成します（プラグインのフックが作成し、フックが作成しなかった場合は最初のツール呼び出しで作成します）。テスト用 Brain では、Dev ティアを 14 日間利用できます。その後は同じキーで無料ティアに移行します。

claude mcp list で確認できます。plugin:cachly-brain:cachly … ✔ Connected と表示されるはずです。サーバーが実行中でも claude plugin details には MCP servers (0) と表示されます。これはサーバーがカウントされないためです。

このプラグインは Claude Code に 3 つのフックを追加します。

自動更新を一度有効にしてください：/plugin → マーケットプレイス → cachly → 自動更新を有効にする。Claude Code は、Anthropic 自身以外のマーケットプレイスでは自動更新を無効にしています。MCP サーバーは起動のたびに自動更新されますが、フックはプラグインに含まれているため、プラグインの更新時にのみ更新されます。更新がある場合、セッションの最初の session_start でその旨が一行で通知されます。

テスト用 Brain を保持する

npx @cachly-dev/mcp-server@latest claim

ブラウザーで一度サインインします。すると、テスト用 Brain はすべての教訓とともにあなたのアカウントへ移行します。テスト用キーはすべて失効し、エディターとフックが参照する場所に新しいキーが保存されます。Brain は一度再起動し、約 20 秒かかります。すでに無料 Brain がある場合は、無料ティアの Brain 1 つという制限が適用され、メッセージとともに移行が拒否されます。

Cursor、Windsurf、VS Code、Cline、Continue.dev、Zed

npx @cachly-dev/mcp-server@latest autopilot

autopilot は使用中のエディターを見つけ、それぞれの MCP 設定を書き込みます。コミットから学習し、Git の履歴を使って Brain を埋める Git フックも追加します。ブラウザーで一度サインインするだけで（デバイスコードを使用し、パスワードもクレジットカードも不要です）、最初から Brain が自分のアカウントに属します。その後、エディターを再起動してください。

サーバーを手動で追加することもできます（手動セットアップを参照）。キーがない場合、最初のツール呼び出しで Claude Code と同じテスト用 Brain が作成されます。

すでに Claude、Cursor、または Copilot を使っていますか？ 次の内容を AI に貼り付けてください：

このプロジェクトに cachly をセットアップしてください。次を実行してください：npx @cachly-dev/mcp-server@latest autopilot
ブラウザーでのサインインを完了してから、エディターを再起動してください。

VS Code 拡張機能

cachly Brain をインストールしてください。 アカウントの入力フォームなしで、初回起動時に Brain が作成されます。

JetBrains プラグイン

JetBrains Marketplace から Cachly Brain をインストールします（IntelliJ IDEA、PyCharm、GoLand、WebStorm、Rider）。ステータスバー、Brain の状態、レッスンビューを IDE 内で確認できます。ソースは cachly-dev/cachly-intellij にあります。 JetBrains プラグインガイドでは、Claude Code、Junie、 JetBrains AI Assistant が MCP 経由で Brain を利用する方法を説明しています。

MCP Registry

サーバーは公式の MCP Registry に io.github.cachly-dev/mcp-server として登録されています。レジストリを参照するクライアントは、名前で見つけることができます。 エントリーからこの npm パッケージにアクセスできます。

ガイド

仕組み

1. 修正、決定事項、行き詰まりを教訓として保存します。トピック、うまくいったこと、失敗したこと、重大度、ファイルパス、コマンド、作成者が含まれます。
2. セッション開始時に、AI に前回のセッション、未解決の失敗、最近の教訓をまとめたブリーフィングが届きます。
3. 何かを尋ねると、smart_recall が該当する教訓を検索します。11 言語に対応し、キーワード検索（BM25）、意味ベースの検索、因果グラフを組み合わせます。
4. エラーが発生すると、causal_trace が症状から原因へ、さらにうまくいった修正までたどります。
5. デプロイ前に、brain_predict が過去のインシデントから失敗パターンを一覧表示します。
6. git フックとCI テンプレートが、コミットや red-to-green の実行から教訓を追加します。
7. 教訓はチーム内で共有されます。それぞれの教訓には、それを学んだ人の名前が記録されます。

インストールする前に AI が何を把握できるか確認するには、プロジェクトフォルダーで npx @cachly-dev/mcp-server@latest demo を実行してください。git の履歴を読み取り、 修正、パターン、決定事項を出力します。データがマシンの外に出ることはありません。

皆さまとの約束。 いつでも利用をやめて、データを持ち出せます。 npx @cachly-dev/mcp-server@latest export を実行すると、すべての教訓が lessons.md（閲覧用）と lessons.jsonl（再利用用）に書き出されます。コードの抜粋は、 ご自身で index_project を呼び出した場合に限り、ご自身の EU インスタンスにのみ保存されます。 判断する前に、 マシンの外に出るデータをお読みください。

MCP ツール（合計 124 個、デフォルトでは 27 個を表示）

エディターには、デフォルトで 27 個の項目が表示されます。日常的に使うツール（26 個）と、 ディスパッチャーの cachly_tool です。これは意図的なものです。124 個の全リストでは、 リクエストごとに約 28,000 トークンが必要になります。表示する項目を 27 個に絞ると、 約 8,000 トークンで済みます。残りのツール（98 個）はすべてディスパッチャー経由で実行します：

cachly_tool(tool: "team_roster")                  run any of them by name
cachly_tool(tool: "team_roster", describe: true)  get its schema first

利用できないツールはありません。サーバーは名前でディスパッチするため、team_roster を直接呼び出しても動作します。すべての 124 個を一覧表示するには、CACHLY_ALLE_WERKZEUGE=1 を設定してください。8 個と cachly_tool を一覧表示するには CACHLY_PROFILE=lean を、読み取り専用ツール 3 個を一覧表示するには CACHLY_PROFILE=recall を設定してください。

セッションと教訓（最もよく使うツール）

チームブレインと組織のナレッジグラフ

因果インテリジェンス

例：

causal_trace(problem="auth breaks after restart")

→ Root: k8s:namespace-terminating
→ Via:  keycloak:jwks-race
→ Fix:  PollUntilContextTimeout 3min

共有可能なパブリックBrain

ナレッジコモンズ、インフラストラクチャ、ロードマップ

healthを実行すると、エディターで何が連携されているかを確認できます。完全なカタログは src/tools.tsから生成されます。

CLI コマンド

npx @cachly-dev/mcp-server@latest autopilot # One command: signs in, configures every editor, fills the Brain from git

以下のすべてのコマンドは、npx @cachly-dev/mcp-server@latest <command> として実行します。キーと Brain インスタンスは環境変数、または autopilot が書き込む ~/.cachly/credentials.json ファイルから取得されます。

bench の手法については、BENCH.md で説明しています。

ヒント：マージされたすべての PR から学習できます。 CI で learn-git を実行するには、 cachly-brain-setup GitHub Action と mode: learn を使用してください。マージされた PR から Brain が学習します。

CI 連携

CI の実行はすべて学びになります。赤から緑への遷移は実証済みの修正であり、緑から赤への遷移は既知の原因です。すぐに貼り付けて使えるテンプレートは src/ci-integration/ にあります。

• GitHub Actions： cachly-dev/cachly-action を使用してください。 シークレット CACHLY_API_KEY と CACHLY_BRAIN_INSTANCE_ID が必要です。
• GitLab CI： include: remote: を使って GitLab テンプレート を取り込みます。learn、scan、confirm、hygiene 用の非表示ジョブが追加されるため、必要なものを拡張してください。
• その他： push-ci-outcome.mjs は、依存関係のないスタンドアロンの Node.js ヘルパーです。常に 0 で終了するため、Brain へのプッシュが原因で CI が失敗することはありません。

CI の履歴がすでに数か月分ありますか？brain_from_ci ツールは過去の結果を一度の呼び出しで取り込みます。brain_from_git がコミットを取り込むのと同じ方法です。

FAQ

AI が session_start を手動で呼び出す必要はありますか？ いいえ。最初のツール呼び出しでセッションが開始され、エディターを閉じると終了します。

チーム全体で 1 つの Brain を共有できますか？ はい。team_learn と team_recall を使うか、 npx @cachly-dev/mcp-server@latest invite [email protected] を実行してください。

コードは cachly のサーバーに送信されますか？ ご自身で index_project を呼び出した場合に限られます。インデックス化されたファイルごとに短い抜粋（デフォルトで最大 summary_chars の 1200 文字）が、ご自身の EU インスタンスに保存されます。 その他のツールが保存するのは、レッスンのテキスト、コミットメッセージ、セッションの要約、キーと値のコンテキストであり、ソースコードは保存されません。データはドイツに保存され、埋め込みの計算は EU 内で行われます。 API 通信は米国企業である Cloudflare を経由します。 EU ガイドに、すべてのデータフローが記載されています。

causal_trace とは何ですか？ エラーを受け取ると、因果関係のナレッジグラフをたどり、根本原因、中間原因、そして有効だった修正を、その日付やコマンドとともに見つけます。

セッション中にコンテキストウィンドウの上限に達した場合はどうすればよいですか？ compact_recover を呼び出してください。Crystal、最近のセッション、進行中の作業のレジストリからコンテキストを再構築します。通常はツールを 1 回呼び出せば十分です。

エージェントが見つけたレッスンを再び書き込むにはどうすればよいですか？ 決め手となる事実から始めてください。 レッスンガイドでは、例を交えて方法を説明しています。

エディターの対応状況

npx @cachly-dev/mcp-server@latest autopilot は、以下のエディターを検出して設定します。 手動での設定例は手動セットアップを参照してください。

各ケースで使用するサインイン方法：

手動セットアップ

{
  "mcpServers": {
    "cachly": {
      "command": "npx",
      "args": ["-y", "@cachly-dev/mcp-server@latest"]
    }
  }
}

{
  "mcpServers": {
    "cachly": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cachly-dev/mcp-server@latest"]
    }
  }
}

{
  "context_servers": {
    "cachly": {
      "command": {
        "path": "npx",
        "args": ["-y", "@cachly-dev/mcp-server@latest"]
      }
    }
  }
}

埋め込みモデルは、意味に基づく検索のためにテキストをベクトルに変換します。デフォルトでは、サインインするとすぐに、cachly が EU 内の自社サーバーで埋め込みを計算します。テキストがサードパーティーのプロバイダーに送信されるのは、そのプロバイダーを自分で指定した場合のみです。

npx @cachly-dev/mcp-server@latest health を実行すると、現在有効なプロバイダーを確認できます。

独自のバックエンドを指定できます。 すべてのインストールで、api.cachly.dev の代わりにプライベートバックエンドを利用できます。

# One command: run the setup against your self-hosted backend
npx @cachly-dev/mcp-server@latest autopilot --api-url https://cachly.mycorp.internal

# Or without prompts
npx @cachly-dev/mcp-server@latest autosetup \
  --instance-id <uuid> --api-key <cky_live_...> \
  --api-url https://cachly.mycorp.internal

autosetup は、デフォルトのクラウドと異なる場合にのみ CACHLY_API_URL をエディターの設定に書き込みます。デフォルトのインストールでは設定は追加されず、セルフホストのインストールではエディターの起動ごとに独自のバックエンドに接続します。

料金

現在の料金と利用上限は、cachly.dev/pricing をご覧ください。

無料プランではクレジットカードは不要です。

環境変数

エコシステムとドキュメント

VS Code 拡張機能では、エディター内で同じ Brain を利用できます。

• cachly.dev：ダッシュボードと登録
• ドキュメント
• MCP ドキュメント
• リリースノート
• GitHub Issues：バグと機能リクエスト

一度解決すれば、その後は AI が覚えています。

npx @cachly-dev/mcp-server@latest autopilot