Microsoft 365 Copilot プラグインは、サポートされている Microsoft エクスペリエンスを、リモートのモデル コンテキスト プロトコル (MCP) サーバーによって提供されるツールに接続します。 プラグイン パッケージには接続構成が含まれており、サーバーは個別に実行されます。
Work IQ Dev Tools (WIQD) を使用して、プラグインを作成、検証、パッケージ化します。 ワーク IQ 開発ツールを使用してプラグインをビルドすることから始めます。
以下のセクションでは、マニフェストを手動で編集する必要がある開発者向けの基本的な構成について説明します。 プラグインのリモート MCP サーバーを Microsoft 365 アプリ マニフェストの agentConnectors 配列に登録します。 このスキーマ識別子は、インストール可能なパッケージがプラグインと呼ばれていても agentConnectors のままです。
重要
この構成では、宣言型エージェント アクションに使用される MCP プラグイン マニフェストではなく、Microsoft 365 アプリ マニフェストを使用します。 また、Agent 365 CLI 登録ルートとは別です。 これらの代替手段については、「 MCP サーバーの構築または再利用」を参照してください。 MCP のみのサポートでは、この登録モデルのサポートは確立されません。
前提条件
開始する前に、次のことを確認してください。
-
agentConnectorsを通じて構成されたプラグインをサポートするテスト テナントとターゲット Microsoft エクスペリエンス。 - パブリックにアクセス可能な HTTPS エンドポイント、TLS 1.2 以降、およびターゲット エクスペリエンスでサポートされているトランスポートを備えた、動作中の MCP サーバー。
- ターゲット エクスペリエンスと選択した承認の種類でサポートされているマニフェスト バージョンを備えた Microsoft 365 アプリ パッケージ。
- サーバーに登録されている承認構成 ( OAuth 構成 や API キー構成など)、サーバーで匿名アクセスが許可されていない限り。
WIQD サーバーの要件と Copilot Cowork ツールの説明の要件については、「 Work IQ 開発ツール」を参照してください。
MCP サーバーをアプリ マニフェストに追加する
アプリ マニフェストのルート レベルにある agentConnectors 配列で MCP サーバーを宣言します。
- Microsoft 365 アプリ パッケージでアプリ マニフェストを開きます。
- ルート レベルの
agentConnectors配列を見つけるか作成します。 - リモート MCP サーバーを識別する一意の
id、displayName、description、およびtoolSourceを含むエントリを追加します。
次の JSON は、完全なアプリ マニフェストではなく、既存のアプリ マニフェストにマージするフラグメントです。
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.30/MicrosoftTeams.schema.json",
"manifestVersion": "1.30",
"agentConnectors": [
{
"id": "my-mcp-server",
"displayName": "My Automation Server",
"description": "Provides workflow automation and task management tools.",
"toolSource": {
"remoteMcpServer": {
"mcpServerUrl": "https://mcp.example.com/mcp",
"authorization": {
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
},
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
}
}
]
}
エンドポイントと承認の参照をサーバーの値に置き換えます。 各エントリの id は、 agentConnectors内で一意である必要があります。 その他の必要なアプリ マニフェスト プロパティは既存のファイルに保持します。
サーバー エンドポイントの構成
toolSource.remoteMcpServer.mcpServerUrl を HTTPS エンドポイントに設定します。 サーバーがターゲット エクスペリエンスから到達可能であり、MCP の初期化とそれに続くプロトコル要求に応答することを確認します。
認証の構成
authorization を agentConnectors[].toolSource.remoteMcpServer 以内に設定します。 次の表に、承認の種類とその構成を示します。 スキーマの詳細については、 承認スキーマを参照してください。
| 承認の種類 | 構成 |
|---|---|
None |
認証は必要ありません。 サーバーが匿名アクセスを許可する場合にのみ使用してください。 |
OAuthPluginVault |
Microsoft のコンテナーに保存され、ID によって参照される OAuth 構成。 |
ApiKeyPluginVault |
コンテナーに格納され、ID によって参照される API キー構成。 |
DynamicClientRegistration |
ID によって参照される動的 OAuth クライアント登録の構成。 |
AzureKeyVault |
ID で参照される Azure Key Vault 構成。 ホストのサポートが必要です。 |
ConnectionVault (開発者プレビュー) |
ID によって参照される接続構成。 |
スキーマ値は、ターゲット エクスペリエンスでのサポートを保証するものではありません。 認証要件を確認してから方法を選択してください。
referenceIdは、マニフェストとは別に取得した構成を識別します。 API キー、アクセス トークン、クライアント シークレット、またはシークレット値を、このフィールドやアプリ マニフェスト内の他の場所に配置しないでください。
OAuth 認証を使用する
Microsoft のコンテナーに保存されている OAuth 2.0 トークンの場合は、次の authorization オブジェクトを使用します。
{
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
}
開発者 ポータル に OAuth 構成を登録し、返された構成 ID を referenceIdとして使用します。 詳細については、 開発者ポータルでの OAuth の構成を参照してください。
OAuth プロバイダー登録で許可されているリダイレクト URI に、次のコールバック URL を追加します。
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
API キー認証を使用する
コンテナーに格納されている API キーの場合は、次の authorization オブジェクトを使用します。
{
"type": "ApiKeyPluginVault",
"referenceId": "my-apikey"
}
デ ベロッパー ポータルにキーを登録し、返された登録 ID my-apikey に置き換えます。 詳細については、「 API キー認証」を参照してください。
動的クライアント登録を使用する
動的クライアント登録では、 RFC 7591 を使用してホストを MCP サーバーに OAuth クライアントとして登録できます。 どちらも登録フローをサポートしている必要があります。 Microsoft Entra ID ではRFC 7591 登録エンドポイントは提供されません。Entra で保護されたサーバーには静的 OAuth 登録を使用します。
次の authorization オブジェクトを使用します。
{
"type": "DynamicClientRegistration",
"referenceId": "my-dcr-config"
}
開発者ポータルで構成を登録し、my-dcr-config参照 ID に置き換えます。 この構成は、ホストがクライアント資格情報をネゴシエートするときに使用する承認値を提供します。
サーバーは以下を満たす必要があります。
- RFC 7591 クライアント登録エンドポイントを公開します。
- ホストの OAuth フローで必要なクライアント登録情報を返します。
- 有効期間が長いセッションに必要な場合は、トークンの更新をサポートします。
Azure Key Vault 認証を使用する
AzureKeyVault は、アプリ マニフェスト スキーマ 1.29 および 1.30 に含まれています。 ターゲット エクスペリエンスで Azure Key Vault の統合および構成参照を取得するプロセスが文書化されている場合にのみ使用してください。
次の authorization オブジェクトを使用します。
{
"type": "AzureKeyVault",
"referenceId": "my-keyvault-config"
}
その統合の資格情報ストレージとアクセスの要件に従い、 my-keyvault-config 返された参照に置き換えます。 マニフェスト宣言だけでは、シークレットへのアクセスは許可されません。
接続コンテナー認証を使用する
注
Connection Vault 認証は、開発者プレビューで利用できます。
ConnectionVault構成するには、開発者プレビュー アプリ マニフェスト スキーマを使用します。これは、一般的に利用可能なアプリ マニフェスト スキーマでは使用できません。
サポートされている接続とボールトの統合では、次の authorization オブジェクトを使用します。
{
"type": "ConnectionVault",
"referenceId": "shared_example"
}
shared_exampleをターゲット統合によって提供される接続参照に置き換えます。
認証を使用しない
サーバーが匿名アクセスを許可している場合は、ホストが許可する場合は、 authorization.type を None に設定するか、 authorization 省略します。
運用環境とエンタープライズ シナリオでは認証されたアクセスを優先し、サポートされている場合は API キーよりも OAuth を優先します。
ツール検出を定義する
ツールセットが修正されている場合はパッケージ化されたツール定義を使用し、アプリ マニフェスト バージョンとターゲット ホストの両方がサポートしている場合は動的検出を使用します。
静的ツール定義を使用する
アプリ パッケージにツール記述ファイルを含め、 remoteMcpServer内で参照します。 パスはアプリ パッケージを基準にしています。 サーバーの tools/list 結果からのツール定義を使用します。これには、各ツールの名前、説明、入力スキーマが含まれます。 たとえば、最小限の toolDescription.json ファイルに次のものを含めることができます。
{
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
{
"tools": [
{
"name": "get_task",
"description": "Gets a task by its identifier.",
"inputSchema": {
"type": "object",
"properties": {
"taskId": {
"type": "string",
"description": "The identifier of the task."
}
},
"required": [
"taskId"
]
}
}
]
}
パッケージ化された定義をサーバーと整合性を保ちます。
動的ツール検出を使用する
動的検出では、ホストはパッケージ化された定義に依存する代わりに、実行時に tools/list を介してツール リストをフェッチできます。
アプリ マニフェスト バージョン 1.29 以降では、 mcpToolDescription を省略できます。 以前のバージョンでは、このファイルが必要です。 Copilot Cowork には、バージョン 1.29 以降であっても、ツール説明ファイルが必要です。 WIQD を使用して、 --tool-description 経由で提供します。 「Work IQ 開発ツール」を参照してください。
動的検出をサポートするターゲット エクスペリエンスでは、tools/listを介して定義を取得できるようにmcpToolDescriptionを省略します。 ツール名、説明、および入力スキーマを返し、ツールセットへの変更がどのように更新されるかをテストします。
プラグインの検証とテスト
配置前にパッケージを検証してから、ターゲット エクスペリエンスでテストします。
- 宣言されたスキーマに対して完全なアプリ マニフェストを検証し、開発者ポータルで アプリ パッケージの検証 を使用します。
- エンドポイントが MCP の初期化に応答すること、およびパッケージ化されたファイルまたは
tools/listが有効なツール定義を提供していることを確認します。 - ターゲット エクスペリエンスでサポートされているプロセスを使用して、パッケージをテスト テナントに展開します。 必要な管理者の承認またはアクセス構成を完了します。 展開によって、ユーザーのサインイン、同意、またはソース サービスのアクセス許可が置き換えられることはありません。
- サーバーが公開する操作のプロンプトをテストします。"自分に割り当てられた未解決の問題を検索してください" や、書き込みツールがあるサーバーの場合は "チケット番号 123 の状態を更新してください" などです。
- 目的のツールが利用可能であること、必要に応じて同意プロンプトが表示されること、およびツール呼び出しが期待どおりの結果を返すことを確認します。 OAuth トークンの更新をテストします (該当する場合)。
- エラーをチェックして、無効な入力、使用できないサービス、認証エラー、タイムアウト (再試行動作を含む) を確認します。
- シナリオでマルチテナントのサポートが必要な場合は、テナント間でテストします。
一般的な問題のトラブルシューティング
| 現象 | 小切手 |
|---|---|
| サーバーに接続できません | エンドポイントのアクセシビリティ、HTTPS、トランスポート サポート、ファイアウォール設定、MCP 初期化。 |
| ツールが表示されない | パッケージ化されたファイル パスと有効な定義、または mcpToolDescription を省略した動的検出のサポート、および作業 tools/list。 |
| 認証に失敗する | 登録済みの referenceId、資格情報の有効性、アクセス許可、同意、および送信承認ヘッダー。 |
| ツール呼び出しが失敗またはタイムアウトする | サーバー ログ、入力検証、MCP 応答形式、同時実行、タイムアウト、再試行回数。 |
次のステップ
統合の準備ができたら、 プラグインをパッケージ化 し、サポートされている 公開または共有方法に従います。