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

Codex は OpenAI のターミナルエージェントで、OpenAI のサブスクリプションをすでに持っている方にとっては Claude Code に当たる存在です。ほかの MCP クライアントと同じく、Codex は Merlin サーバーを教えるまであなたのプロジェクト計画を知りません。教えたあとは、共有されたプロジェクトからアクティビティ、日程、リソースを直接読みます。そのために必要なのはターミナルの1行だけです。この記事では、そのコマンドがどう組み立てられているか、接続をどう確認するかを説明し、最後に実際の計画データから作るステークホルダー向けの報告で締めます。

この記事の動画

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

必要なもの

• 最新バージョンの Merlin Project、MCP サーバーがインストール済み、プロジェクトが共有済み
• Codex、インストール済みでログイン済み。ログインしていないと接続コマンドは空振りします

Merlin 側はどのクライアントでも同じです。

1. サーバーをインストールします。 Merlin Project の Merlin Project メニューから Install MCP Server を選びます。Merlin が小さなプログラムを Mac に置きます。AI クライアントと計画をつなぐ橋です。パスはインストーラーが表示します。/usr/local/bin/merlinproject-mcp です。
2. プロジェクトを共有します。 プロジェクトを開き、ツールバーの AI Tools をクリックします。AI ツールによるドキュメントの操作を許可 にチェックを入れると、アイコンが塗りつぶされて表示されます。共有はそのプロジェクト1つだけに適用され、ほかのプロジェクトはサーバーから見えないままです。クライアントが接続すると、アイコンは青に変わります。

ローカル · 読み取り専用 · 外部から到達不可。 サーバーはあなたが共有したプロジェクトしか読まず、データを一切変更せず、外部からは誰も到達できません。クラウド型のクライアントが読み取ったデータをどこまで見るかは、データ保護の記事で説明しています。

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

ターミナルを開き、この1行を入力します。

接続する Terminal

codex mcp add merlin-project -- /usr/local/bin/merlinproject-mcp

この行は2つの半分に分かれます。ダブルハイフンより前は Codex への言葉です。merlin-project という名前のサーバーを覚えておけ、という指示です。後ろは、そのサーバーのために Codex が起動すべきプログラムです。Codex はサーバーを登録した旨を返します。

ステップ2: セッション内で確認する

これで登録は済みました。実行中のセッションで Codex がそれを見えているかは、Codex 自身のコマンドで確かめます。codex で起動し、次を入力します。

実行中の Codex セッションで確認する Codex

/mcp

Codex が接続済みのサーバーを並べます。その中に merlin-project があります。

最初の質問: ステークホルダー向けの報告

いよいよ本題の質問です。プロジェクトの状況を数文で、加えて到達済みのマイルストーンと次の重要な期日を、発注者へそのまま送れる形で欲しい、というものです。

プロンプト: 運営委員会にはどう報告すればよいですか？

現在のプロジェクトのデータから、運営委員会向けのステークホルダー報告を作成してください。長さは最大で半ページとし、詳しい知識のない読み手にもわかるようにしてください。構成は、全体の状況を1文で、前回の報告以降の進捗、現在のリスク、必要な判断の順にしてください。専門用語は避け、リスクごとに影響を受けるマイルストーンを挙げてください。

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

Codex は MCP 経由で計画を読み、実際の日程を使って報告を書きます。明日アクティビティがずれれば、明日の Codex が更新版を書きます。最初のツール呼び出しのとき、Codex はあなたの承認を求めます。

サーバーが現れないとき

• コマンドが見つからない場合。 Codex が未インストールか、ターミナルにパスが通っていません。インストールを確認し、ターミナルを開き直してください。
• 登録済みなのに /mcp に出ない場合。 Codex のセッションを終了して開き直してください。実行中のセッションは設定を読み直しません。
• 回答が空の場合。 Merlin で「AI Tools」からプロジェクトを共有し、パスをインストーラーと突き合わせてください。

チェックリスト

練習にはサンプルプロジェクト Produktlaunch Phoenix が向いています。ほかの報告形式は プロンプトライブラリ にあります。ターミナルにおける Claude 側の対応版は、自動レポート用の呼び出しも含めて Claude Code の記事で扱っています。すべての手順はこちらです。

• Claude Desktop: 1ファイルに1ブロック、再起動
• LM Studio: モデルをダウンロード、1ファイルに1ブロック
• Claude Code: コマンド1つ
• Codex （この記事）: コマンド1つ
• Antigravity: 1ファイルに1ブロック、完全な再起動
• ChatGPT: コピーブリッジまたはインテリジェントアシスタント
• どの AI クライアントが合うか

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