全文翻译：

项目介绍：

Claude 集成 - Microsoft Graph Integration 协议（MCP）服务器详细指南。

分步实施指南：

概述：

此文档详细说明了如何将 Claude AI 集成到 Microsoft Graph 环境中。通过遵循本指南，用户可以配置 MCP 服务器以安全高效地访问 Microsoft Graph API，并利用 Claude 的强大功能来处理数据。

具体步骤：

第一部分：MCP 服务器设置

1. 注册 Azure 应用程序：

   • 登录到 Azure 门户。
   • 进入“Azure Active Directory” > “应用程序注册”。
   • 创建新应用或使用现有应用。

2. 获取 Azure 凭证：

   • 在“Certificates & secrets”部分创建新的客户端密钥。
   • 记录 Application ID（AZURE_CLIENT_ID）和 Client Secret（AZURE_CLIENT_SECRET）。

3. 配置 MCP 服务器：

   • 下载并安装 MCP 服务器软件包。
   • 配置服务器以使用获取的 Azure 凭证。
   • 确保 MCP 服务器已启用 Microsoft Graph 支持。

第二部分：Claude AI 集成

1. 配置 Claude API：

   • 使用 Anthropic 提供的 API 密钥注册 Claude 账号。
   • 在 MCP 服务器中设置 Claude 的 API 端点和访问令牌。

2. 测试集成：

   • 发送简单的 Microsoft Graph 请求（如获取用户信息）以验证连接。
   • 使用 Claude 进行数据分析或处理。

3. 优化与调试：

   • 监控 MCP 服务器日志以确保一切正常运行。
   • 根据需要调整 API 调用的参数和配置。

项目结构：

- claud_integration/
  ├── mcp_server/
    │   └── config/                 # MCP 服务器配置文件
    │   └── modules/               # 各模块实现
    └── claud_interface/           # Claude 接口适配器
  └── doc/                         # 文档和说明

环境变量：

Microsoft Azure 配置：

• AZURE_TENANT_ID：租户 ID。
• AZURE_CLIENT_ID：应用程序 ID。
• AZURE_CLIENT_SECRET：客户端密钥。

Microsoft Graph 配置：

• GRAPH_VERSION：API 版本（默认为 beta）。
• GRAPH_ENDPOINT：API 端点 URL。

其他配置：

• CLAUDE_API_KEY：Claude API 访问令牌。
• LOG_LEVEL：日志记录级别（可选）。

API 端点：

Microsoft Graph 请求格式：

{
  "endpoint": "/users",
  "method": "GET",
  "version": "beta",
  "queryParams": {},
  "body": {},
  "allData": false
}

响应示例：

{
  "status": "success",
  "data": {
    "value": [
      {
        "id": "12345678-9abc-defg-1234-56789abcdef",
        "displayName": "John Doe"
      }
    ]
  }
}

注意事项：

关于 consistencyLevel 参数：

经过测试，发现许多 Microsoft Graph 配置不支持 consistencyLevel 参数。因此，默认情况下已将其从所有请求中移除。

如果需要在特定环境中使用此参数，请手动添加到 queryParams 中：

{
  "endpoint": "/users",
  "method": "GET",
  "queryParams": {
    "$top": 5,
    "consistencyLevel": "eventual"
  }
}

但建议在实际使用前进行充分测试。

JSON 格式要求：

1. 使用双引号表示键和字符串值。
2. 避免嵌套不合规的 JSON 字符串。
3. 确保使用正确的 JSON 类型。

获取 Microsoft Azure 凭证：

步骤如下：

1. 登录 Azure 门户。
2. 进入“Azure Active Directory” > “应用程序注册”。
3. 创建新应用或选择现有应用。
4. 在“Certificates & secrets”部分生成新的客户端密钥。
5. 记录 Application ID 和 Client Secret。

安装与配置：

1. 下载 MCP 服务器软件包。
2. 解压文件并进入主目录。
3. 配置环境变量：

   export AZURE_TENANT_ID=your_tenant_id
   export AZURE_CLIENT_ID=your_client_id
   export AZURE_CLIENT_SECRET=your_client_secret
   

4. 启动 MCP 服务器：

   python3 mcp_server.py
   

安全注意事项：

1. 确保所有敏感信息（如 API 密钥）加密存储。
2. 配置适当的安全策略以限制对 MCP 服务器的访问。
3. 定期更新软件以修复已知漏洞。

故障排除：

常见问题：

• 无法连接到 Microsoft Graph：检查网络配置和 Azure 凭证是否正确。
• Claude 调用失败：确认 Claude API 密钥有效且服务可用。

日志分析：

查看 mcp_server.log 文件以获取详细错误信息。

附加资源：

1. Microsoft Graph 文档
2. Claude AI 开发者指南
3. MCP 服务器 GitHub 仓库

如需进一步帮助，请联系技术支持团队。