CIPP MCP - Microsoft 365, Entra ID, Intune, Exchange, Defender, GDAP

CIPP + AI：适用于 Microsoft 365、Entra ID、Intune、Exchange、Defender 和 GDAP 的 MCP 服务——面向 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini 以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 CIPP API 的 MCP 服务。与 CyberDrain 无关联，未获其认可或赞助。

_{▶ 观看 30 秒演示——演示数据为模拟数据；展示的每条命令都存在于真实的 CLI 中。}

CIPP 的 MCP 服务和 CLI——面向所有客户端租户中的 Microsoft 365、Entra ID、Intune、Exchange Online、Defender 和 GDAP，提供本地存储、跨端点离线关联以及历史记录。可与您已在使用的 AI 配合使用——ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot——还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

本页介绍的写入预览、只读开关、令牌保护的 HTTP 模式和本地数据控制功能，从 cipp 0.1.13 版起提供。请使用 cipp-cli --version 查看版本。

MSP 所有者实际使用的六种 Agent（可自行安装，现已可用）：

您的 AI Agent	如何安装 CIPP skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 cipp-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	运行安装程序，通过 HTTPS 托管 cipp-mcp 并设置 CIPP_MCP_HTTP_TOKEN，然后将其注册为 Developer Mode 连接器（前提是您的连接器设置可以发送 bearer token）。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 cipp-mcp，然后选择 Agent 模式。

对于 ChatGPT，请在 HTTPS 主机上运行设置了 CIPP_MCP_HTTP_TOKEN 的 cipp-mcp --transport http；每个请求都会发送该令牌。参见 mcp-install.md。

同样适用于 Microsoft 和 Google 技术栈

用户群很大，但需要如实说明：这属于远程 / 企业接入方式，而不是您刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	**不可自行安装。**通过 HTTPS 托管设置了 CIPP_MCP_HTTP_TOKEN 的 cipp-mcp，然后将其接入 Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）或声明式 Agent（前提是它可以发送 bearer token）。需要 Copilot Studio 许可证和租户管理员权限。参见 mcp-install.md。
Google Gemini	Gemini CLI 在本地运行——与 Claude Code 相同。Gemini 应用通过远程方式运行——与 ChatGPT 一样使用 HTTPS 接入方式。参见 mcp-install.md。

原生支持 Skill 的 Agent（同样适用）：Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装章节。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 配合使用。各工具的完整接入指南：docs/which-agent.md。

**需要使用多个 Agent？**运行一条命令，即可在 51 种以上受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后为 CLI/MCP 二进制文件运行每个 Skill 的安装程序）。参见 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快捷方式 - 一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 cipp-cli。自 2026-09-18 起发布的版本会将该 CLI 打包在安装包中；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 CIPP_CLI_PATH 设置为现有二进制文件）。详情：＃331。

下载 CIPP MCP（.mcpb） - 然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需命令行。（在发布页面浏览所有 CIPP 版本。）

更喜欢 Claude Code 插件？添加一次市场，然后安装即可 - 立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install cipp@msp-skills

路径 A - 在 AI Agent 中粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork：

在此 Agent 工作区中安装来自 Servosity/msp-skills 的 CIPP Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.ps1 | iex。然后按照 README 进行身份验证，并运行 cipp-cli --help 进行探索。

这条提示词适用于任何能够运行 shell 的 Agent。

路径 B - 自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.sh)

安装程序会将 cipp-cli（CLI）和 cipp-mcp（MCP 服务）放入你的用户 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

cipp-cli --version

升级到最新版本

安装程序始终会获取当前版本 - 重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/cipp/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），然后在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update cipp@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

运行安装程序后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式 - 每个 Agent 都有单独的章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的接入方式。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；mcp-install.md 中记录了 MCP 配置代码块（适合偏好编辑 JSON 的用户）。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/cipp --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/cipp --force

Hermes 原生支持 MCP，因此也可以直接使用 cipp-mcp 服务 - 安装方式和环境变量相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/cipp 安装 cipp skill。该 skill 会说明如何通过 openclaw: frontmatter 块安装其必需的 CLI（cipp-cli）。

OpenClaw 目前尚未全面开放；frontmatter 接线配置已预先打包，OpenClaw 一经发布便会启用。

身份验证

CIPP 采用可自托管方式，因此 CLI 需要你的实例 API 基础 URL（CIPP 显示给你的值，以 /api 结尾），以及你在 CIPP 的 Integrations > CIPP-API 下创建的 API 客户端凭据。让 CLI 执行 OAuth2 客户端凭据交换，并从 stdin 读取客户端密钥，使其不会留在 shell 历史记录中：

