使用 Microsoft Graph API 的 Model-context-protocol (MCP) 服务器

先决条件

Entra ID 应用程序

1. 注册新的 Entra ID 应用程序。
2. 添加并授予至少 User.Read.All 应用程序权限。根据需要，可以添加其他权限。
3. 创建一个新的客户端密钥。

Claude Desktop 应用

• 我使用的是 Claude Desktop 应用，但您也可以使用任何支持本地 MCP 服务器的其他 MCP 客户端，包括 GitHub Copilot（如果允许）。

MCP 服务器配置

1. 打开并构建解决方案。
2. 打开 claude_desktop_config.json 文件。在 Windows 上，该文件位于 %APPDATA%\Claude\ 文件夹中。
3. 在 args 部分指定项目文件夹的路径。记得在 env 部分填写 Entra ID 应用的信息，包括租户 ID、客户端 ID 和客户端密钥。

默认情况下使用 Microsoft Graph 全球服务。您可以通过修改 NATIONAL_CLOUD 环境变量来更改此设置。

NATIONAL_CLOUD 的可能值

• Global: https://graph.microsoft.com - Microsoft Graph 全球服务
• US_GOV: https://graph.microsoft.us - Microsoft Graph for US Government L4
• US_GOV_DOD: https://dod-graph.microsoft.us - Microsoft Graph for US Government L5 (DOD)
• China: https://microsoftgraph.chinacloudapi.cn - Microsoft Graph 中国（由 21Vianet 运营）
• Germany: https://graph.microsoft.de - Microsoft Graph 德国

{
    "mcpServers": {
        "graphApi": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "path/to/folder/with/console_project",
                "--no-build"
            ],
            "env": {
                "TENANT_ID": "<tenant_id>",
                "CLIENT_ID": "<client_id>",
                "CLIENT_SECRET": "<client_secret>",
                "NATIONAL_CLOUD": "Global"
            }
        }
    }
}

运行 MCP 服务器

1. 打开 Claude Desktop 应用，MCP 服务器会自动被发现并运行。
2. 如果之前已经打开了应用，则需要关闭（退出系统托盘）然后重新打开以识别新配置。

注意事项

• 如有故障，请检查日志文件在 %APPDATA%\Claude\logs 文件夹中。