peers-mcp入門!Claude Code間で通信・協調動作させる実践法

当ページのリンクには広告が含まれています。
peers-mcp入門!Claude Code間で通信・協調動作させる実践法
IT女子 アラ美IT女子 アラ美
🚀 AIエージェント設計スキルで年収を上げなさい!
マルチエージェント実装の経験はハイクラス転職で高く評価されるわよ
自分らしく働けるエンジニア転職を目指すなら【strategy career】
この記事の結論
peers-mcpを使えば、同一PC上の複数のClaude Codeインスタンスが互いにメッセージを送受信できます。フロントエンド担当とバックエンド担当のように役割分担させることで、並行開発の効率が大幅に向上します。

お疲れ様です!IT業界で働くアライグマです!

「Claude Codeで大きなプロジェクトを扱うと、コンテキストが膨らんで精度が落ちる」「フロントとバックを同時に修正したいけど、1つのセッションでは限界がある」。こうした悩みに対する解決策が、peers-mcpです。

私たちエンジニアは、つい1つのセッションに何でも任せようとしがちです。でも、役割ごとにセッションを分けて会話させたほうが、一つひとつの作業は整理され、精度も保ちやすくなります。このMCPサーバーを導入すると、複数のClaude Codeセッションが互いに会話できるようになります。本記事では、peers-mcpのセットアップから、マルチエージェント協調パターンの実装まで、実践的に解説します。

目次

複数のClaude Codeをつなぐpeers-mcpの仕組み

IT女子 アラ美IT女子 アラ美
💡 AI開発を独学で消耗してるの?体系的に学びなさい!
プログラミング・AI・DXまで300以上の講座を個人レッスンで習得できるわよ
資格と仕事に強い!個人レッスンのプログラミングスクール【Winスクール】

peers-mcpは、同一マシン上で動作する複数のClaude Codeインスタンスが、MCPプロトコルを通じてメッセージを送受信できるようにするMCPサーバーです。

従来のマルチエージェントシステム(CrewAIやLangChain Agent)とは根本的に異なります。従来型はPythonコードで明示的にエージェントを定義し、タスクを割り当てる設計です。一方peers-mcpでは、各Claude Codeセッションが独立したエージェントとして振る舞い、必要に応じて他のセッションに作業を依頼できます。

つまり、ターミナルを2つ開いてそれぞれでClaude Codeを起動するだけで、マルチエージェント環境が完成します。片方に「フロントエンドを担当して」、もう片方に「バックエンドを担当して」と指示すれば、互いにAPIの仕様を確認しながら並行開発を進められるのです。

プロジェクト知識をCLAUDE.mdで共有しておき、これと組み合わせると各エージェントがプロジェクトのコンテキストを持った状態で協調できます。

IT女子 アラ美IT女子 アラ美
ターミナル2つ開くだけでマルチエージェントって、セットアップの手軽さが半端ないね。

ITアライグマITアライグマ
CrewAIでエージェント定義を書いていた頃が懐かしくなりますよね。設定ファイル1つで済みます。

前提条件と環境準備

新しいツールを試すとき、私たちはつい「また環境構築か……」と身構えてしまいます。でも今回は大丈夫です。peers-mcpの前提条件は、次の3つだけです。

必要な環境

用意するものは多くありません。まずMCPサーバーに対応した Claude Code 2.0.73以上が必要です。次に、peers-mcpをnpxで動かすためにNode.js 18以上を入れておきます。そして、Pro・Max・Teams・Enterpriseのいずれかの有料プランに入っていれば準備は整います。普段からClaude Codeを使っている方なら、ほとんど揃っているのではないでしょうか。

確認コマンド

# Claude Codeのバージョン確認
claude --version
# 出力例: 2.1.50 (Claude Code)

# Node.jsのバージョン確認
node --version
# 出力例: v20.11.0

Claude Codeのバージョンが古い場合は、npm update -g @anthropic-ai/claude-code でアップデートしてください。

IT女子 アラ美IT女子 アラ美
Node.jsのバージョン確認って地味に忘れるのよね。nvm使ってると「どのバージョンだっけ?」ってなる。

