メインコンテンツへスキップ

Skills・Plugins・Agents・Instructions・Extensions

対象: ServerRpc(Client に紐づくサーバー全体の操作) RPC 全体の概要とページ一覧は RPC を参照してください。

Agent Plugin catalog候補

catalog.search で agent-plugin-discovery を要求し、検索対象の kinds に plugin を指定すると Agent Plugin 候補を取得できます。標準形式 application/vnd.github.copilot-plugin 以外の application/vnd.anthropic.claude-plugin+json と application/agent-plugin+json を受け取るには、agent-plugin-discovery に加えて agent-plugin-formats を要求してください。 agent-plugin-confirmed-installation はインストールの可否とレビュー用プランを返す capability で、これも agent-plugin-discovery と併せて要求します。許可すると候補に installability が含まれ、値は installable、install-data-unavailable、feature-disabled、not-installable-kind のいずれかです。installPlan は installability が installable の場合にだけ含まれます。プランは確認用のデータであり、この catalog RPC がインストールを実行することはありません。 プランの sources は優先順に materialization、marketplace、repository の候補を含みます。Marketplace には名前とリポジトリ、直接の Repository にはリポジトリと任意のパスが記録されます。materializationだけのプランでは pluginName が省略され、components は空です。名前や実際に導入される内容は plugins.planInstall() が返すレビューで確認してください。 選択済み候補は plugins.planInstall() で副作用のない検証付きプランを作成できます。plugins.applyInstall() は利用者に明示的な確認を求め、許可された場合にプランを適用します。適用後のプラグインは無効状態で登録されます。 レビューの mcpServers は検証済みファイルが宣言するサーバー名、transport、リモートの場合のhostを示します。これは安全性の保証ではないため、利用者が内容を確認してから明示的な確認を行ってください。インストール済みプラグインの description はmanifest由来です。verifiedSource はGitHubリポジトリと固定commitを示し、commitに固定された直接インストールでのみ存在します。iconUrl は外部の未信頼コンテンツなので、取得時に認証情報やGitHub資格情報を送らないでください。資格情報そのものは拒否理由として返されません。 インストール結果の network-failure では、CatalogNetworkFailureReason、HTTP statusCode、任意の retryAfterSeconds と安全に表示できる message を確認できます。
Agent Finder の materialisation reference から計画する場合は catalog.planInstallFromReference() を使います。結果の outcome->kind は plugin-install-planned、skill-install-planned、refused のいずれかです。プラグインの計画は plugins.applyInstall() に渡し、スキルの計画は skills.applyInstall() に渡してください。

agentRegistry (experimental: エージェントレジストリ)

エージェントレジストリの作成・一覧・削除を行います。一覧結果には接続資格情報は含まれません。

LSP(サーバー全体の言語サーバー設定)

lsp()でサーバー全体の言語サーバー設定の一覧を取得できます。セッション単位の初期化・起動・停止などは SessionRpc の lsp() を使います(使用例は ワークスペース・Agent・Fleet・Skills を参照してください)。
最終更新日 2026年11月19日