Better Stack MCP

Better Stack + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini 以及任何支持 MCP 的 Agent

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

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

提供 Better Stack Uptime 的所有功能，另有离线 SQLite 镜像和跨资源的服务群组分析——API 本身无法回答的问题：哪些服务中断、哪些人收到告警、覆盖盲区、MTTA/MTTR、告警抖动、值班空缺以及状态页偏差。可与您已在使用的 AI 配合工作——ChatGPT（Plus/Pro+，在此连接器重新发布前暂停使用；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码保护， 会监听所有网络接口，且早于浏览器重绑定防护机制， 因此您打开的网页可以访问它。MCP 工具也可以使用您的凭据进行更改。 请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了隧道，请将其关闭。修复即将推出。

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

您的 AI Agent	如何安装 Better Stack skill
Claude Desktop	运行安装程序，然后通过 Settings > Extensions 注册 betterstack-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，且可被您打开的网页访问。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 betterstack-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停使用：此版本的该模式无需密码，会监听所有网络接口，且可被您打开的网页访问。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈也适用

安装量很大，但请注意：这属于远程 / 企业级方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停提供，直到重新打包此连接器：Copilot Studio 需要使用 HTTP 模式，而在此版本中，该模式不要求密码、会监听所有网络接口，并且可从你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行——与 Claude Code 相同。Gemini 应用在远程运行，需要使用与 ChatGPT 相同的暂停提供的 HTTP 模式。请参阅 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，然后运行各 Skill 的安装程序来安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

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

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

下载 Better Stack MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需使用 shell。（请在发布页面浏览所有 Better Stack 版本。）

想使用 Claude Code 插件？添加一次市场源，然后安装即可——立即生效，无需列出目录：

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

路径 A——向 AI Agent 粘贴一条提示词（推荐）

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

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

任何能够运行 shell 的 Agent 都可以使用同一条提示词。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

验证：

betterstack-cli --version

升级到最新版本

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update betterstack@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 面板是最简单的方式；对于喜欢编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

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

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/betterstack --force

Hermes 原生支持 MCP，因此也可以直接使用 betterstack-mcp 服务——安装路径和环境变量都相同。

为 OpenClaw 安装

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

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

OpenClaw 尚未普遍开放；frontmatter 接线已预先配置，OpenClaw 一经发布便会立即启用。

身份验证

设置 CLI 所需的凭据（可从 Better Stack 门户获取）：

BETTERSTACK_API_TOKEN=<value> betterstack-cli doctor

运行任何会操作数据的命令前，doctor 会确认凭据是否有效。即使凭据遭到拒绝，它也会以 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 常问的问题	命令
现在有哪些服务宕机？真的有人收到告警了吗？	betterstack-cli down
哪些监控器故障时不会通知任何人？	betterstack-cli coverage
过去 30 天内，按监控器统计的 MTTA 和 MTTR 是多少？	betterstack-cli mttr --days 30 --by-monitor --top 10
上周哪些监控器的告警最频繁？	betterstack-cli flapping --days 7 --top 10
现在真的有人值班吗？还是存在值班空缺？	betterstack-cli oncall-gaps
哪些心跳最可能出现静默遗漏？	betterstack-cli heartbeat-risk --top 10
是否有状态页显示正常，但监控器仍有未解决事件？	betterstack-cli statuspage-audit
现在各客户端组的健康状况如何？	betterstack-cli group-health
给我一份覆盖整个账户的健康概览。	betterstack-cli fleet
哪些未解决事件持续时间最长且仍未确认？	betterstack-cli triage

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run、修改前何时需要确认），请参阅 AGENTS.md。

有何不同

大多数 Better Stack 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样做没问题。但当规模扩大，比如要问“我在所有客户端中的 200 个监控器里，哪些故障时不会通知任何人？”或“上个季度我们按监控器统计的实际 MTTA/MTTR 是多少？”，这种方式就不够用了。

此技能会将 Better Stack 同步到带有全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地 SQL 联接：响应迅速、可离线使用，而且 AI 看到的是答案，而不是原始数据。coverage、mttr 和 statuspage-audit 等复合命令会跨监控器、心跳、事件、升级策略、值班日历和状态页进行联接——这是无状态 API 封装无法做到的。

它解决的痛点

监控泛滥和告警疲劳一直是 MSP 社区反复提及的问题——r/msp 和 MSPGeek 上关于“监控噪声”“告警疲劳”以及“到底是谁在接收告警”的讨论层出不穷。面对数十个客户账户：

• 某个监控器没有升级策略，凌晨 2 点发生故障，却没有人收到告警。直到客户打电话来，你才会发现。betterstack-cli coverage 会列出所有发生故障时无人收到告警的监控器。
• 反复抖动的监控器让值班技术人员一夜又一夜被叫醒，直到大家开始忽略告警。betterstack-cli flapping --days 7 --top 10 会列出噪声最大的来源并排序。
• 当前轮值没有任何人在值班。betterstack-cli oncall-gaps 会标记出来。
• 状态页显示“运行正常”，但底层监控器却有一个未解决的事件。betterstack-cli statuspage-audit 会发现这种不一致。
• 季度业务回顾（QBR）时间到了，你需要真实数据。betterstack-cli mttr --days 30 --by-monitor 会根据本地镜像计算 MTTA/MTTR。

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

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不行。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放开发者模式）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Better Stack MCP 服务。当前版本的 HTTP 模式无需密码，会监听所有网络接口，并且你打开的网页也能访问它，因此在连接器重新发布之前，请勿运行该模式或通过隧道将其公开；原因请参阅 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

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

可以——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明见 docs/which-agent.md。

我需要会编程吗？

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

我的 Better Stack 数据安全吗？

你的数据会保留在你的设备上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 绝不会将其打包进此仓库或传输到其他地方。

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

不会。此技能只会将数据同步一次到本地 SQLite 镜像，之后都从本地数据中回答问题，因此重复提问不会访问 API。只有 sync、实时写入操作，以及状态页资源扇出（供 statuspage-audit 使用）会调用 Better Stack。

我需要付费的 Better Stack 计划吗？

你需要一个带 API 令牌的 Better Stack 账户。分析会基于你的计划所包含的监控器、心跳、事件、值班日历和状态页运行——此技能会读取令牌有权访问的内容。

这会取代 Better Stack 门户吗？

不会，它是对门户的补充。门户仍然是配置监控器和查看实时状态的地方。此技能通过 AI 帮你回答那些需要在门户中逐步点击才能查到的跨账户问题——覆盖缺口、MTTA/MTTR、值班缺口和状态页不一致。

费用是多少？

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

安全模型

层级	示例	建议的 Agent 策略
读取	fleet、down、coverage、mttr、flapping、oncall-gaps、heartbeat-risk、statuspage-audit、group-health、triage、search、所有 list / get	允许
写入（常规）	monitors create/update、heartbeats create/update、monitor-groups create、heartbeat-groups create、policies create、status-pages create、status-page-sections create、incidents acknowledge/resolve、import	使用 --dry-run 预览，然后经审核后写入
破坏性操作 / 配置	monitors delete、heartbeats delete、incidents delete、policies delete、status-pages delete、status-page-sections delete、status-page-resources delete、monitor-groups delete、heartbeat-groups delete	仅允许人在环

最有力的控制措施是授予 Better Stack 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta 版。已根据 Better Stack API 功能进行验证，并正在每周 Build Sessions 中，与将其用于自身生产租户的 MSP 一起进行验证。请前往 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-06-07。