🤫 Authenticated Remote MCP Server

🤫 認証済みリモート MCP サーバー

このサンプルは、Entra ID で保護された MCP サーバーを Azure にデプロイする方法を示しています。

このサンプルでは、クライアントがまず MCP サーバー用 のトークンを取得し、その後 on-behalf-of フロー を使用して、Microsoft Graph で使用できるトークンと交換する認可パターンも採用しています。しかも、これらすべてを完全にシークレットレスな方法で行います。

⚠️ 重要: 実験的な実装

重要

これは実験的な実装であり、本番環境では使用しないでください。

このサンプルは、Entra ID がこれらの標準をネイティブにサポートしていない現状のギャップを回避する、OAuth 2.0 動的クライアント登録および PKCE フローパターンを実装することで、Entra ID を使用して保護された MCP サーバーを構築する方法を示しています。技術的な可能性を示すものですが、教育および概念実証を目的としたものにすぎません。

本番環境のシナリオでは、事前登録されたアプリケーションと標準的な OAuth フローを使用した、確立された認証パターンの使用を検討してください。

使用技術

• ⚡ Azure Functions
• 🕸️ Azure API Management
• 💪 Bicep
• 🐍 Python
• 🚀 Azure Developer CLI

メモ

この MCP サーバーをテストするには、Model Context Protocol Inspector または Visual Studio Code を使用できます。

認可フローの仕組み

この実装では、PKCE (Proof Key for Code Exchange) を備えた高度な OAuth 2.0 フローを使用して、MCP クライアントを安全に認証します。全体像は次のとおりです。

sequenceDiagram
    participant Client as MCP Client
    participant Browser as User's Browser
    participant APIM as API Management
    participant Entra as Entra ID
    participant Function as Azure Function
    participant Graph as Microsoft Graph

    Note over Client,Graph: 1. Discovery & Registration
    Client->>APIM: GET /.well-known/oauth-authorization-server
    APIM->>Client: OAuth metadata (authorization_endpoint, token_endpoint, etc.)
    
    Client->>APIM: POST /register (Dynamic Client Registration)
    Note over APIM: Store client info in CosmosDB<br/>Generate unique client_id
    APIM->>Client: Client credentials (client_id, no secret)

    Note over Client,Graph: 2. Authorization with PKCE
    Note over Client: Generate code_verifier & code_challenge
    Client->>Browser: Open authorization URL with PKCE params
    Browser->>APIM: GET /authorize?client_id=...&code_challenge=...
    
    Note over APIM: Check for existing consent cookie<br/>🍪 __Host-MCP_APPROVED_CLIENTS
    alt No previous consent
        APIM->>Browser: Redirect to /consent page
        Note over Browser: User reviews permissions and clicks "Allow"
        Browser->>APIM: POST /consent (with CSRF protection)
        Note over APIM: Set consent cookie<br/>🍪 __Host-MCP_APPROVED_CLIENTS<br/>🍪 __Host-MCP_CONSENT_STATE
    end
    
    APIM->>Browser: Redirect to Entra ID with state correlation
    Note over APIM: Set Entra state cookie<br/>🍪 __Host-MCP_ENTRA_STATE<br/>(contains sessionId|entraidState|clientState)
    
    Browser->>Entra: Authorize with Entra ID
    Note over Browser: User authenticates with Entra ID
    Entra->>APIM: Callback with authorization code
    
    Note over APIM: Validate state correlation<br/>Exchange code for Entra access token<br/>Generate encrypted session token
    APIM->>Browser: Redirect with MCP authorization code

    Note over Client,Graph: 3. Token Exchange
    Browser->>APIM: POST /token (code + code_verifier)
    Note over APIM: Validate PKCE challenge<br/>Return encrypted session token
    APIM->>Browser: Access token (encrypted session key)
    Browser->>Client: Token for MCP communication

    Note over Client,Graph: 4. Authenticated MCP Communication
    Client->>APIM: GET /mcp/sse (with Bearer token)
    Note over APIM: Decrypt session token<br/>Lookup cached Entra token<br/>Add to request for downstream
    APIM->>Function: Forward with Entra access token
    
    Function->>Graph: API calls using on-behalf-of flow
    Graph->>Function: User data
    Function->>APIM: MCP response
    APIM->>Client: Authenticated MCP response

セキュリティ機能と使用される Cookie

この実装では、安全なフローを確保するためにいくつかのセキュリティメカニズムと Cookie を使用しています。

