本文へスキップ

プラグイン:Agent に必要な能力を持たせる

Plugin、Skill、MCP の違いを理解し、必要な能力を接続して、実際の読み取りで接続を確かめます。

約 7 分

この章でできるようになること

実際のプラグイン呼び出しを確認し、出所と照合できる実データを読み取る。

Agent にページの作成やファイル整理を頼めるようになったら、次は外部サービスの実データを読み取りたくなるでしょう。プラグインは「どう作業し、何に接続できるか」を担います。

「プロジェクト管理サービスから最近の作業項目を読み取る」など、具体的な目的から始めます。将来使うかもしれない能力を大量にインストールするのではなく、今の仕事で各能力が何をするのかを把握しましょう。

三つの名前と役割

名前意味確認すること
Plugin用途ごとの能力のパッケージ。Skill や MCP を含められる内容と適した仕事
Skill一種の仕事を進めるための説明と資料目的と入力に適しているか
MCP Server外部ツールやデータを Agent に提供する接続設定、ログイン、現在の Agent harness への対応

Skill があるだけで外部アカウントへのアクセス権が得られるわけではありません。MCP を含むプラグインでも接続が必要な場合があります。Agent harness は実行の入口、Model は選択するモデルで、どちらもプラグインとは別です。

進め方、接続、認証
  1. Skill繰り返し使える作業方法
  2. MCP 接続外部サービスを使うツール
  3. アカウント認証接続で読み書きできる範囲を決める
Plugin は機能をまとめます。接続には対応する設定と権限が別途必要です。

プラグインが手順とツールをまとめ、Agent がそれを使って作業します。接続で何を読み書きできるかは、外部サービスのアカウント認証で決まります。

インストール後に接続を確認する

対象ワークスペースでサイドバーから直接「プラグイン」を開きます。「インストール済み」とプラグインを探す領域があり、名前、用途、Skill で検索できます。詳細の用途と内容を読み、必要なものをインストールします。所有者と編集者はインストール、更新、アンインストールができ、閲覧者には同じ管理操作はありません。

完了後は「インストール済み」に戻ります。外部接続が含まれる場合は詳細の「接続」を確認します。接続不要、設定が必要、OAuth ログインが必要、特定の Agent harness のみ対応、といった状態があります。該当する接続操作からサービスのログインを進め、戻って状態を確認します。

権限は二層で考えます。ワークスペースの役割がプラグイン管理の可否を決め、外部アカウントの認可が読み書きできる内容を決めます。ログイン時にはサービス、アカウント、要求されるアクセス範囲を確かめ、共有ワークスペースではチームが合意した用途で使います。

手引きとプラグを収めたトレイから、鍵穴を通って外部データへ線が伸びている。
Plugin は能力をまとめ、Skill は手順を提供し、MCP はツールやデータにつなぎます。インストールと外部サービスの認可は別です。

小さな読み取りで動作確認できます。

接続したプロジェクトサービスから、指定したプロジェクトの最近の作業項目を五件読み取り、タイトル、状態、出所リンクを列挙してください。読み取りだけで変更はしないでください。現在の Agent harness が接続に非対応、または認可が不足している場合は明示し、サンプルデータで代用しないでください。

もっともらしさではなく、出所をたどれることが確認の基準です。リンクを一件開き、タイトルと状態を照合します。実際の読み取りが成功するまでは、その結果に後続の作業を頼らないようにします。

明確な提供元がある場合の高度な入口

右上の「詳細設定」には Skills、MCP Servers、Agent Plugins があります。独立した Skill は対応リンク、フォルダー、アーカイブなどから取り込めます。リモート MCP には HTTPS のサービスエンドポイントを使い、フォームで設定します。Agent Plugin はフォルダー、ZIP、公開 GitHub リポジトリに対応します。

提供元の説明やチームが確認したリソースを持っている場合の入口です。通常は発見画面の完全なプラグインから選ぶと、含まれる能力が分かりやすくなります。一般の Web ページ URL は MCP の接続先ではなく、名前を知っているだけではインストール済みでもありません。

「更新」「すべて更新」が表示されたら、必要に応じて明示的に更新します。自動アップグレードが約束されるわけではありません。アンインストールはこのワークスペースからプラグインを外しますが、第三者アカウントの認可は取り消しません。そちらのアクセスも止める場合はサービス側の認可管理で操作します。

結果をチームの目に届くところに置く

読み取った結果をチームがいつでも見られるようにしたいなら、Agent にウェブページにして公開するよう頼みます。開けるのは Workspace のメンバーだけで、30 日間誰も開かなかったページは「保持する」をオンにしていない限り削除されます。定期的に更新するには定期タスクを作り、プロンプトにページを作り直して再公開するよう書きます。アドレスは変わりません。

問題があれば順にさかのぼる

プラグインが見つからなければ、ワークスペースとインストール済み一覧を確認します。接続できなければ設定、OAuth、harness 対応を調べます。読み取ったデータがおかしければ、出所のリンクを開いて照合し、認証したアカウントとアクセス範囲を確認します。

実際の能力呼び出しが成功し、返ってきたデータを出所のリンクと照合できれば、この章は完了です。