cipp-cli auth login --client-id 00000000-0000-0000-0000-000000000000 --tenant-id 00000000-0000-0000-0000-000000000001 --base-url https://cipp.yourmsp.com/api --client-secret - < secret.txt

或者在环境中设置 bearer token。

macOS / Linux：

CIPP_API_KEY=<value> CIPP_BASE_URL=https://cipp.yourmsp.com/api cipp-cli doctor

Windows (PowerShell)：

$env:CIPP_API_KEY = "<value>"; $env:CIPP_BASE_URL = "https://cipp.yourmsp.com/api"; cipp-cli doctor

doctor 会使用你的凭据调用一个真实的 CIPP 端点，并显示 CLI 保存文件的位置。即使凭据被拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此工具的用途

MSP 经常提出的问题	命令
哪些租户有尚未注册 MFA 的用户，且每个租户占一行？	cipp-cli posture --dimension mfa
所有租户的 Conditional Access 配置有何差异？	cipp-cli posture --dimension ca
哪些租户缺少大多数租户都有的 Conditional Access 策略？	cipp-cli ca diff
哪些委派管理员（GDAP）关系将在未来 30 天内到期？	cipp-cli gdap expiring --days 30
自上周以来，管理员角色有哪些变化？	cipp-cli changes --resource roles --since 7d
单个客户租户的所有存储信息，汇总为一条记录	cipp-cli scorecard --tenant contoso.onmicrosoft.com
从每个客户租户读取一项数据，并在本地保存	cipp-cli fanout --endpoint /ListMFAUsers --all-tenants --save
在执行任何操作前，先规划 CSV 中的一批离职账户停用任务	cipp-cli bulk --from offboards.csv
删除本地存储、响应缓存和学习日志	cipp-cli local-data purge --yes
我的 CIPP 凭据和连接是否正常？	cipp-cli doctor

汇总命令（posture、ca diff、changes、scorecard）会读取本地存储，因此请先对它们所需的端点运行 fanout --save；每个命令的 --help 都会列出这些端点。只要响应中的任何内容被判定为失败，fanout --save 就会拒绝该租户的响应：任何深度的类状态字段（state、status、result、message、text、detail、reason 等）中的失败用语或失败状态（例如 "status":{"code":"error"}），单独出现的消息，值非空且名称类似 error、exception 或 fault 的字段（例如 "error":"HTTP 403"，无论具体用语如何），值为 false 的名称类似 success 或 ok 的字段，或行内及行旁的失败状态；已存储的行会保留。它只会存储一个列表，且列表中的每一项都必须包含该端点的 id；JSON null、空响应、单个对象或消息会显示出来，但不会存储。在租户列表中且仅限于此处，租户记录会保留各自的 Graph token 字段（LastGraphError、GraphErrorCount），因此某个租户的 Graph token 失败不会阻断整个租户群。包含重复键的响应会被拒绝。行自身名称中包含失败用语（例如名为 "Error Reporting" 的用户、名为 "Denied Access" 的组）时，该行仍会被视为有效数据。取舍是：如果列表中的行报告了自身的失败状态，该列表也会被拒绝；运行相同的 fanout 命令并添加 --json，即可查看 CIPP 返回的内容。完整命令参考：guide.md。AI Agent 操作规范（--agent、--dry-run，以及何时需要在执行变更前确认）请参阅 AGENTS.md。

有何不同

CIPP 已能自行回答整个环境范围的问题。其「所有租户」视图涵盖 MFA 报告、标准对齐情况和许可证报告；其 API 在 tenantFilter=AllTenants 时会返回整个环境范围的响应；它还自带 MCP 服务。如果其中任何一项能回答你的问题，就使用它：只需调用一次，数据来自 CIPP 的报告缓存。

这个连接器的工作方式不同：它是本地优先的。fanout 会针对每个租户各运行一次 CIPP 读取操作；加上 --save 后，还会将数据行保存在你机器上的 SQLite 文件中，每次保存都会生成一个带日期的快照。然后，你的 Agent 就能离线搜索、关联和比较这份副本——在 posture 中查看按租户划分的 MFA 或 Conditional Access 表，在 scorecard 中查看某个租户的所有已存信号，在 ca diff 中查看某个租户缺少的策略，在 changes 和 standards drift 中查看你自己的历史快照——无需再次调用 API。你已经可以通过 CIPP 获取这些数据；这个连接器只是将副本放到 Agent 能够跨数据操作的地方。它也支持 CIPP 的完整命令集，包括写入操作：在 MCP 服务中，任何会更改内容的 CIPP API 调用都会先返回预览，只有在 Agent 确认后才会执行。

这种工作方式确实有代价：每个租户都要调用一次，而不是整个环境只调用一次；此外，磁盘上还会保存一份租户数据副本。下一节会说明数据存放位置以及如何删除。

