MCP セットアップ: Merlin Project と Claude Code をつなぐ

Claude Desktop は計画への質問にチャット画面で答えます。その回答を先へ渡したくなったとき、たとえば毎週金曜にファイルとして用意しておくステータスレポートにしたいときは、コマンドラインから動くクライアントが必要です。Claude Code がそのクライアントです。Claude Desktop と同じ MCP サーバーと話しますが、回答はターミナルにテキストとして出ます。テキストならリダイレクトでき、他へ渡せ、決まった時刻に生成できます。ここでは接続コマンド、確認の手順、そしてチャット画面なしでレポートを生む呼び出しを紹介します。

この記事の動画

動画(ドイツ語)は 本記事のドイツ語版 に埋め込まれています。

必要なもの

  • 最新バージョンの Merlin Project、MCP サーバーがインストール済み、プロジェクトが共有済み(手順は Claude Desktop の記事のステップ1と2)
  • Claude Code、インストール済みで 一度起動してログイン済み

Merlin 側の共有は、ほかのどのクライアントでも同じクリック1回です。

クリック1回でそのプロジェクトだけを共有します。ツールバーの AI Tools から AI ツールによるドキュメントの操作を許可 をオンにします。ほかのプロジェクトはサーバーから見えないままです。

2つ目が最も多い失敗です。Claude Code をインストールしただけで一度も起動していないと、接続コマンドは空振りします。一度 Claude Code を起動し、ログインして、また終了してください。

ステップ1: Claude Code にサーバーを教える

ターミナルを開き、次のコマンドを入力します。

接続する Terminal

claude mcp add --transport stdio merlin-project -- /usr/local/bin/merlinproject-mcp

このコマンドは3つのことを伝えています。merlin-project という名前のサーバーを登録すること、stdio 経由で話しかけること、そのためにダブルハイフンの後ろにあるプログラムを起動すること。途中の -- は、Claude Code 向けのオプションと Merlin サーバーの起動コマンドを分けます。後ろはすべてサーバーのものです。Claude Code は「Added stdio MCP server merlin-project」と応じます。

ステップ2: 登録を確認する

登録がきれいに通ったかは、2つ目のコマンドでわかります。

確認する Terminal

claude mcp get merlin-project

出力には名前、トランスポート(stdio)、パスが並びます。3つとも合っていれば、サーバーは登録済みです。接続が実際に通るかどうかは、本物の質問を投げて初めてわかります。

最初の質問: どのアクティビティが遅れそうか

claude で Claude Code を起動し、動画と同じ質問を投げます。

プロンプト: 遅れそうなアクティビティはどれですか?

現在の計画にもとづいて、アクティブなプロジェクトで予定より遅れる恐れのあるアクティビティをすべて特定してください。進捗、残りの期間、依存関係を確認してください。アクティビティごとに、見込まれる遅延の日数、影響を受ける後続アクティビティ、プロジェクトの終了日が危うくなるかどうかを示してください。

プロンプトライブラリで開く ›

Claude Code が Merlin サーバーを呼び出し、共有されたプロジェクトの実データで表を返します。最初の呼び出しのとき、Claude Code はツールを使ってよいか尋ねます。承認してください。

なぜターミナルなのか: 回答をファイルへ

ここまではチャット画面でもできたことです。違いはここからです。回答はテキストであり、ターミナルのテキストはさらに加工でき、ファイルに書き込め、スクリプトに渡せます。同じ依頼をチャット画面なしで、コマンドラインから直接実行し、回答をファイルへリダイレクトします。

チャット画面なし、回答をファイルへ Terminal

claude -p "List all tasks of the active project that are at risk of slipping, as a table with task, planned finish and responsible resource." > at-risk.md

-p はプリントモードを表します。Claude Code は依頼を実行し、回答を出力して終了します。> は出力をファイル at-risk.md へ向けます。開けば、表がそこにあります。

金曜のレポートまであと1歩です。コマンドラインから動くものは、Mac が決まった時刻にひとりで起動できます。たとえば launch agent やカレンダーによる自動実行です。金曜16時、誰も打ち込まないうちにレポートが置かれています。そのレポートがどんな姿で、ほかに何を含むべきかは、自動の週次レポートを扱う別の動画で取り上げます。

サーバーを削除する

登録をやめたくなったときは、次のとおりです。

削除する Terminal

claude mcp remove merlin-project

接続がうまくいかないとき

  • 「Claude Code not found」と出る場合。 Claude Code が未インストールか、ターミナルがパスを知りません。インストールを確認し、ターミナルを開き直してください。
  • コマンドは通るのに計画からの回答がない場合。 Claude Code をまだ一度も起動・ログインしていないか、Merlin でプロジェクトが共有されていません。
  • パスが違う場合。 Merlin Project のインストーラーがパスを表示します。claude mcp get merlin-project と見比べ、食い違うなら削除して登録し直してください。

早見表

練習にはサンプルプロジェクト Produktlaunch Phoenix が向いています。レポートをチャット画面で読みたい方は Claude Desktop を、ターミナルでの OpenAI 版は Codex をご覧ください。すべての手順はこちらです。

このブログ記事についてご質問やご意見がございましたら、ぜひフォーラムへのご投稿をお待ちしております。

プロジェクトを計画する、 本当に機能する形で。

プロジェクト計画のためのひとつのアプリ。すべての Apple デバイスでネイティブに動作します。