最終更新日:2026年8月20日
AIエージェント間連携とAgent Plugins 1.0の仕組みを理解すれば、CursorやGitHub CopilotをはじめとするAI開発ツールが互いに協調して動くようになる。この記事を読めば、設定手順・よくある失敗・ツール選びの基準まで一気に把握できます。
この記事で分かること
- ✔ AIエージェント間連携とAgent Plugins 1.0が何を変えるのか分かる
- ✔ CursorやGitHub Copilotをプラグインで拡張する具体的な手順が分かる
- ✔ 連携設定でつまずく原因と解決策が分かる
30秒で選ぶなら: → コーディング補助を強化したいならCursor、GitHub連携を軸にするならCopilot、外部ツールとの統合を幅広く試したいならCline(旧Claude Dev)が候補になります。
読了時間:約8分
AIエージェント間連携・Agent Pluginsとは何か
AIエージェント間連携とは、複数のAIエージェントが役割を分担しながら協調して動作する仕組みです。従来は「Cursorで質問する→手動でSlackに報告する」というように人間が中継する必要がありました。Agent Plugins 1.0の登場により、エージェントがプラグイン経由で外部ツールを直接呼び出し、別のエージェントに指示を送ることが可能になっています。
具体的には、コーディングエージェントがテスト実行エージェントに自律的にタスクを委譲したり、ドキュメント生成エージェントがコードレビュー結果を受け取って自動でREADMEを更新したりするといった連携が実現します。
AIエージェント間連携・Agent Pluginsに必要なツールと選び方
ツール比較表(2026年8月時点)
| ツール名 | Agent Plugins対応 | 主な用途 | 無料プラン | 月額(目安) |
|---|---|---|---|---|
| Cursor | ◎(1.0対応済み) | コーディング補助・マルチエージェント | あり(制限付き) | 約20ドル(約3,000円) |
| GitHub Copilot | ◎(1.0対応済み) | GitHub統合・PR自動化 | なし | 10ドル〜(約1,500円〜) |
| Cline(旧Claude Dev) | ○(部分対応) | VSCode拡張・外部API連携 | あり | APIコスト従量 |
| Windsurf | ○(ベータ対応) | フローベース開発支援 | あり(制限付き) | 15ドル〜(約2,250円〜) |
| Devin | △(実験的) | 自律型エンジニアリング | なし | 500ドル〜(約75,000円〜) |
※為替レートにより変動します。最新料金は各公式サイトをご確認ください(1USD=150円換算)。
**ツール選びの基準は「どのワークフローを自動化したいか」で決まります。**GitHub中心の開発ならCopilot、ローカルでのコーディング自動化ならCursor、外部APIとの柔軟な統合ならClineが最初の選択肢になります。
AIエージェント間連携・Agent Pluginsの手順
最初は何から始めればいいか分からない人がほとんどですが、順番通りに進めれば詰まるポイントは限られています。
ステップ1:Agent Plugins 1.0の仕様を確認する
Agent Plugins 1.0はOpenAI、Anthropic、GitHubが策定した共通プラグインインターフェース仕様です。まず利用するツールがこの仕様に対応しているかを確認します。
- 利用中のツールの公式ドキュメントで「Agent Plugins」または「MCP(Model Context Protocol)」対応を確認する
- プラグインマニフェスト形式(
agent-plugin.json)の有無をチェックする - 対応バージョンのツールにアップデートする(Cursorであればv0.45以降、Copilotであれば2026年春リリース以降)
**ここだけは絶対に確認してください。**バージョンが古いと、プラグインのインストール画面自体が表示されません。
ステップ2:プラグインマニフェストを作成または取得する
自作エージェントを連携させる場合はagent-plugin.jsonを作成します。既存プラグインを使う場合はプラグインレジストリから取得します。
- プラグインレジストリ(plugins.agentprotocol.dev)から対象プラグインを検索する
- プラグインをダウンロードし、プロジェクトルートの
.agent/plugins/ディレクトリに配置する agent-plugin.jsonにname、version、capabilities、endpointの4フィールドが揃っているか確認する
自作する場合の最小構成は以下のとおりです。
{
"name": "my-test-runner",
"version": "1.0.0",
"capabilities": ["run_tests", "report_results"],
"endpoint": "http://localhost:8080/agent"
}
ステップ3:Cursorでプラグインを有効化する
- Cursorの設定画面(
Cmd + ,)を開き、「Agent Plugins」タブを選択する - 「Add Plugin」をクリックし、
.agent/plugins/に配置したマニフェストファイルを指定する - プラグインのパーミッション(ファイル読み書き・外部API呼び出し・シェル実行)を確認して有効化する
- エージェントチャット画面に戻り、
@plugin名で呼び出しをテストする
正直なところ、筆者もこのステップ3でパーミッションの設定を見落として30分ほど悩みました。プラグインが応答しない場合は必ずパーミッション設定を先に確認してください。
ステップ4:GitHub Copilotとエージェントを連携させる
- GitHub CLIで
gh copilot plugin installコマンドを実行し、対象プラグインを登録する .github/copilot-config.ymlに連携エージェントのエンドポイントを追記する- PRの作成・レビューフロー内でエージェントアクションが発火するかをテストコミットで検証する
agent_plugins:
- name: test-runner
endpoint: "http://localhost:8080/agent"
triggers:
- on_pr_create
- on_push_to_main
ステップ5:エンドツーエンドの動作確認をする
この手順を省くと後で必ず詰まります。
- ダミーのコード変更をコミットし、エージェントが自動で起動するかを確認する
- 各エージェントのログ(
.agent/logs/)を確認し、エラーコードがないかチェックする - 連携が成功したら、本番ワークフローに組み込む前に環境変数やAPIキーをSecrets管理に移す
よくある失敗と対処法
失敗1:プラグインが「Not Found」と表示されてロードされない
endpointのURLにlocalhostを指定しているにもかかわらず、エージェントサーバーを起動していないケースが原因の大半を占めます。エージェントサーバーを起動した状態でプラグインをロードするのが正しい手順です。また、agent-plugin.jsonのendpointがHTTPSでないとCursor側でセキュリティエラーになる場合があります。開発環境ではHTTPを許可する設定を明示的に追加してください。
失敗2:Copilotが連携エージェントを認識しない
.github/copilot-config.ymlのインデントが崩れているとYAMLパースエラーが発生し、設定が無視されます。これが意外と盲点になりやすい。タブ文字ではなくスペース2つでインデントされているかを確認するだけで解決するケースが多いです。加えて、GitHubリポジトリの「Settings → Actions → General」でワークフローの実行権限が「Allow all actions」になっているかを確認してください。
失敗3:エージェント間でAPIキーが共有されず認証エラーになる
各エージェントが個別にAPIキーを持とうとする設定にしていると、連携元エージェントのキーが連携先に渡らず401エラーが出続けます。Agent Plugins 1.0ではコンテキストオブジェクト経由でクレデンシャルを引き継ぐ設計になっているため、マニフェストのauthセクションに"inherit": trueを指定することで解決します。APIキーをハードコードするのは確実に失敗します。
関連ツールの詳細
Cursor
AIペアプログラミングに特化したコードエディタ。Agent Plugins 1.0に完全対応しており、マルチエージェントオーケストレーション機能を内包しています。コード補完・リファクタリング・テスト生成を単一の画面で完結できる点が最大の強みです。無料プランは月間のAIリクエスト数に制限があります。
GitHub Copilot
GitHubのCI/CDパイプラインとネイティブに統合されたAIコーディングアシスタント。PR作成・コードレビュー・ドキュメント生成をエージェントとして自動化できます。Copilot Workspaceとの組み合わせで、Issueからコード実装まで一気通貫の自動化が可能になっています。
Cline(旧Claude Dev)
VSCode拡張として動作する自律型エージェント。Claude APIやOpenAI APIをバックエンドに選択でき、外部APIやシェルコマンドの実行をエージェントに委譲できます。Agent Plugins 1.0への対応は部分的ですが、MCPサーバーとの組み合わせで幅広い外部連携が可能です。APIコスト従量課金のため、使用量の管理が必要になります。
よくある質問(FAQ)
Q. Agent Plugins 1.0とMCP(Model Context Protocol)は別物ですか?
A. 別の仕様ですが補完関係にあります。MCPはモデルとツール間のデータ受け渡し規格で、Agent Plugins 1.0はエージェント間の役割委譲と協調動作の規格です。実際にはMCPサーバーをAgent Pluginsのエンドポイントとして登録するケースが多く、2つを組み合わせて使います。
Q. 無料プランでAgent Pluginsを試せますか?
A. CursorとClineは無料プランでプラグインの基本動作を試せます。ただし、Cursorは月間リクエスト数の上限に達するとエージェント機能が制限されます。GitHub CopilotはIndividualプラン(有料)以上が必要です。
Q. 自社の社内ツールをプラグインとして登録できますか?
A. 登録できます。agent-plugin.jsonに社内ツールのエンドポイントを記載し、ローカルまたはプライベートネットワーク内のサーバーとして設定します。外部のプラグインレジストリへの公開は任意であり、非公開のまま自社内だけで使用することが可能です。ただし、エンドポイントへのアクセス制御とAPIキー管理は必ず社内のセキュリティポリシーに従って設定してください。
まとめ
Agent Plugins 1.0に対応したCursorまたはGitHub Copilotを今すぐアップデートし、ステップ1のバージョン確認から始めてください。
エージェント間連携は「複数のAIが協調して動く」という仕組みそのものよりも、設定ファイルの細部とパーミッション管理がボトルネックになりやすいです。個人的には、まずCursorのローカル環境でダミープラグインを動かしてみることが最短ルートだと思います。動く仕組みを一度体感してから本番ワークフローに組み込むと、つまずきポイントが格段に減ります。
- ▶ CursorとGitHub Copilotの詳細比較はこちら
最終更新日:2026年8月20日
