Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Agent Collaboration MCP Serverdelegate the user authentication logic to 3 parallel claude workers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Agent Collaboration MCP Server
複数のAIエージェントが協調して作業できるようにする完全自己完結型MCPサーバーです。このツールをClaude Codeなどのエージェントに使わせることで、エージェントが他のエージェントを起動・制御し、チームとして複雑なタスクを実行できます。
✨ 特徴
シンプルなアーキテクチャ: ペイン番号を直接指定する直感的な操作
複数エージェント対応: Claude CodeとGeminiの同時制御
柔軟なセッション管理: 複数プロジェクトの並行作業に対応
高度な状態管理: エージェントの実行状態をリアルタイムで監視
🎯 エージェント同士の協調作業
⚠️ 自動認証機能について
新しいエージェントの認証を自動化したい場合は、Playwright MCPが必要です。Playwright MCPがインストールされていない場合、認証は手動で行う必要があります。詳細は自動認証代行機能をご覧ください。
このMCPサーバーの主な用途は、エージェントが他のエージェントを管理することです。例えば：
ボスエージェントがタスクを分割し、複数のワーカーエージェントに割り振る
各エージェントが得意分野で作業（Claude Codeはコーディング、Geminiは画像生成）
エージェント間でメッセージを送り合い、進捗を共有
一つのエージェントが他のエージェントの作業結果を確認・統合
自動認証代行: 新しいエージェントが認証を要求された場合、既存の認証済みエージェントが自動で認証を代行
🛠️ 提供ツール
エージェントが使用できる6つのツール：
1. start_agent - エージェントの起動
指定したtmuxターゲットでAIエージェントを起動します。
target: tmuxターゲット形式（"session:window.pane"、例："multiagent:0.5"）
agentType: claude（一般的なコード開発）または gemini（画像生成タスク）
additionalArgs: 追加の引数（オプション）
2. get_agent_status - ステータス確認
取得可能なステータス
ステータス | アイコン | 説明 |
| ✅ | Claude Codeが実行中で入力待機状態 |
| 💎 | Geminiが実行中で入力待機状態 |
| 🔐 | Claude Codeが認証プロセス中 |
| 🔑 | Geminiが認証プロセス中 |
| ⚡ | Claude実行中（ESC to interrupt表示） |
| ⚫ | エージェントが停止中またはシェル状態 |
3. send_message - メッセージ送信
指定したペインにメッセージや制御文字を送信します。高度なメッセージ送信機能付き。
4. capture_screen - 画面キャプチャ
ペインの画面内容を取得します。
5. parallel_implement - 並列実装
複数のワーカーエージェントが同じタスクを並列で実装し、ボスエージェントが最良の成果物を選択・統合します。
重要: この機能はGitリポジトリ内で実行する必要があります。各ワーカーは独自のGit worktreeで作業を行います。
prompt: 実装指示（必須）
workerCount: ワーカー数（デフォルト: 3）
complexity: タスクの複雑度（simple, medium, complex）
agentType: 使用するエージェント（claude, gemini）
autoMerge: 完了後の自動マージ（デフォルト: false）
6. get_parallel_status - 並列実装状態確認
並列実装セッションの進捗状況を確認します。各ワーカーの作業状況、完了率、エラー情報などを取得できます。
📦 セットアップ
1. インストール
npm経由（推奨）:
GitHubから直接:
2. Claude Codeへの追加（推奨）
簡単な方法（CLIを使用）:
自動認証機能を使用する場合は、Playwright MCPも追加:
または、JSON設定を使用:
プロジェクトルートに
.mcp.jsonを作成：
ローカルインストールの場合：
3. tmuxセッションの準備
💡 使用例
基本的な使い方
複数セッションでの作業例
自動認証代行機能（オプション）
新しいエージェントの認証を自動化したい場合は、Playwright MCPを併用することで、既存の認証済みエージェントが新しいエージェントの認証を自動で代行できます。
マルチエージェント協調の例
緊急停止・制御
🔧 前提条件
必須
Node.js 18以上
tmux
tmuxセッション:
tmux new-session -d -s multiagent
オプション（認証自動化用）
Playwright MCP: エージェントの認証を自動化する場合に必要
🚀 高度な機能
柔軟なターゲット指定
セッション指定: 異なるプロジェクトで並行作業
ワイルドカード:
multiagent:*で全ペインを対象に直感的な番号指定:
0,1,2...のシンプルな指定
精密な状態検出
リアルタイム監視: エージェントの実行状態を即座に判定
複数状態の識別: 実行中、認証中、停止中などを正確に判別
アイコン付き表示: 視覚的に分かりやすい状態表示
🚨 トラブルシューティング
tmuxセッションが存在しない
エージェントが起動しない
get_agent_status()で状態を確認capture_screen()でエラーメッセージを確認認証代行システムが自動で問題を解決する場合が多い
メッセージが送信されない
エージェントが起動中か
get_agent_status()で確認tmuxセッションが存在するか確認
ターゲット形式が正しいか確認（"session:window.pane"）
📄 スクリプトのカスタマイズ
Agent Collaboration MCPはscripts/agent_tools/内のスクリプトを使用します。独自のエージェント起動方法やメッセージ送信方法がある場合は、これらのスクリプトをカスタマイズしてください：
agent_manager.sh: エージェント起動コマンドの定義pane_controller.sh: メッセージ送信方法の定義
🤝 貢献
このプロジェクトへの貢献を歓迎します。バグ報告や機能提案をお願いします。
📄 ライセンス
MIT License