ITアライグマITアライグマ
あるあるですね。peers-mcpはNode.js 18以上なら問題ないので、nvmで切り替えておきましょう。

peers-mcpのセットアップと基本的な使い方

セットアップは拍子抜けするほど簡単です。プロジェクトの.mcp.jsonに設定を足すだけで、インストール作業はありません。

.mcp.jsonへの設定追加

プロジェクトルートの.mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "peers": {
      "command": "npx",
      "args": ["-y", "claude-peers-mcp"]
    }
  }
}

設定はこれだけです。npmで事前にインストールする必要もなく、npxが初回起動時にパッケージを取得して実行してくれます。

複数セッションの起動

ターミナルを2つ開き、同じプロジェクトディレクトリでClaude Codeを起動します。

# ターミナル1(フロントエンド担当)
cd /path/to/project
claude

# ターミナル2(バックエンド担当)
cd /path/to/project
claude

各セッションが起動すると、peers-mcpが自動的に他のセッションを検出します。

エージェント間メッセージの送信

ターミナル1のClaude Codeに対して、以下のように指示します。

「バックエンド担当のセッションに、ユーザー一覧APIのレスポンス形式を確認してください」

Claude Codeは@peersツールを使って他のセッションにメッセージを送信し、回答を受け取ります。人間が手動でコピペしていたコンテキスト共有が、自動化されるのです。

この設計パターンはCLI-AnythingでAgent-Native開発の考え方と同様に、AIがソフトウェア間の橋渡しを行うアプローチです。

IT女子 アラ美IT女子 アラ美
コンテキストのコピペ地獄から解放されるのは本当にありがたい。片方で変更→もう片方に伝える、が自動って。

ITアライグマITアライグマ
手動でやると絶対に伝え漏れが発生しますからね。peers-mcpなら聞けば教えてくれます。

マルチエージェント協調パターンの実装

実際の開発でよく使う協調パターンを3つ、順番に紹介します。各セッションに役割やゴールを明確に与える書き方は、Claude Codeを思考パートナーに育てるプロンプト術でも詳しく整理していますので、あわせて参考にしてみてください。

フロントエンド+バックエンドの並行開発

まずは一番基本的な使い方から始めましょう。2つのセッションにそれぞれ「フロントエンド」「バックエンド」の役割を与え、API仕様を互いに確認しながら開発を進めます。

# ターミナル1への指示
あなたはフロントエンド担当です。
React + TypeScriptでユーザー管理画面を実装してください。
APIの仕様はバックエンド担当のセッションに確認してください。

# ターミナル2への指示
あなたはバックエンド担当です。
FastAPIでユーザー管理APIを実装してください。
フロントエンド担当から仕様の問い合わせが来たら回答してください。

この構成では、フロントエンド側がAPIのリクエスト/レスポンス形式を聞き、バックエンド側が「現在の実装はこうなっています」と回答する流れが自動で発生します。

実装者+レビュアーの協調

自分で書いたコードのレビューは、どうしても見落としが出ます。そこで、片方のセッションに実装を、もう片方にレビューを任せてみましょう。実装が終わるとレビュアーに通知が届き、指摘を受けて修正する、という流れまで自動でつながります。

調査+実装の分離

新しいライブラリを使うとき、調べものだけで実装のコンテキストが埋まってしまうことはありませんか。そんなときは、ドキュメントの読み込みやベストプラクティスの確認を1つのセッションに任せ、その結果をもとに別のセッションが実装する構成が向いています。Ollama×CrewAIのマルチエージェント構成で実現していた役割分担を、Claude Code同士でより自然に実現できます。

IT女子 アラ美IT女子 アラ美
レビュアーパターン面白いね。セルフレビューだと見落としがちだけど、別セッションなら客観的に見てくれそう。

ITアライグマITアライグマ
実装者のコンテキストに引きずられないので、本当に第三者レビューに近い品質になりますよ。

2つのClaude Codeでフロントとバックを分担する進め方の例

IT女子 アラ美IT女子 アラ美
💡 マルチエージェント設計を主導できる環境で働きなさい!
社内SEなら自社のAI基盤を設計する裁量を持てるわよ
社内SEを目指す方必見!IT・Webエンジニアの転職なら【社内SE転職ナビ】

