マネージドコネクタを設定する

Office 365 Outlook、Microsoft Teams、Google Gmail、Yammer/Viva Engage、Box、Confluence、OneDrive、SharePointなどの外部サービスに対して認証済み接続を作成し、ツールごとの承認コントロールやパラメータロックを適用します。エージェントは、構成したガバナンス設定で有効にした操作にのみアクセスできます。

Prerequisites

Azure SRE エージェントポータルのエージェント
エージェントの SRE エージェント作成者 または 管理者 ロール ( ユーザーロールを参照)
接続したいサービスのアカウント(例:Microsoft 365アカウント、Google Gmailアカウント、Viva Engageアクセス、Boxワークスペースメンバーシップなど)

マネージドコネクタがあなたの認証情報をどのように保護するか

コネクタを認証すると、SREエージェントはエージェントランタイムとは別の安全な接続リソースにトークンや鍵を保存します。実行時には、エージェント自身のアイデンティティを使って認証し、その接続を通じてサービスを呼び出します。エージェントはあなたの資格情報を見ることはありません。エージェントの環境が侵害されても、トークンは露出しません。自分のパスワードを変えずにエージェントのアクセスを取り消すことができます。

接続したサービスは、接続を承認したIDを依然として認識しています。エージェントが行うメール送信やチャンネル更新などの行動は、あなたの名前で表示されます。

手順 1: マネージドコネクタウィザードを開く

Azure SRE エージェントポータルでエージェントを開きます。
左側のサイドバーで[ビルダー]を展開 します。
[コネクタ] を選択します。
[ コネクタの追加] を選択します。

コネクタピッカーが開き、タブごとに利用可能なコネクタが表示されます: テレメトリ、通知、 MCP、 インシデント、 デプロイ、 その他。

Note

ソースコードサービス(GitHub、Azure DevOps、GitLab)は、このウィザードではなく、Builder>Code Accessページで接続されています。「 Connect a source code service」を参照してください。

プレビューコネクターカードには プレビュー バッジが表示されます。検索ボックスを使用して、すべてのタブでコネクタを名前で検索します。

手順 2: マネージドコネクタを選択して認証する

接続するサービスのコネクタカードを選択し、[ 次へ] を選択します。

認証手順が表示されます。表示される内容は、コネクタによって異なります。

OAuth コネクタ (ほとんどのサービス)

Office 365 Outlook、Microsoft Teams、Google Gmail、Yammer/Viva Engage、Box、Confluence、OneDrive、SharePointなどのサービスについては:

[ サインイン ] (または [サービス] にサインイン) を選択します。
OAuth ポップアップが開きます。そのサービスのアカウントでサインインします。
ポップアップが閉じると、接続カードに緑色のチェックマークと認証された名前が表示されます。

マルチオーソコネクター

一部のコネクタは、ラジオボタンとして複数の認証方法を提供しています:

自分の好みの方法を選びましょう。
ウィザードが表示するサインイン、トークン、アプリ、または管理IDフィールドを記入してください。

ランタイム定義コネクタ

一部のコネクタはセットアップ時に管理APIから認証方法や操作を取得します。固定された認証リストを前提にせず、ウィザードが示す選択肢に従ってください。

トークンおよびヘッダーベースのコネクタ

コネクタが表示するトークン、ヘッダー、または接続の値を入力します。
接続を選択します。

認証が成功したら、[ 次へ ] を選択して続行します。

Tip

OAuth ポップアップが表示されない場合は、ブラウザーのポップアップブロックを確認します。 sre.azure.comからのポップアップを許可します。

ステップ3:ツールの設置

ツールの設定ステップでは、ツール名、パラメータポリシー、権限の列とともに、コネクター用の利用可能なすべてのツールをテーブルで表示します。

エージェントに使わせたい各操作のチェックボックスを選択してください。
ツール名ヘッダーのチェックボックスを使って、現在フィルターされているすべての操作を選択したりクリアしたりしてください。
検索ボックスを使って、ツールの名前や説明で絞り込みましょう。

選択された数(例えば 47個中12個)は、利用可能な工具の中からどれだけの道具を選んだかを示します。

Note

必要な操作のみを選択します。ツールの数が少ないほど、ガバナンスが向上し、エージェントの動作が正確になります。

同じテーブル内で選択した各操作ごとにガバナンスを設定します:

パラメーター値のロック (パラメーターポリシー)

