Enterprisemcp

🚀 企業版 Microsoft MCP 服務器

企業版 Microsoft MCP 服務器基於開放的 Model Context Protocol 構建，其公開預覽版允許 AI 代理通過將自然語言查詢轉換為 Microsoft Graph API 調用，來訪問 Microsoft Entra 數據。該服務器使開發者和 IT 管理員能夠將組織數據管理集成到 AI 驅動的工作流中。

🚀 快速開始

要開始使用企業版 Microsoft MCP 服務器，請按照以下步驟操作：

1. 確保 Microsoft Graph PowerShell SDK 模塊與 Microsoft.Entra.Beta 模塊不衝突。如果已安裝 Microsoft.Graph 模塊，請考慮先卸載它們：

   Install-Module Uninstall-Graph
   Uninstall-Graph -All
   

2. 安裝 Microsoft.Entra.Beta PowerShell 模塊（版本 1.0.13 或更高）：

   Install-Module Microsoft.Entra.Beta -Force -AllowClobber
   

3. 將 Microsoft Entra ID 連接到你要註冊 MCP 服務器的租戶：

   Connect-Entra -Scopes 'Application.ReadWrite.All', 'DelegatedPermissionGrant.ReadWrite.All'
   

4. 在你的租戶中註冊企業版 MCP 服務器，並向 Visual Studio Code 授予所有權限：

   Grant-EntraBetaMCPServerPermission -ApplicationName VisualStudioCode
   

5. 如果你在上述任何步驟中遇到問題，請參考詳細的 安裝說明。

6. 點擊 安裝企業版 Microsoft MCP 服務器 以啟動 VS Code 的 MCP 安裝頁面。

7. 在 VS Code 中點擊“安裝”按鈕，然後使用上述租戶的管理員賬戶登錄。

8. 打開 Copilot Chat 並詢問有關你的租戶的問題。

✨ 主要特性

工具特性

此 MCP 服務器與眾不同，它並非為每個 Microsoft Graph 操作提供單獨的工具，而是應用檢索增強生成 (RAG) 和少樣本提示來生成完整的 Microsoft Graph 查詢。它僅公開三個工具來實現可靠且有依據的工作流：

1. microsoft_graph_suggest_queries：根據用戶意圖查找相關的 Microsoft Graph API 調用。
2. microsoft_graph_get：執行只讀的 Microsoft Graph API 調用，同時遵循用戶角色和 MCP 客戶端範圍。
3. microsoft_graph_list_properties：檢索特定 Microsoft Graph 實體的屬性，以幫助 AI 模型。

功能範圍

在公開預覽階段，我們專注於支持以 Microsoft Entra 身份和目錄操作（用戶、組、應用程序、設備管理和管理操作）為中心的只讀企業 IT 場景。

具體而言，MCP 服務器可以處理與以下方面相關的查詢：

1. 安全態勢：身份驗證方法/強度、條件訪問、安全默認值。
2. 特權訪問：哪些人擁有哪些目錄角色，如何分配（直接分配還是通過組分配）以及 PIM 狀態。
3. 應用程序風險：存在哪些應用程序/服務主體，誰是它們的所有者，它們使用哪些權限/單點登錄，哪些是無所有者或外部的。
4. 訪問治理：哪些人可以訪問哪些資源（用戶、組、包）；審核決策，自動化入職/調動/離職流程。
5. 設備就緒狀態：託管/合規狀態、加入狀態、操作系統/版本分佈以及陳舊或非活動設備。
6. 來源和調查：端到端遙測（登錄、審核、預配、網絡）、健康警報以及 SLA/可用性。
7. 優化支出和清理：許可證數量/使用情況、未使用或陳舊的應用程序/組、域配置和聯繫人。

客戶端支持

企業版 Microsoft MCP 服務器旨在與任何支持最新標準的 MCP 兼容客戶端配合使用。

⚠️ 重要提示

• 不支持動態客戶端註冊 (DCR)，但我們正在努力在未來版本中支持 OAuth 客戶端 ID 元數據文檔 (CIMD)。
• ChatGPT 僅支持使用自定義客戶端 ID，目前僅在專業計劃中可用。
• Claude 存在一個阻止與 Entra 資源進行身份驗證的錯誤，團隊已知曉並正在修復。它也需要自定義客戶端 ID，僅在團隊計劃中可用。

