結論から言うと、Claude Codeの「毎回忘れる」問題はMCPツールで解決できる。標準のMEMORY.mdには200行の制限があり、プロジェクトが育つほど破綻する。MCPで記憶を外部化すれば、検索・矛盾検出・セッション引き継ぎまでカバーできる。
Claude Codeを使っていて、こんな経験はないだろうか。
・新しいセッションを開くたびに同じプロジェクト構成を説明している
・「前回こう決めたよね？」が通じない
・MEMORY.mdに何を書けばいいのか、そもそも分からない
・書いたはずの情報が多すぎて、逆にノイズになっている
ここで止まっている人ほど見てほしい。MCPという仕組みで、Claude Codeの「記憶力」は根本から変えられる。
MEMORY.mdの200行制限——Claude Codeの記憶はテキストファイル1枚
Claude Codeにはセッション間で情報を引き継ぐ仕組みとして、MEMORY.mdというファイルがある。プロジェクトのルートに置いておくと、次のセッション開始時に自動で読み込まれる。
一見便利だが、壁がある。
200行の上限。 小さなプロジェクトなら余裕だが、設計方針・コーディング規約・API仕様・運用ルールが増えていくと、あっという間に埋まる。何を残して何を削るか、人間が毎回判断しなければならない。
検索機能がない。 MEMORY.mdは単なるテキストファイルだ。Claude Codeはセッション開始時にこのファイルを丸ごとコンテキストに流し込むだけで、「この情報だけ引いてきて」はできない。100行のメモも5行のメモも、同じだけトークンを消費する。これ、地味にコスト効率が悪い。
矛盾の検出がない。 3ヶ月前に書いた設計方針と、先週変更した方針が同居していても、Claude Codeはどちらが正しいか判断できない。古い情報を消し忘れるのは人間の常だ。でもAIはそれを「矛盾」とは認識してくれない。
マルチエージェントでファイル競合が起きる。 複数のサブエージェントが同時にMEMORY.mdを更新しようとすると、片方の変更が消える。Claude Codeでサブエージェントを並列に走らせる使い方をしている人には、現実的に発生する問題だ。
200行で足りるうちはMEMORY.mdで十分。でもその「足りなくなる瞬間」は、思ったより早く来る。自分の場合、プロジェクト開始2週間くらいだった。早すぎない？
MCPで「外付け脳」を渡すという発想
MCP（Model Context Protocol）は、AIツールの能力を外部から拡張するための標準規格だ。
噛み砕くと、「AIが使える道具箱を、外から追加できる仕組み」。
Claude Codeは標準でMCPに対応している。JSON形式の設定ファイルにMCPサーバーの情報を登録するだけで、Claude Codeが使えるツールが増える。データベース検索、外部API連携、ファイル操作——基本的に何でもMCP経由で追加できる。
この仕組みを「記憶」に応用するのが、今回の話の核心だ。
MEMORY.mdがClaude Codeの「脳内メモ」だとすれば、MCP記憶サーバーは「外付けの書庫」のようなもの。容量を気にせず書き込めて、必要な時に必要な情報だけ検索で引ける。複数のエージェントから同時にアクセスしても壊れない。
MCPの面白いところは、AIが自分で判断してツールを使う点だ。人間が「この記憶を検索して」と毎回指示するのではなく、Claude Code自身が「このタスクに関連する過去の記憶があるはずだ」と判断して、MCPツールを呼び出す。覚えるのも思い出すのも、AI側が主体的にやる。
人間が管理するテキストファイルから、AIが自律的に使う記憶システムへ。この転換が、MCPの本質的な価値だと思う。
BrainDBの51ツール——記憶を「管理」から「運用」に変える
BrainDBは、Claude Code向けのMCP記憶サーバーとしてGitHubで公開されているオープンソースプロジェクトだ。TypeScript製、AGPL-3.0ライセンス。
51個のMCPツールを提供しており、6つのカテゴリに分かれている。
Memory（15ツール）
remember、recall、forget、decideなど。基本的な記憶の読み書きに加え、「この決定は権威的な情報として扱う」というdecide機能がある。新しい情報が古い記憶と矛盾した場合、decideで保存された方が優先される。MEMORY.mdにはない「記憶の重み付け」ができる。
Search（5ツール）
FTS5（SQLiteの全文検索エンジン）とembeddings（ベクトル検索、つまり意味的な類似度で検索する仕組み）を組み合わせたハイブリッド検索。「キーワード一致」だけでなく「意味が近い記憶」も引ける。MEMORY.mdの「全文丸読み」とは根本的に違うアプローチだ。
Agents（8ツール）
heartbeat、claim、release、handoverなど。マルチエージェント環境のためのセッション管理ツール群。作業中のリソースを「確保」し、終わったら「解放」する。セッション終了時には「引き継ぎ」で次のセッションに文脈を渡せる。これがあると、サブエージェント同士がお互いの作業を壊さない。
Graph（10ツール）
エンティティ（概念や事実）同士の関係をグラフ構造で管理する。矛盾検出もここ。「AはBである」と「AはCである」が矛盾する場合、自動でフラグが立つ。人間が手動で探す必要がない。
System（8ツール）
ヘルスチェック、統計情報、バックアップなどの管理系。地味だが運用には欠かせない。
Inception（5ツール）
dream、decay、inception findingsなど。夜間に記憶を自動で検証・整理する機能が含まれる。Webソースと照合して事実確認を行う「Nightly Self-Learning」は、ハルシネーション対策として面白い発想だ。AIが自分の記憶を自分で事実確認する。
51個と聞くと「多すぎない？」と思うかもしれない。でもClaude Codeが自分で必要なツールを選んで使うので、人間が51個を覚える必要はない。むしろ選択肢が多いほど、AIが状況に応じた最適な行動を取りやすくなる。
どちらを選ぶべきか——MEMORY.mdとMCP記憶の使い分け
正直に言えば、全員がMCP記憶サーバーを導入すべきとは思わない。
MEMORY.mdで十分なケース：
- プロジェクトが小規模で、覚えておくルールが20〜30行で収まる
- 1人で開発していて、サブエージェントは使わない
- セットアップの手間を限りなくゼロにしたい
MCP記憶サーバーが効くケース：
- MEMORY.mdの200行では足りなくなった
- サブエージェントやマルチエージェント構成で開発している
- セッションをまたいで正確に文脈を引き継ぎたい
- 記憶の検索・矛盾検出を手動で管理するのが限界
分岐点は「MEMORY.mdの管理コストが気になり始めた時」だ。まだ気にならないなら、無理に導入する必要はない。
BrainDBの場合、セットアップにはbun（JavaScriptランタイム）のインストール、環境変数の設定、Claude CodeのMCPサーバー登録が必要になる。Claude Codeの設定ファイル（JSON）を触ったことがない人は少し戸惑うかもしれないが、公式リポジトリの手順に従えば数分で終わる作業だ。
自分の場合、Claude Codeの記憶管理にはMCPツールを導入して運用している。毎回同じ説明を繰り返す手間がなくなったのは、体感としてかなりでかい。セッションを開いた瞬間、前回の文脈が引き継がれている。設定して、セッション開いて、試して……覚えてる。あの瞬間の「おお」は忘れられない。
プロジェクトの規模が大きくなるほど、200行じゃ足りないって痛感する。逆に言えば、小さいプロジェクトでMEMORY.mdを使い倒してから移行しても全く遅くない。
まとめ
- Claude Code標準のMEMORY.mdは200行制限・検索なし・矛盾検出なしという制約がある
- MCPで記憶を外部化すれば、容量無制限・ハイブリッド検索・マルチエージェント対応が手に入る
- BrainDBは51個のMCPツールでこの問題に取り組むオープンソースプロジェクト。プロジェクトが大きい人ほど恩恵を感じるはず
Claude Codeは使い方次第で開発のパートナーになれる。でも「毎回忘れるパートナー」だと、信頼関係は築けない。記憶の問題を解決することが、Claude Codeとの付き合い方を変える第一歩だと思う。すごく。
【PR】フリーランスエンジニアにおすすめのツール
ドメイン取得からサーバー管理まで一括で扱える。個人開発やブログ運営との相性がいい。
【PR】おすすめの書籍
記事の内容に関連する書籍を紹介させてほしい。
「オブジェクト設計スタイルガイド」は、設計で迷ったときに立ち返れる一冊。保守性の高いコードを書きたい人に。
AI時代のプロライティング術: ChatGPT・Claude・Geminiで「読まれる文章」を量産する AIツール活用ガイド
「AI時代のプロライティング術: ChatGPT・Claude・Geminiで「読まれる文章」を量産する AIツール活用ガイド」は、AIの仕組みと実践的な活用法を学べる一冊。技術の裏側を知ると使い方が変わる。
コメント