Microsoft 365集成工具

塞拉维M365

将Microsoft 365连接到Claude——阅读电子邮件、管理日历、浏览OneDrive文件、组织收件箱和控制Power Automation流程，所有这些都可以在Claude Desktop内完成。

35工具 跨7个模块，完全通过Zod验证。

快速开始

先决条件

• 克劳德桌面 安装
• Microsoft 365帐户（工作或学校）
• Azure AD应用程序注册(安装指南)
• Node.js 18+

选项A：合作/聊天（推荐）

“协作”和“聊天”选项卡在无法访问本地文件的沙箱中运行MCP服务器。此设置在您的计算机上运行一个持久HTTP服务器，并通过Cloudflare HTTPS隧道连接。

git clone https://github.com/CelaviiHQ/celavii-m365.git
cd celavii-m365
./setup-cowork.sh

脚本将：

1. 提示输入Azure AD凭据
2. 构建MCP服务器和技能插件
3. 启动HTTP服务器+HTTPS隧道
4. 打开浏览器进行Microsoft登录
5. 打印Claude Desktop的两个设置步骤

要求： node, cloudflared （如果缺少，则通过Homebrew自动安装）

注： 免费的快速隧道会生成一个随机URL，每次重新启动时都会发生变化。对于一个 持久URL 如果重启后仍能存活，请设置 命名为Cloudflare隧道 （需要免费的Cloudflare帐户）：

复制

cloudflared tunnel login
cloudflared tunnel create celavii-m365
cloudflared tunnel route dns celavii-m365 mcp.yourdomain.com

然后开始隧道 cloudflared tunnel run celavii-m365 而不是快速隧道。看 持久隧道设置 了解详情。

选项B：代码选项卡（插件）

“代码”选项卡以完全文件系统访问权限在本地运行MCP服务器。一个ZIP插件可以处理所有事情。

git clone https://github.com/CelaviiHQ/celavii-m365.git
cd celavii-m365
./build-plugin.sh --client-id YOUR_CLIENT_ID --secret YOUR_SECRET --tenant-id YOUR_TENANT_ID

然后在Claude Desktop中：

1. 定制 → + → 上传本地插件
2. 选择 celavii-m365-plugin.zip
3. 开始聊天并说： “使用Microsoft 365进行身份验证”
4. 单击身份验证链接，登录，您就设置好了

选项C:Claude代码命令行界面

claude mcp add --transport stdio --scope user \
  --env M365_CLIENT_ID=YOUR_ID \
  --env M365_CLIENT_SECRET=YOUR_SECRET \
  --env M365_TENANT_ID=YOUR_TENANT \
  celavii-m365 -- npx -y celavii-m365@latest

Azure AD安装程序

注： 如果您不是IT管理员，请让您的Microsoft 365管理员执行此步骤，并与您共享客户端ID、客户端密码和租户ID。

1. 首选 Azure门户>应用程序注册
2. 点击 新注册
3. 设置名称（例如，“Celavii M365 MCP”）
4. 集 重定向URI 到 http://localhost:3333/auth/callback （网络平台）
5. 在...之下 证书和秘密，创建新的客户端机密--复制 价值 （不是秘密ID！）
6. 在...之下 API权限，添加这些Microsoft Graph权限：
   • Mail.Read, Mail.ReadWrite, Mail.Send
   • User.Read
   • Calendars.Read, Calendars.ReadWrite
   • Files.Read, Files.ReadWrite
7. 点击 授予管理员同意 （或让管理员来做）
8. 复制这三个值：
   • 应用程序（客户端）ID → M365_CLIENT_ID
   • 客户端机密值 → M365_CLIENT_SECRET
   • 目录（租户）ID → M365_TENANT_ID

运作原理

建筑

MCP服务器支持两种传输模式：

协作设置流程

