MCP Client Configuration with Azure App Configuration

Azure App Configuration を使用した MCP クライアントの構成

開発環境と本番環境のギャップを埋める

現在、開発者の多くは Claude Desktop や VSCode などのツールを使って、ローカルで MCP サーバーを利用しています。こうした環境は実験や開発には最適ですが、MCP を活用したアプリケーションを本番環境へ移行する際には、重大な課題が生じます。

• 構成管理：ローカル構成（VSCode の mcp.json など）を本番環境へシームレスに移行できません。
• スケーラビリティに関する懸念：本番環境へのデプロイでは、各サービスインスタンスに MCP の設定を複製する必要があり、構成が散在してメンテナンスの負担や不整合のリスクが生じます。
• セキュリティ要件：ローカル開発の範囲を超える場合、適切な認証と認可が必要です。
• 運用の柔軟性：再デプロイせずに構成を更新できることが重要になります。

ConfiguredMcpClientManager による解決策

ConfiguredMcpClientManager の実装は、次の方法でこれらの課題に対処します。

• 構成の一元管理：すべての MCP サーバー構成を Azure App Configuration に保存します。
• 動的更新の有効化：アプリケーションを再デプロイせずに MCP サーバーを変更できます。
• 環境ごとの設定のサポート：開発、テスト、本番環境ごとに個別の構成を管理できます。
• デプロイ戦略の実現：ブルーグリーンデプロイ、カナリアリリース、異なるモデル構成の A/B テストを実施できます。

主な機能

• 構成の抽象化：アプリケーションを一度作成すれば、環境に応じて異なる MCP サーバーに接続できます。
• 自動更新メカニズム：構成は設定可能な間隔で自動的に更新されます。
• シームレスな認証：Microsoft Entra ID と統合し、Azure リソースへの安全なアクセスを実現します。
• デプロイの柔軟性：環境固有のパラメーターを使用して、さまざまな種類の MCP サーバー（stdio、sse など）をサポートします。

Azure App Configuration のセットアップ

1. Azure Portal で Azure App Configuration ストアを作成します。
2. MCP サーバーの構成をキーと値のペアとして追加します。

例：Azure MCP サーバー（stdio タイプ）

キー：MCP:AzureMCPServer

値：

{
    "name": "Azure MCP Server",
    "type": "stdio",
    "command": "npx",
    "args": [
        "-y",
        "@azure/mcp@latest",
        "server",
        "start"
    ]
}

例：リモート SSE サーバー

キー：MCP:Fetch

値：

{
    "name": "Fetch",
    "type": "sse",
    "url": "https://remote.mcpservers.org/fetch"
}

実装のベストプラクティス

1. 環境固有の構成：

   • Azure App Configuration のラベルを使用して、開発／テスト／本番環境を分けます。
   • 例：MCP:AzureMCPServer;env=production と MCP:AzureMCPServer;env=development

2. 監視と可観測性：

   • 本番環境でのモデルのパフォーマンスを追跡するテレメトリを追加します。
   • 構成を使用して、詳細なログ記録を有効または無効にします。

3. ロールバック戦略：

   • バージョンラベルを使用して、以前の動作する構成を保持します。
   • 本番環境の問題に対する迅速なロールバック手順を実装します。

4. 構成の検証：

   • 新しい構成を本番環境に適用する前に検証します。
   • 連鎖的な障害を防ぐため、サーキットブレーカーを実装します。