数据存放位置

本地副本是刻意保留的（Agent 会搜索和关联这些数据），而且未加密。新文件仅允许你的账户读取；除此之外，数据保护依赖操作系统账户权限和全盘加密（BitLocker、FileVault）。

• 本地存储： CLI 数据目录中的 data*.db SQLite 文件，由 fanout --save 和默认的 --data-source auto 模式下的读取操作填充。
• 响应缓存： http/ 缓存目录中的 GET 响应，保留五分钟。过期文件会在之后的某次运行中删除。
• 凭据： 数据目录中的 credentials.toml。运行 auth login 后，其中会保存 API 客户端的密钥（供 CLI 获取新令牌）和当前令牌。设置 CIPP_NO_CONFIG_WRITE=1 后，auth login 会拒绝运行，也不会保存任何内容；请改为设置 CIPP_API_KEY。
• 学习日志： 在状态目录的 learn/ 中记录你运行过的命令。设置 CIPP_NO_LEARN=1 可关闭此功能。
• 恢复检查点： fanout --resume 会在状态目录中保存已完成处理的租户域名。
• cipp-cli doctor 会输出你机器上的各个路径。

在显示或缓存成功响应之前，CLI 会先检查其中是否包含你配置的凭据（API 密钥、客户端密钥、获取的令牌），并检查所有 CLI 能解码的编码形式；检查前会先移除空格和不可见字符。如果移除空格后，响应中有任何单个值超过 64 KiB，或者响应不是 JSON 且大小超过 64 KiB，就不会返回该响应，因为无法完整解码；请直接在 CIPP 中读取该值。

若要删除本地存储、缓存和日志，请运行 cipp-cli local-data purge（列出将删除的内容），然后运行 cipp-cli local-data purge --yes；cipp-cli auth logout 会删除已存储的凭据。若不希望在本地保留任何 CIPP 数据，请设置 CIPP_NO_LOCAL_DATA=1：读取操作会实时进行，响应缓存会关闭，且 fanout --save 和 fanout --resume 会拒绝运行。在 Claude Desktop 中，这对应扩展的 不使用本地副本运行 设置；对于其他 MCP 宿主，请将此设置放入服务的 env 区块。

技术人员离职时，在 CIPP 中撤销其访问权限不会影响已经存储在其机器上的数据：请在其机器上运行 cipp-cli auth logout 和 cipp-cli local-data purge --yes，删除 CLI 状态目录中的 checkpoints 文件夹，并在 CIPP 中轮换 API 客户端的密钥。

弥补的痛点

CIPP 自带的视图可以解答有关当前状态的问题。AI Agent 仅凭实时答复开展工作时，每次提问都得从头开始；要比较本季度和上季度的情况，你还得自行保存带日期的副本。通过脚本使用 CIPP 也有成本：根据 CIPP API 文档，每个 API 客户端每 10 秒最多只能发出 100 个请求；而且有些写入端点会返回 HTTP 200，却把失败信息写在响应的 Results 中，因此必须读取每个响应才能知道批处理的结果。

• cipp-cli fanout --endpoint /ListMFAUsers --all-tenants --save - 对每个租户执行一次读取，将结果保存为本地带日期的快照，并处理 HTTP 429 的 Retry-After；中断后可使用 --resume 继续。
• cipp-cli posture --dimension mfa（也支持 ca、standards、dlp、retention、labels）- 根据已保存的行，生成按租户和指标排列的表格。
• cipp-cli ca diff - 找出某个租户缺少、而大多数其他租户都有的条件访问策略。
• cipp-cli changes --resource roles --since 7d - 对比你自己的两个快照，列出新增、删除或更改的行。
• cipp-cli bulk --from offboards.csv --execute - 根据 CSV 批量执行用户和邮箱操作：不带 --execute 时仅生成计划；如果 CIPP 在 HTTP 200 响应中报告失败，则以非零状态码退出；每行操作均可使用 --resume 继续。

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

可以，支持 Plus、Pro、Team、Business、Enterprise 和 Education 方案（Free 方案目前尚未开放 Developer Mode）。ChatGPT 通过 HTTPS 连接 远程 MCP 服务，而不是本地 stdio 二进制程序。CIPP MCP 服务默认通过本地 stdio 运行。其 HTTP 模式（cipp-mcp --transport http）会提供 http://127.0.0.1:7777/mcp，在设置 CIPP_MCP_HTTP_TOKEN 之前拒绝启动；每个请求都必须包含 Authorization: Bearer <token>，且使用其他地址时需要提供 --tls-cert/--tls-key。分步说明见 mcp-install.md。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的矩阵，深入介绍请参阅 docs/which-agent.md。

我需要会编程吗？