React + FastAPIで社内向けダッシュボードのMVPを1人で作る場面を例に、peers-mcpで2つのClaude Codeに分担させる流れを整理します。

よくある状態

フロントもバックも1つのClaude Codeセッションで進めていると、行き来するうちにコンテキストウィンドウが埋まり、後半になるほど出力の精度が落ちやすくなります。APIの仕様を変えるたびに、フロント側へ説明し直す手間もかかります。

分担のさせ方

  1. .mcp.jsonにpeers-mcpの設定を足します
  2. ターミナル1を「フロントエンド担当(React + TypeScript)」、ターミナル2を「バックエンド担当(FastAPI + SQLAlchemy)」として起動します
  3. フロント側がAPIを呼ぶコードを書くときは、バックエンド側に「このエンドポイントのレスポンス形式を教えて」と確認させます
  4. コーディング規約や命名規則をCLAUDE.mdに書き、両方のセッションに同じルールを持たせます

効果を確かめる

1つのセッションで進めたときと比べて、MVPができるまでの日数、手戻りの回数、APIの仕様の食い違いが見つかった件数を記録します。CLAUDE.mdで先にルールを共有しておくと、2つのエージェントの出力がそろいやすくなります。

MCPを通じたエージェント間連携はAnthropic Financial ServicesのMCPプラグイン設計でも実装パターンとして解説されています。

IT女子 アラ美IT女子 アラ美
フロントとバックで担当を分ければ、1人開発でも説明し直す手間が減りそうね。

ITアライグマITアライグマ
CLAUDE.mdとの組み合わせがポイントです。ルールなしでやると、エージェント同士が噛み合わないことがあります。

さらなる実践・活用に向けて

最初は2セッションで十分ですが、基本の構成に慣れてきたら、次はもう一歩踏み込んだ使い方を試してみたくなりますよね。ここでは、実際に効果が出やすい2つの発展パターンを紹介します。

3エージェント以上の協調

peers-mcpは2セッションに限定されません。3つ以上のセッションを立ち上げて、それぞれに別の役割を持たせることもできます。例えば「フロントエンド」「バックエンド」「テスト」の3セッション構成にすれば、実装と同時にテストコードが自動生成される環境を構築できます。

ただし、セッション数が増えるとAPI消費量も増加します。実用的には2〜3セッションが最もコストパフォーマンスが高い構成です。

CI/CDとの連携

peers-mcpで開発したコードをGitHub Actionsで自動テスト・デプロイする構成も有効です。peers-mcpの「レビュアーパターン」でレビュー済みのコードのみをpushする運用にすれば、CIの通過率が向上します。

claude code peersで相手のセッションが見えないときの確認ポイント

「claude code peers」を試したのに、相手のセッションが一覧に出てこない。そんなときは、次の順番で確認すると原因を絞り込みやすくなります。

まず、.mcp.json が両方のセッションを起動したプロジェクトのルートに置かれているかを見てください。次に、設定を追加した後でClaude Codeを再起動したかを確認します。MCPサーバーは起動時に読み込まれるため、再起動しないと反映されません。さらに、2つのセッションが同じPC上で動いているかも確かめてください。注意点にあるとおり、peers-mcpは同一マシン内の通信に限られます。

それでも解消しないときは、ターミナルで npx -y claude-peers-mcp を直接実行して、エラーメッセージが出ないかを見てみましょう。Node.jsのバージョンが古い場合は、ここでエラーが表示されます。

注意点と制約

便利な仕組みですが、私たちが使うときには押さえておきたい制約が3つあります。1つ目は、peers-mcpが同一PC上のセッション間通信にしか対応していないことです。リモートのマシン同士をつなぐことはできません。2つ目はコストで、各セッションがそれぞれAPIを消費するため、Maxプラン(月額200ドル)が推奨です。3つ目は競合で、2つのセッションが同じファイルを同時に編集すると衝突することがあります。CLAUDE.mdで「担当ディレクトリ」をはっきり決めておくのが、いちばん確実な対策です。

