いまプロジェクトについて AI に質問しようとすると、計画をエクスポートしてファイルをアップロードすることになります。翌週には計画が変わり、また最初からやり直しです。そこで Merlin Project は MCP サーバーを同梱しました。Mac 上で動く小さなプログラムで、AI クライアントはコピーではなく開いている計画そのものを直接読みます。Claude Desktop はそこへ至るいちばん手軽な道です。設定ファイルにブロックを1つ書き加えるだけで済みます。この記事では、サーバーのインストールから計画への最初の質問まで、3つのステップを順に追います。
この記事の動画
動画（ドイツ語）は 本記事のドイツ語版 に埋め込まれています。サンプルプロジェクト「Produktlaunch Phoenix」を使って設定手順をたどります。5つのフェーズ、20あまりのアクティビティ、8つのリソースからなる小規模な製品ローンチです。最後に Claude が計画へ到達済みのマイルストーンと次の日程を尋ね、その答えは Merlin でいま開かれているプロジェクトから返ってきます。以下の手順だけでも完結します。
必要なもの
- 最新バージョンの Merlin Project
- Mac 版 Claude Desktop、無料の Claude アカウントで十分です
- Claude が読んでよい、開いた状態のプロジェクト
これだけです。ターミナルも Node パッケージも要らず、30分のドキュメント読解も要りません。MCP は Model Context Protocol の略で、いまや主要な AI プロバイダーがこぞって対応するオープンな標準です。AI クライアントがプログラムの用意するツールをどう呼び出すか、ここでは Merlin サーバーの読み取り用の問い合わせをどう呼び出すかを定めています。
ステップ1と2: Merlin Project を準備する
- サーバーをインストールします。 Merlin Project の Merlin Project メニューから Install MCP Server を選びます。Merlin が小さなプログラムを Mac に置きます。AI クライアントと計画をつなぐ橋です。パスはインストーラーが表示します。
/usr/local/bin/merlinproject-mcpです。 - プロジェクトを共有します。 プロジェクトを開き、ツールバーの AI Tools をクリックします。AI ツールによるドキュメントの操作を許可 にチェックを入れると、アイコンが塗りつぶされて表示されます。共有はそのプロジェクト1つだけに適用され、ほかのプロジェクトはサーバーから見えないままです。クライアントが接続すると、アイコンは青に変わります。
ローカル · 読み取り専用 · 外部から到達不可。 サーバーはあなたが共有したプロジェクトしか読まず、データを一切変更せず、外部からは誰も到達できません。クラウド型のクライアントが読み取ったデータをどこまで見るかは、データ保護の記事で説明しています。
この2つのステップはどのクライアントでも同じです。あとから Claude Code、Codex、Antigravity をつなぐときには、すでに済んでいます。
ステップ3: Claude Desktop にサーバーを教える
Merlin 側の準備は整いましたが、Claude はまだそのサーバーの存在を知りません。ファイルに少しだけ手を入れるのは、この工程だけです。
- Claude Desktop で Settings を開き、Developer へ進みます。
- Edit Config をクリックします。Claude が Finder で
claude_desktop_config.jsonを指し示します。 - そのファイルをテキストエディタ、たとえば TextEdit で開きます。
- 次のブロックを貼り付けて保存します。
merlin-project の設定ブロック claude_desktop_config.json
{
"mcpServers": {
"merlin-project": {
"command": "/usr/local/bin/merlinproject-mcp"
}
}
}書き加えるだけにしてください。 すでに内容がある場合は何も削除しないでください。削除すると、設定済みの他のツールを Claude が失います。mcpServers の項目がすでにあるなら、内側の merlin-project ブロックだけを追加します。
- Claude Desktop を 完全に 終了し（Cmd+Q）、起動し直します。Claude は設定ファイルを起動時にしか読みません。
再起動後、ツールの一覧に merlin-project が現れます。これで接続は成立し、Claude が計画を初めて読んだ時点で Merlin Project の AI Tools アイコンが青に変わります。
計画への最初の質問
プロジェクトがいまどこにあるかを Claude に尋ねてみましょう。動画で使ったプロンプトはプロンプトライブラリにあり、ここから直接コピーできます。
プロンプト: プロジェクトはいまどこまで進んでいますか？
アクティブなプロジェクトの現在の状況をまとめてください。3つのステップで進めてください。まず全体の進捗と計画上の終了日、次に最近達成したマイルストーン、最後に次に控えている日程を挙げてください。計画と比べて変わった点を強調し、最も重要な10項目に絞ってください。Claude は共有されたプロジェクトからアクティビティ、マイルストーン、日程を読み取り、要約します。エクスポートもコピーも不要で、明日あなたが日程をずらせば、明日の Claude は新しい答えを返します。リソースの負荷からステークホルダー向けの報告まで、さらに多くの質問は プロンプトライブラリ にあります。
Claude がサーバーを認識しないとき
最も多い失敗は、いちばん単純なものでもあります。保存後に Claude Desktop を完全に終了していないのです。ウィンドウを閉じるだけでは足りません。Cmd+Q でアプリを終了し、起動し直してください。ほかに3つの確認点があります。
- パスの確認。 Merlin Project のインストーラーがサーバーのパスを表示します。設定ブロックの値と完全に一致している必要があります。
- JSON の確認。 カンマや波かっこが1つ欠けるだけで、Claude はファイル全体を無視します。手で打ち込まず、このページからブロックをコピーしてください。
- 共有の確認。 プロジェクトは「AI Tools」で共有されていますか。サーバーはアクセスを有効にしたプロジェクトしか読みません。共有されたプロジェクトがなければ、インストール済みのサーバーは空のリストを返します。
チェックリスト
練習用: サンプルプロジェクト
自分のプロジェクトを使わずにまず練習したい方は、動画に登場するサンプルプロジェクト Produktlaunch Phoenix をダウンロードしてください。すでに進行中で、最初のフェーズは完了しており、動画と同じようにマイルストーンと日程を Claude が見つけます。
ほかのクライアント
Claude Desktop はいちばん手軽な入り口です。エディタやターミナルで作業する方、Mac から出してはいけないデータを扱う方は、こちらに合ったガイドがあります。
- Claude Desktop （この記事）: 1ファイルに1ブロック、再起動
- LM Studio: モデルをダウンロード、1ファイルに1ブロック
- Claude Code: コマンド1つ
- Codex: コマンド1つ
- Antigravity: 1ファイルに1ブロック、完全な再起動
- ChatGPT: コピーブリッジまたはインテリジェントアシスタント
- どの AI クライアントが合うか
すべてのクライアントの完全なリファレンスは MCP ドキュメント にあります。
このブログ記事についてご質問やご意見がございましたら、ぜひフォーラムへのご投稿をお待ちしております。