不需要。推荐的安装方式是将一句话粘贴到 Claude Code 或 Codex 中——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是使用适用于各操作系统的一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 CIPP 凭据。

我的 CIPP 数据安全吗？

CLI 和 MCP 服务在你的计算机上运行，且只与你的 CIPP 实例通信；MSP Skills 不会收到任何数据。但连接器会在本地保留读取内容的未加密副本，因此任何能够读取你用户配置文件的人都能读取该副本。数据存放位置列出了相关文件、删除方法，以及如何在不保留本地副本的情况下运行（CIPP_NO_LOCAL_DATA=1）。

CIPP 不是已经能显示所有租户的这些信息了吗？

很多情况下，是的。CIPP 的 All Tenants 视图会显示整个环境的 MFA 报告、标准合规情况和许可证报告；其自带的 MCP 服务也能查询 AllTenants。此连接器并非要取代这些功能，而是保存本地带日期的副本，让 Agent 能够关联不同端点的数据，并离线比较你自己的快照；它还会通过先预览、再确认的步骤，让 Agent 调用 CIPP 的写入端点。

使用此工具需要有自己的 CIPP 实例吗？

需要——此工具会调用你自己可自托管的 CIPP 实例 API。在 CIPP 中创建 API 客户端后，系统会发放客户端 ID、密钥、租户 ID 和令牌 URL；CLI 使用 cipp-cli auth login 通过 OAuth2 客户端凭据进行身份验证，也可以将持有者令牌通过管道传递给 cipp-cli auth set-token。此工具通过你的 CIPP 读取数据并执行操作，不会取代它。

这会触及 CIPP 的 API 速率限制吗？

有可能：fanout 会为每个租户发起一次调用，而 CIPP 对每个 API 客户端的限制是每 10 秒 100 次请求。客户端会根据 Retry-After 等待 HTTP 429 状态解除，--concurrency 用于设置同时运行的租户数量，--resume 会跳过已在暂停的运行中完成的租户。保存行后，汇总会读取本地存储，不会发起任何 API 调用。

这会更改我的租户，还是只读取？

两者都会。CIPP 是完整的管理 API，因此 CLI 可以创建用户、执行离职处理、设置转发等。在 MCP 服务中，任何会更改内容的 CIPP API 调用都会先返回预览，只有 Agent 确认后才会执行；设置 CIPP_MCP_READ_ONLY=1 后，服务会移除写入工具。在命令行中，bulk 默认只生成计划，只有使用 --execute 才会写入；其他写入命令则会通过 --dry-run 预览。最有力的边界仍然是你在 CIPP 中授予 API 客户端的角色。

它会取代 CIPP 门户吗？

不会。CIPP 仍是你的门户。此连接器让 AI Agent 能够基于 CIPP 返回内容的本地副本开展工作，并通过自然语言操作 CIPP。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为所用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 提供商收取，而非我们收取。

安全模型

等级	示例	建议的 Agent 策略
读取（汇总和列表）	cipp-cli posture --dimension mfa、cipp-cli ca diff、cipp-cli gdap expiring --days 30、cipp-cli fanout --endpoint /ListUsers --all-tenants、cipp-cli list-tenants、cipp-cli doctor	允许
写入（日常操作）	cipp-cli add-user、cipp-cli edit-user、cipp-cli bulk --from changes.csv --execute（默认生成计划；只有使用 --execute 才会写入）	使用 --dry-run 预览，然后执行经过审核的写入
凭据 / 安全	cipp-cli exec-reset-mfa、cipp-cli exec-per-user-mfa、cipp-cli exec-get-local-admin-password、cipp-cli exec-token-exchange	仅限人工参与
破坏性操作	cipp-cli exec-offboard-user、cipp-cli remove-user、cipp-cli exec-device-delete、cipp-cli delete-sharepoint-site	仅限人工参与，并需明确确认

部分 CIPP 端点通过 GET 调用，但会更改内容（例如 RemoveStandard、ExecSendOrgMessage、ExecRunBackup）。MCP 服务会将这些端点（此版本中共 43 个）全部视为需要确认的更改操作，并拒绝对它们执行 fanout、export 和 tail。命令行上的类型化写入命令会输出 CIPP 的 Results 文本，即使该文本报告失败也会以退出码 0 结束，因此在报告成功前请先阅读该文本；bulk 和 cipp_execute 会将此类失败转换为错误。最有力的控制措施是你授予 CIPP 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何锁定权限）请参阅 governance.md。

状态

已在线验证：Bearium Networks（MSP）的 Abhi Saini 于 2026-08-13 针对一个在线 CIPP 租户运行了跨租户 fanout（凭证）。更多 MSP 会在我们的每周 Build Sessions 中在线运行此工具。请通过 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-10-23。