はじめに

AIエージェントの活用が進む現代において、複数のMCP（Model Context Protocol）サーバと柔軟に連携できるクライアントツールのニーズが高まっています。特に、皆様がすでに利用されているAzure OpenAIを活用し、社内外のMCPサーバとの統合が求められる場面では、WindowsやMacなどのデスクトップ環境や開発環境で利用できる汎用性の高いUIクライアントアプリが重要です。

本記事では、上記を手軽に実現できるように開発した「MCP Client for Azure」について紹介します。このツールは、Azure OpenAIとSTDIO/HTTP/SSE型のMCPサーバと連携可能なエージェント型チャットUIを提供し、技術者がより自由にAIエージェントを活用できる環境を構築します。以前の記事でCLIツールをご紹介しましたが、今回はとても活用しやすいUIアプリです。

コンセプトと目的

「MCP Client for Azure」は、以下のような目的を持って設計されています：

Azure OpenAIの活用を簡易化：APIキーまたはEntra ID認証による接続で、Azure OpenAIの機能をすぐに利用可能
MCPサーバとの柔軟な連携：STDIO、HTTP、SSEといった多様なプロトコルやMCP仕様準拠のOAuth2認可フローにも対応し、社内外のMCPサーバと統合可能
エージェント型UIの提供：ユーザーが自然な対話を通じてAIエージェントとやり取りできる、直感的なチャットインターフェース

このツールは、技術検証、社内業務支援、デモ、教育・研修など、さまざまなシーンでの活用が期待されます。

主な機能

🔗 Azure OpenAIとの統合

エンドポイント、デプロイ名、APIバージョン、APIキーを設定するだけで利用可能
APIキーを省略すれば、Entra ID（旧Azure AD）による認証にも対応
モデルパラメータ（temperature、max_tokensなど）も柔軟に設定可能
ユーザ指示に対応し、MCPサーバと連携したタスク実行や応答を実現

🌐 MCPサーバとの接続

STDIO型：ローカルで起動したMCPサーバとの標準入出力による接続
HTTP/SSE型：REST APIベースのリモートMCPサーバとの通信
サーバごとに環境変数やヘッダーを個別設定でき、柔軟な運用が可能
HTTP/SSE型サーバ接続においてMCP仕様準拠のOAuth2認可フローをサポート

🛡️ ツール実行の承認ダイアログ

各ツール呼び出しに対して「許可」「すべて許可」「拒否」の選択が可能
セキュリティと操作性のバランスを保ち、誤操作を防止

💾 サーバ設定の保存と再利用

一度登録したMCPサーバ設定はローカルに保存され、次回以降の起動時に簡単に再利用可能
設定ファイルはユーザホームの .mcpclient/mcpclient.conf に保存され、ユーザーごとに管理可能

🗂️ セッション管理機能

すべてのチャット履歴はローカルファイルとして保存
過去のセッションを再読み込みして、検証や振り返りに活用可能
セッションごとにタグ付けやメモの追加も可能で、ナレッジ管理にも活用できる

🎨 モダンなUI

Material-UIを採用した洗練されたユーザーインターフェース
リアルタイムな更新と軽快なレスポンス

インストールと起動手順

1. バイナリのダウンロード

GitHubのリリースから、WindowsまたはMacOS向けのバイナリをダウンロードします。

ダウンロードした実行ファイルの起動には適切な実行許可が必要になる場合があります。特にMacOSでは一度アイコンをダブルクリックで起動すると、強制的に停止します。その後、「設定」メニューの「プライバシーとセキュリティ」の「アプリケーションの実行」セクションでアプリを「そのまま開く」を選んでいただくことで、起動できるようになります

2. 初回起動とデータディレクトリの選択

初回起動時には、AzureやMCPの設定ファイルとチャット履歴の保存先を選択するダイアログが表示されます。選択したパスはユーザのホームディレクトリの.mcpclient/mcpclient.conf に保存され、以降の起動時に自動で読み込まれます。

3. Azure OpenAIの設定

「Azure Settings」から以下の情報を入力：

エンドポイントURL
デプロイ名
APIバージョン
APIキー（省略するとEntraIDの認証を利用）

オプションでシステムプロンプトの設定を更新しエージェント動作をカスタマイズ可能です
また、temperatureやtop_p、max_tokensといったパラメータも設定できます

4. MCPサーバの登録

「MCP Servers」から新規サーバを追加。STDIO/HTTP/SSEいずれにも対応しています

STDIO型

STDIO型は利用するコマンドや環境依存の設定もありますので確認の上で利用ください
特にMacOSはコンソールの環境変数を本アプリ内に持ち込めないため、MCPサーバの環境変数設定でPATHの設定を追加しないとnpxなどのコマンドが見つからず実行できないため、適切なPATH環境変数の設定(例 PATH=/opt/homebrew/bin:/bin:/usr/bin:/usr/local/bin:$PATH)が必要です