Important
このプレビュー機能は、Microsoft Azure プレビューの使用条件に従います。 プレビュー期間中、この機能はAzureパブリック リージョンでのみ使用できます。
サービスとしてのソフトウェア (SaaS) アプリ、ビジネス システム、およびデータ プラットフォームと統合するソリューションを構築するときは、通常、接続または統合ごとにカスタム API クライアント コードを記述する必要があります。 また、認証フロー、認証情報のローテーション、再試行ロジック、ページ発行、ウェブフックのサブスクリプションも複数システムにわたって管理しなければなりません。 これらの作業は、開発のオーバーヘッドと運用リスクを大幅に増加させます。
コネクタ名前空間は、この複雑さを排除する完全管理型統合サービスです。 このサービスは、一貫したプログラミングモデルを通じてSharePoint、Salesforce、SAP、Outlookなどのサービスに接続するための、既製品で再利用可能なコネクターのカタログをホストしています。 各コネクタは、イベント トリガー、タスクを完了するアクション、共有接続モデルを介した AI エージェント ツールなどの操作を公開します。 ソリューションでは、C#、Node.js、Python用の言語固有のソフトウェア開発キット (SDK) を使用するか、直接 HTTP 呼び出しを使用してトリガーとアクションを呼び出すことができます。
コネクタ名前空間は、次のタスクを処理することで、基になる統合インフラストラクチャを管理します。
| Task | Description |
|---|---|
| 認証と資格情報の管理 | OAuth、API キー、トークンベースの接続の資格情報またはシークレットを格納してローテーションします。 |
| ポーリングとWebhookの配信 | ソース システムが変更されたときにアプリにデータをプッシュするイベント サブスクリプションを作成および管理します。 |
| 再試行、調整、およびエラー処理 | カスタム実装を使用せずに、組み込みの回復性ポリシーを設定します。 |
| AI エージェントの MCP サーバー ホスティング | AI エージェントと Copilotが外部サービスをツールとして呼び出すことができるように、コネクタをモデル コンテキスト プロトコル (MCP) サーバーとして発行します。 |
この概要では、コネクタの名前空間、主要な概念、コネクタの名前空間のしくみ、セキュリティの側面、プレビュー中のデプロイに関する考慮事項について説明します。
Note
コネクターネームスペースは、ワークフローエンジン上で動作しない計算サービスのための統合経路です。 コネクタ名前空間については、Azure Logic Apps で何かを必要としたり、使用したり、変更したりする必要はありません。 Azure Logic Appsのコネクタ ギャラリーは、Azure Logic Appsのワークフローに対して独立して個別に動作します。
コネクタの名前空間でできること
一貫したプログラミング モデルを使用して、アプリを何百もの外部サービスと統合します。 以下の表は、追加コードなしでConnector Namespaceを使って他のサービスと統合できる一般的なシナリオを説明しています。
| シナリオ | 統合の例 |
|---|---|
| ドキュメントとコンテンツを処理する | Azure関数は、SharePoint コネクタ操作を使用して、SharePoint サーバー上の新規または更新されたファイルを検出し、ファイルの読み取りと処理を行い、結果をSharePointに書き戻します。 |
| 外部サービスからのイベントを監視する | Azure コンテナー アプリでは、Salesforce コネクタ トリガーを使用して、Salesforce から新しい潜在顧客に関するイベントを受信します。 |
| 生産性の自動化 | Node.js アプリでは、Outlook コネクタ操作を使用して、別のアプリが既に所有している接続を再利用して、電子メールの読み取りと送信を行います。 |
| AI ワークロードまたはエージェント ワークロードを作成して実行する | Python サービスは、コネクタ アクションを呼び出して、ビジネス システムからのデータを使用してモデル出力をグラウンドまたはエンリッチします。 |
| 既存のアプリ コードを再利用する | ASP.NET、Node.js、およびPythonサービスでは、呼び出しパスにワークフロー エンジンなしでマネージド統合を使用できます。 |
| マネージド MCP サーバーとしてコネクタを発行する | 1 つの手順で、コネクタを名前空間からモデル コンテキスト プロトコル (MCP) サーバーに変換します。 名前空間はホスティング、ツール定義、認証を処理するため、Copilotやその他の AI エージェントはコネクタ アクションをツールとして呼び出すことができます。 |
| キュレーションされたカタログから MCP サーバーをデプロイする | 既製の MCP サーバーを選択してコネクタ名前空間にデプロイします。 サーバー構成は制御しますが、名前空間はデプロイ、スケーリング、資格情報を処理します。管理するインフラストラクチャはありません。 |
主な概念
次の表では、コネクタ名前空間を使用する際に理解する必要がある主要な概念について説明します。
| 概念 | Description |
|---|---|
| コネクタの名前空間 | コネクタ ランタイムをホストし、次のタスクを処理するAzure リソース。 - コネクタの操作を読み込んで実行します。 - 接続の状態と資格情報を維持します。 - ソース サービスとシステムのポーリング。 Webhook イベントを送信します。 - 再試行、スロットリング、診断の各ポリシーを適用します。 コネクタ名前空間は、Azure ポータル、Azure Resource Manager (ARM) テンプレート、Bicep テンプレート、またはAzure CLIを使用して作成できます。 次に、接続をバインドし、アプリでコネクタを利用します。 |
| Connector | SharePoint、Salesforce、SAP、Outlookなど、特定のサービスを統合するための事前構築済みコンポーネント。 コネクタは、基になるサービスの API、認証プロトコル、改ページ、再試行の動作を抽象化して、コードがビジネス ロジックに集中し続けます。 各コネクタは、次の操作のために型指定されたサーフェスを公開します。 - トリガー: アプリがコネクタに登録するイベント サブスクリプション操作。 たとえば、新しいメールが届いたとき、レコードが更新されたとき、またはファイルがフォルダーに追加されたときなどです。 ソース サービスまたはシステムがイベントを発生させると、コネクタ名前空間によってペイロードがアプリに送信されます。 --- 各コネクタは、特定のアプリとは別にトリガーを定義します。 ---複数のアプリは、同じ接続を使用して同じトリガー イベントをサブスクライブできます。 --- コネクタ名前空間は、基になるサービスがサポートする内容に基づいて、ポーリング スケジュールと Webhook 登録をユーザーに代わって管理します。 - アクション: アプリが呼び出す操作。 たとえば、メッセージの送信、行の読み取り、ファイルのアップロードなどを行います。 |
| 接続 | 外部アカウントまたはテナントへの、認証および構成済みのバインド。 接続を再利用できます。つまり、複数のアプリとコネクタが同じ接続を共有できます。 サポートされている接続認証の種類: -Oauth - API キー -基本的な |
| MCP サーバー | モデル コンテキスト プロトコル (MCP) を介して AI エージェントが使用できるツールを公開する最上位のリソース。 コネクターネームスペースは、コネクターネームスペースによってホストされる以下の種類のMCPサーバーをサポートしています: - マネージド: コネクタ名前空間が作成して構成するサーバーとコネクタ。 マネージド サーバーまたはコネクタを MCP サーバーとしてデプロイできます。 必要なのは、基になる接続を認証することだけです。 コネクタ名前空間は、サーバー構成、ツール定義、ライフサイクル、ランタイムを処理します。 - ホスト型: 厳選されたカタログから選択し、構成して、コネクタ名前空間にデプロイできる構築済みの MCP サーバー。 サーバーの設定、環境、およびパラメーターは常に制御できます。 コネクタ名前空間は、ホスティング、スケーリング、資格情報を処理します。 どちらの場合も、Copilot、カスタム エージェント、または MCP 対応クライアントなどの AI エージェントは、名前空間の接続モデルを使用してツールを検出して呼び出すことができます。 基になる接続とは別に、MCP サーバーを有効、無効、またはローテーションできます。 |
| コネクタSDK | 言語の標準的なイディオムを使用してコネクタを呼び出すことができるように、コネクタ名前空間に付属する厳密に型指定された SDK: - C#: NuGet 上の Azure.Connectors.Sdk。IntelliSense、コード補完、CodeLens を利用するには、Visual Studio Code の言語サービスが必要です。 - Node.js: @azure/connectors。これは、async-await によるアクション呼び出しに対応した、TypeScript を第一に設計されたクライアントです。 - Python: azure-connectors。これは、Azure SDK for Python の規約に準拠しています。 各 SDK は、同じカタログ、接続モデル、一貫性のあるテレメトリ、再試行セマンティクスを公開します。 注: 型指定された SDK が適切でない場合は、HTTP 経由でコネクタを呼び出すことができます。 |
コネクタの名前空間を操作する方法
次のセクションでは、コネクタまたは MCP サーバーとアプリの統合を開始するプロセスの概要について説明します。
コネクタをアプリと統合するための一般的な手順
次の大まかな手順では、アプリでコネクタの使用を開始する一般的な方法について説明します。
Azure サブスクリプションで、コネクタ名前空間リソースを作成します。
統合するサービスへの 1 つ以上の接続を作成します。
たとえば、Microsoft 365への OAuth 接続、または外部サービスへの API キー接続を作成するとします。 次の手順では、アプリとコネクタ名前空間の間の動作について説明します。
Functions、Container Apps、App Service、または別のコンピューティング サービスで実行されるアプリは、コネクタ SDK を介して名前空間と接続を参照します。
アプリがコネクタ トリガーをサブスクライブするか、コネクタ アクションを呼び出します。
コネクタ アクションの呼び出しは同期的に実行されます。 トリガー配信では、コネクタとソース サービスに基づいて、Webhook またはプルベースのサブスクリプションが使用されます。
名前空間は、認証、要求署名、ポーリング、Webhook サブスクリプション、再試行を処理します。
アプリは、型指定された応答とイベント ペイロードを受け取ります。
MCP サーバーをアプリと統合する一般的な手順
以下の高レベルのステップは、アプリでMCPサーバーを使い始める典型的な方法を示しています:
Azure サブスクリプションで、コネクタ名前空間リソースを作成します。
カタログから、MCP サーバーをコネクタ名前空間に追加します。
マネージド MCP サーバーまたはホストされている MCP サーバーを追加できます。
基になる接続を認証します。 サーバー固有の構成要件を設定します。
- コネクターネームスペースはMCPサーバーのエンドポイントを公開し、サーバーを稼働させます。 名前空間は認証、スケーリング、認証情報の回転を担当します。
- Copilotやカスタムエージェント、またはMCP対応クライアントなどのAIエージェントは、設定された接続を利用してMCPサーバーを見つけ、ツールカタログを読み、ツールを呼び出しることができます。
コネクタの名前空間を使用できる場所
このセクションでは、アプリでコネクタ名前空間とコネクタ操作を統合に使用する方法について説明します。
コネクタ名前空間は、アプリが使用可能なコネクタ操作を使用できる次のAzureコンピューティング サービスをサポートしています。
- Azure App Service
- Azure Container Apps
- Azure Functions
セルフホステッド コンピューティング サービスは、コネクタ名前空間を介してコネクタを使用できます。
たとえば、これらのセルフホステッド サービスには、Azure Kubernetes または Azure 仮想マシン の ASP.NET、Node.js、またはPythonが含まれます。
AI エージェント、Copilot拡張機能、および MCP サーバー対応クライアントは、コネクタ名前空間でホストされている MCP サーバーのツールを見つけて呼び出すことができます。すべて、個別のコンピューティング レイヤーを経由する必要はありません。
アプリでは、コネクタ名前空間にデプロイされた MCP サーバーのエンドポイントを使用して、接続されたシステムや外部サービスと対話するこれらの AI およびエージェント ツールを使用できます。 カスタム API クライアント コードやツール ラッパーは必要ありません。 コネクタ名前空間では、サーバーを実行するための基になるコンピューティングが提供および管理されるため、独自のインフラストラクチャを使用する必要はありません。
セキュリティとガバナンス
資格情報の管理はコネクタ名前空間のままにします。コネクタ名前空間では、接続資格情報の格納、管理、ローテーションが行われます。 アプリが生の資格情報を処理することはありません。
コネクタ名前空間で仮想ネットワーク統合とプライベート エンドポイントを使用して、ネットワーク アクセスを制限します。
コネクタ名前空間でロールベースのアクセス制御 (RBAC) を使用して、接続の作成、トリガーの登録、アクションの呼び出しを行うことができるユーザーを制御します。
コネクタの名前空間とコンピューティング サービス全体でエンドツーエンドのトレースをサポートするには、診断ログと関連付け ID がAzure Monitorにフローします。
考慮事項と制限事項
コネクターネームスペースがプレビュー中である間、プレビュー中に展開を計画している場合は以下の点を確認してください。
| Consideration | Description |
|---|---|
| プレビュー用のサービス レベル アグリーメント (SLA) なし | Connector Namespace(プレビュー)は現在、本番ワークロードには推奨されていません。 |
| リージョンの可用性 | 現在、リージョンのサポートは限られていますが、時間の経過と同時に拡張されます。 |
| コネクタの対応範囲 | 使用率の高いコネクタと標準コネクタを最初に使用できます。一方、SAP、IBM MQ、Oracle Database などのエンタープライズ コネクタは、後の段階に従います。 |
| アイデンティティ | API キーと OAuth 接続は現在サポートされています。 接続のマネージド ID のサポートは後で到着しますが、選択した MCP サーバーについては先に計画されています。 |
| バージョン管理 | SDK と名前空間ランタイムのバージョンは、プレビュー中にペアになっています。 プレビュー版のマイルストーン間では、重大な変更が行われる可能性があります。 |
| Pricing | 価格モデルはまだ確定していません。 使用状況測定の形状は、一般提供前に変更される可能性があります。 |
関連するコンテンツ
- クイック スタート: 統合用のコネクタ名前空間を作成する
- 統合のためにコネクタ名前空間に再利用可能な接続を作成する
- ホストされる MCP サーバーと、管理対象 MCP サーバーとの違いについて説明します。
- カタログから ホストされた MCP サーバー を追加し、シナリオに合わせて構成します。