./setup-cowork.sh
       │
       ├── npm install && npm run build (if needed)
       ├── build-plugin.sh --skills-only → plugin ZIP (skills only, no MCP)
       ├── Start HTTP MCP server (port 3333)
       ├── cloudflared tunnel → https://xxx.trycloudflare.com
       ├── Open browser for OAuth sign-in
       │
       └── Output:
             1. Upload plugin ZIP for skills
             2. Add custom connector: https://xxx.trycloudflare.com/mcp

HTTP服务器端点

环境变量

持久隧道设置

快速隧道(setup-cowork.sh)生成一个随机URL，每次重新启动时都会更改。对于永久URL：

1. 创建免费 Cloudflare帐户 并添加域

2. 登录并创建一个命名隧道：

   复制

   cloudflared tunnel login
   cloudflared tunnel create celavii-m365
   cloudflared tunnel route dns celavii-m365 mcp.yourdomain.com
   

3. 创建 ~/.cloudflared/config.yml:

   复制

   tunnel: <TUNNEL_ID>
   credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
   
   ingress:
     - hostname: mcp.yourdomain.com
       service: http://localhost:3333
     - service: http_status:404
   

4. 使用允许的主机启动服务器：

   复制

   M365_CLIENT_ID=... M365_CLIENT_SECRET=... M365_TENANT_ID=... \
   M365_ALLOWED_HOSTS=mcp.yourdomain.com \
   node mcp/dist/remote/index.js &
   
   cloudflared tunnel run celavii-m365
   

5. 在Claude Desktop中设置连接器URL 到 https://mcp.yourdomain.com/mcp --这个URL永远不会改变。

启动时运行（macOS）

要在重新启动时保持MCP服务器和隧道运行，请将其安装为macOS启动代理：

./install-service.sh \
  --client-id YOUR_CLIENT_ID \
  --secret YOUR_CLIENT_SECRET \
  --tenant-id YOUR_TENANT_ID \
  --hostname mcp.yourdomain.com \
  --tunnel-id YOUR_TUNNEL_ID

这将创建两个启动代理，它们在登录时自动启动，并在崩溃时重新启动：

• com.celavii.m365-mcp --端口3333上的HTTP MCP服务器
• com.celavii.m365-tunnel --Cloudflare命名隧道

要管理它们：

# View logs
tail -f ~/.celavii-m365-mcp.log
tail -f ~/.celavii-m365-tunnel.log

# Stop
launchctl unload ~/Library/LaunchAgents/com.celavii.m365-mcp.plist
launchctl unload ~/Library/LaunchAgents/com.celavii.m365-tunnel.plist

# Uninstall
./install-service.sh --uninstall

全部37个工具

脚本

安全

• 令牌存储：令牌存储在 0600 权限（仅限所有者读/写）
• HTML净化：邮件正文经过消毒，防止及时注射
• OData逃逸：过滤器中的用户输入已正确转义，以防止注入
• CSRF保护：OAuth状态参数已验证，有效期为10分钟
• URL中没有秘密：访问令牌仅在授权标头中发送

故障排除

发展

cd mcp
npm install
npm run build        # Build with tsup
npm run typecheck    # Type check
npm run dev          # Watch mode

项目结构

celavii-m365/
  .claude-plugin/       Plugin manifest
  .mcp.json             MCP server config (template)
  skills/               6 Agent Skills (domain guides)
  setup-cowork.sh       Cowork/Chat one-command setup
  build-plugin.sh       Plugin ZIP builder
  install.sh            Cross-IDE installer
  mcp/                  TypeScript MCP server
    src/
      index.ts          Stdio entry point + embedded auth server
      remote/index.ts   HTTP Streamable entry point
      server.ts         Server factory + tool registration
      client.ts         GraphClient (Graph API + Flow API)
      types.ts          Shared types and constants
      auth-server.ts    Standalone OAuth server
      auth/token-store.ts  Token persistence + refresh
      tools/            35 MCP tools across 7 modules
      utils/            Folder resolution + formatters

贡献

欢迎投稿！请打开问题或PR。

许可证

麻省理工学院——见 许可证.