選択したツールの パラメータポリシー スイッチをオンにします。
ツールが展開され、すべてのパラメーターが表示されます。
任意のパラメーターフィールドに値を入力してロックします。エージェントは毎回この正確な値を使用します。
エージェントがコンテキストに基づいて実行時に入力するフィールドは空のままにします。

パラメーターロックのしくみの詳細については、「マネージドコネクタ」を参照してください。

承認要件を設定する（権限）

選択した各ツールについて、 以下の間で許可を 切り替えます:

許可: エージェントは自由に実行されます (既定)。読み取り操作に使用します。
質問: エージェントは、各実行の前に一時停止し、承認を要求します。リソースを作成、変更、または削除する書き込み操作に使用します。

Warnung

自律モード (スケジュールされたタスク、HTTP トリガー) では、 Ask に設定されているすべてのツールが人間の承認なしに実行されます。有効になっているすべての操作を信頼するワークフローに対してのみ、自律モードを有効にします。実行モードを参照してください。

ツールを選択しガバナンスを設定した後、次を選択します。

手順 4: 確認して作成する

「レビュー&作成」ステップには要約が表示されます:

MCPサーバー 名(自動生成)
コネクターと運用
操作とパラメータカウント

概要を確認します。
を選択してを作成します。

SREエージェントはすぐにコネクタを作成します。コネクターリストに表示され、エージェントはすぐに有効化されたツールを使い始めることができます。

コネクタが動作することを確認する

コネクタを作成した後:

コネクタの一覧を確認します。新しいコネクタに [接続済み ] 状態が表示されます。
エージェントとのチャットを開き、有効な操作のいずれかを使用するように依頼します。

例えば、送信操作を有効にした通知サービスを接続した場合:

「直近の事件の概要をオンコールチャンネルに送れ」

コネクタを編集または削除する

[編集]

既存のマネージドコネクタを選択して、ウィザードを再度開きます。有効にする操作の変更、パラメーター値の更新、承認設定の変更を行うことができます。

削除

コネクタを削除するには、コネクタの一覧からコネクタを選択し、[削除] を選択 します。

REST API を使用してマネージドコネクタを設定する

REST API を使用して、マネージドコネクタをプログラムで作成および管理することもできます。

1. トークンを取得する

TOKEN=$(az account get-access-token --resource https://azuresre.dev --query accessToken -o tsv)
ENDPOINT="https://{agentEndpoint}"

2. 使用可能なコネクタを一覧表示する

curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/managedApis"

3. コネクタの操作を取得する

CONNECTOR_NAME="{connectorName}"
curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/connectors/$CONNECTOR_NAME/operations"

操作応答を操作名やパラメータの真実の情報源として使用します。プレビューコネクターは返す内容を変えることができます。

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/connections/$CONNECTOR_NAME" \
  -d '{ "properties": {} }'

5. ガバナンスを使用して MCP サーバー構成を作成する

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/mcpservers/$CONNECTOR_NAME" \
  -d '{
    "properties": {
      "description": "Managed connector",
      "state": "Enabled",
      "connectors": [{
        "name": "{connectorName}",
        "connectionName": "{connectorName}",
        "displayName": "{Connector display name}",
        "operations": [
          {
            "name": "{ReadOperationName}",
            "displayName": "{Read operation display name}",
            "agentParameters": []
          },
          {
            "name": "{WriteOperationName}",
            "displayName": "{Write operation display name}",
            "requiresApproval": true,
            "userParameters": [
              { "name": "{DestinationParameter}", "value": "{Locked destination}" }
            ],
            "agentParameters": []
          }
        ]
      }]
    }
  }'

この例では、リード操作は承認なしで実行されます。書き込み操作は承認(requiresApproval: true)を必要とし、宛先パラメータをロックします。

エンドポイントの完全な一覧については、 API リファレンスを参照してください。

Troubleshooting

問題点	原因	修正
OAuth ポップアップが表示されない	ブラウザーポップアップブロッカー	`sre.azure.com` からのポップアップを許可する
[サインイン] ボタンは無効のまま	アクセス許可のチェックに失敗しました	エージェントに SRE エージェントの作成者ロールまたは管理者ロールがあることを確認します (「ユーザーロール」を参照)
コネクタがピッカーに表示されない	機能が有効になっていません	エージェントでマネージドコネクタプレビューが有効になっていることを確認する
エージェントがコネクタを使用しない	操作が選択されていません	コネクタを編集し、少なくとも 1 つの操作が有効になっていることを確認する
動的ドロップダウンの読み込みが遅い	サービスの応答が遅い	しばらく待うか、値を手動で入力します

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-13