Cookie	目的
__Host-MCP_APPROVED_CLIENTS	特定のクライアントに対するユーザーの同意を記憶します
__Host-MCP_DENIED_CLIENTS	拒否された同意を記憶し、再プロンプトを防ぎます
__Host-MCP_CONSENT_STATE	同意フォームの送信を検証します
__Host-MCP_ENTRA_STATE	Entra ID コールバックを元のリクエストに関連付けます
__Host-MCP_CSRF_TOKEN	同意フォームに対する CSRF 攻撃を防ぎます

メモ

すべての Cookie は最大限のセキュリティのために __Host- プレフィックス、Secure、HttpOnly、SameSite=Lax を使用しています (クロスサイトリダイレクトに SameSite=None を使用する __Host-MCP_ENTRA_STATE を除く)。

主なセキュリティ機能:

• 🔐 PKCE (Proof Key for Code Exchange) - 認可コードの傍受を防ぎます
• 🍪 セキュア Cookie - すべての Cookie が最大限のセキュリティのために __Host- プレフィックスを使用します
• 🛡️ CSRF 保護 - 定数時間検証を伴う二重送信 Cookie パターン
• 🔄 状態の関連付け - 複数層の状態検証によりセッション固定攻撃を防ぎます
• 🔒 暗号化されたセッショントークン - セッション識別子は AES で暗号化されます
• ⏰ トークンキャッシュ - パフォーマンスのために Entra トークンを暗号化されたセッションキーでキャッシュします

はじめに

以下の手順に従って開始してください。

1. Azure Developer CLI をインストールします。

2. リポジトリをローカルにクローンします:

   git clone https://github.com/localden/remote-auth-mcp-apim-py
   

3. ターミナルでリポジトリに移動します:

   cd remote-auth-mcp-apim-py
   

4. Azure portal または以下の Azure CLI コマンドを実行して、サブスクリプションに Microsoft.App リソースプロバイダーが登録されていることを確認します:

   az login
   az provider register --namespace Microsoft.App --wait
   

5. Azure Developer CLI にログインします:

   azd auth login
   

6. プロジェクトを Azure にデプロイします:

   azd up
   

重要

このプロジェクトをデプロイすると、Azure のコストが発生します。テストや実験のためにデプロイする場合は、テスト後に作成したリソースグループを必ず削除してください。

プロジェクトのデプロイとテスト

azd up を実行すると、infra ディレクトリで宣言されたリソースが Azure アカウントにプロビジョニングされます。既存の Bicep ファイルを確認することで、どのようなインフラストラクチャが自動的にデプロイされるかを把握できます。

デプロイが完了すると、ターミナルに エンドポイント が出力されます:

たとえば、上のスクリーンショットではエンドポイントは https://apim-2lzunaz2nu642.azure-api.net/mcp/sse です。これをコピーします。

メモ

次のステップに進む前に、Node.js がインストールされていることを確認してください。Model Context Protocol Inspector を実行するために必要です。

ターミナルで以下を実行します:

npx @modelcontextprotocol/[email protected]

メモ

保護された MCP サーバーをテストする際に最も安定したバージョンであるため、Model Context Protocol Inspector の 0.9.0 リリースを使用しています。

これにより、Model Context Protocol Inspector がローカルで実行されているエンドポイントが表示されます。ブラウザーでその URL を開きます。

Transport Type を SSE に切り替え、URL をデプロイの実行で取得したエンドポイントに設定します。Connect をクリックします。

インフラストラクチャをデプロイしたテナント内の資格情報で認証するよう求められます。Entra ID アプリケーションはデプロイ時に動的に登録されます。1 つはサーバー用で、もう 1 つは Microsoft Graph へのアクセスを取得するための on-behalf-of フローに使用されます。

同意すると、Model Context Protocol Inspector のランディングページに戻ります。接続が確立されるまで数秒待ちます。ページに緑色の Connected ラベルが表示されます。

接続したら、List Tools をクリックし、get_graph_user_details を選択します。これにより、Microsoft Graph から現在認証されているユーザーに関するデータを取得できます。Run Tool をクリックします。

すべてがうまくいけば、次のようにレスポンスブロックにユーザーデータが表示されます:

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
  "businessPhones": [],
  "displayName": "YOUR_NAME",
  "givenName": null,
  "jobTitle": null,
  "mail": "YOUR_EMAIL",
  "mobilePhone": null,
  "officeLocation": null,
  "preferredLanguage": null,
  "surname": null,
  "userPrincipalName": "YOUR_UPN",
  "id": "c6b77314-c0ec-44b2-b0bb-2c971a753f0c",
  "success": true
}

フィードバックと問題の報告

問題に直面したりコメントがある場合は、必ずイシューを作成してください。