AIスキルを活かしたキャリア設計については社内SE転職エージェント3社比較も参考にしてください。マルチエージェント設計を主導できるスキルは、AI基盤を自社で構築する社内SEポジションで高く評価されます。年収アップを目指すならハイクラスエンジニア転職エージェント3社比較、独立してAI案件を取りたい方はフリーランスエージェント5社比較も合わせてチェックしてみてください。

IT女子 アラ美IT女子 アラ美
3セッション以上はコスト的に厳しそうね。2セッションで役割を明確にするのが現実的か。

ITアライグマITアライグマ
2セッション+CLAUDE.mdの役割定義が最もコスパの良い構成です。まずはここから始めましょう。

よくある質問

peers-mcpは無料で使えますか?

peers-mcp自体はオープンソースなので無料です。ただ、Claude Codeの有料プラン(Pro以上)が必要です。各セッションがAPIを消費するため、Maxプラン(月額200ドル)が現実的です。

CrewAIやLangChain Agentとの違いは何ですか?

CrewAIやLangChain AgentはPythonコードでエージェントを定義するプログラマブルなアプローチです。peers-mcpはClaude Codeのセッション同士を接続するだけで、コードを書かずにマルチエージェント環境を構築できます。手軽さと柔軟性ではpeers-mcpが優位です。

3つ以上のセッションを同時に使えますか?

はい、技術的な制限はありません。ただ、セッション数に比例してAPIコストが増加するため、2〜3セッションが実用的な上限です。セッション数よりも各セッションの役割設計(CLAUDE.mdでの指示)の方が成果に影響します。

AI開発スキルを体系的に身につけたい方は、以下の比較表を参考にしてください。

本記事で解説したようなAI技術を、基礎から体系的に身につけたい方は、以下のスクールも検討してみてください。

比較項目 Winスクール Aidemy Premium
目的・ゴール 資格取得・スキルアップ初心者〜社会人向け エンジニア転身・E資格Python/AI開発
難易度 初心者◎個人レッスン形式 中級者〜コード記述あり
補助金・給付金 最大70%還元教育訓練給付金対象 最大70%還元教育訓練給付金対象
おすすめ度 S幅広くITスキルを学ぶなら AAIエンジニアになるなら
公式サイト 詳細を見る −
IT女子 アラ美IT女子 アラ美
AIスキルを身につけたいけど、どのスクールを選べばいいかわからないです…
ITアライグマITアライグマ
現場で即・ITスキルを身につけたいならWinスクールがおすすめです!個人レッスン形式で初心者でも取り組みやすいですよ。

まとめ

私たちが最初につまずくのは、たいてい難しい理論ではなく、最初の一歩の踏み出し方です。ここまで読んで、「結局、何から始めればいいの?」と思った方もいるかもしれません。答えはシンプルで、.mcp.jsonに3行追加して、ターミナルを2つ開くことです。5分もあれば、Claude Code同士が会話する環境ができあがります。

協調のさせ方は、フロントとバックの並行開発、実装者とレビュアーの分担、調査と実装の分離の3パターンから選べば十分です。うまくいかせるコツは、先にCLAUDE.mdでプロジェクトのルールを共有しておくことです。

まずはターミナルを2つ開いて、簡単なタスクでpeers-mcpを試してみてください。「こんなに楽にマルチエージェントできるのか」と驚くはずです。

IT女子 アラ美IT女子 アラ美
週末に個人開発で試してみるわ。フロントとバックを分けるところから始めてみよう。

ITアライグマITアライグマ
まずは小さなプロジェクトで体感するのが一番です。CLAUDE.mdの設計から始めてみてください。

この記事をシェアする
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ITアライグマのアバター ITアライグマ ITエンジニア / PM

都内の事業会社で働くPM兼Webエンジニアです(IT業界10年以上、既婚・子持ち)。
スマホや決済アプリ、Wi-Fi、スマートスピーカーなど、身近なITの「困った」を、公式のヘルプやサポート情報で確かめたうえで、原因の切り分けから直し方までまとめています。設定で直らないときは、回線やサービスの見直しも含めて紹介しています。

目次