我們建議將其與 Visual Studio Code 和 Copilot Chat 擴展 配合使用。

授權和權限

企業版 MCP 服務器僅使用委託權限通過 Microsoft Graph API 訪問你的 Microsoft Entra 租戶中的數據，並提供 Microsoft Graph 公開的一組簡化權限。

使用以下 cmdlet 列出企業版 MCP 服務器提供的權限：

(Get-EntraBetaServicePrincipal -Property "PublishedPermissionScopes" -Filter "AppId eq 'e8c77dc2-69b3-43f4-bc51-3213c9d915b4'").PublishedPermissionScopes | Where-Object { $_.IsEnabled -eq $true -and $_.AdditionalProperties["isPrivate"] -ne $true } | Select-Object Value, AdminConsentDisplayName | Sort-Object

如果你想使用自己註冊的應用程序，請使用以下 cmdlet 管理授予你的 MCP 客戶端應用程序的範圍：

Grant-EntraBetaMCPServerPermission -ApplicationId "<MCP_Client_Application_Id>" -Scopes "<Scope1>", "<Scope2>", "<...>"
Revoke-EntraBetaMCPServerPermission -ApplicationId "<MCP_Client_Application_Id>" -Scopes "<Scope1>", "<Scope2>", "<...>"

瞭解更多：管理企業版 MCP 服務器權限

優勢特點

1. 遠程 MCP 服務器：易於配置，完全合規且高度可靠，部署在與 Microsoft Graph 相同的區域以實現最佳性能。
2. IT 管理員可控：MCP 客戶端需要被授予特定的 MCP.* 範圍（與 Microsoft Graph 範圍相對應）才能訪問你的租戶數據。
3. 簡化架構：只需使用 3 個工具，而無需為每個 API 操作管理單獨的工具。
4. 高質量查詢生成：通過 RAG（檢索增強生成）使用 500 多個真實世界的示例生成準確的查詢。
5. 完全可審計性：由於所有 MCP 操作都在具有特定用戶代理的同一應用程序 ID 下執行，因此可以輕鬆審計所有 MCP 操作。
6. 無需額外許可證：僅需現有的 Microsoft Entra 和 Microsoft Graph API 許可證。

可用性、路線圖和反饋

企業版 Microsoft MCP 服務器僅在公共雲（全球服務）中可用，計劃在未來版本中支持主權雲。

我們將繼續擴展當前的 Microsoft Entra 場景之外的功能，但 M365 API 將由 Agent 365 覆蓋。

計劃在未來版本中支持寫操作。

請通過我們的反饋表單分享建議或問題：提交反饋。

許可和使用

• 企業版 MCP 服務器無需額外費用或單獨的許可證。
• 你需要為訪問的數據獲得正確的許可證（例如，訪問特權身份管理 (PIM) 數據需要 Microsoft Entra ID 治理或 Microsoft Entra ID P2 許可證）。
• 對該 MCP 服務器的任何請求限制為每個用戶每分鐘 100 個請求。對 microsoft_graph_get 的請求也受 Microsoft Graph 限流限制 的約束。

日誌監控

要監控使用情況，請在你的租戶中啟用 Microsoft Graph 活動日誌。系統會記錄通過 MCP 服務器進行的所有 API 調用。

過濾 MCP 服務器使用情況：

使用企業版 Microsoft MCP 服務器的應用程序（客戶端 ID）：e8c77dc2-69b3-43f4-bc51-3213c9d915b4。

以下 Kusto 查詢可檢索這些日誌：

MicrosoftGraphActivityLogs
| where TimeGenerated >= ago(30d)
| where AppId == "e8c77dc2-69b3-43f4-bc51-3213c9d915b4"
| project RequestId, TimeGenerated, UserId, RequestMethod, RequestUri, ResponseStatusCode

支持和參考

有關文檔、故障排除和反饋，請參考官方 Microsoft Learn 文檔和支持渠道。

安全和合規

所有操作都遵循 Microsoft Graph 權限和安全策略。在集成 MCP 服務器時，請確保符合你的組織、法規和合同要求。

無擔保/責任限制

本軟件“按原樣”提供，不提供任何形式的明示或暗示保證或條件。Microsoft 不對因使用、誤用或錯誤配置本軟件而導致的任何損害承擔責任。