使用 API key 连接 Checkly MCP
连接 api.checklyhq.com/mcp,通过 CHECKLY_API_KEY 提供 Bearer 凭据,无需 OAuth 登录。
Checkly MCP 走 api.checklyhq.com/mcp 加 bearer,无需 OAuth 登录。官方 setup 页提供 Codex 安装说明:Checkly 没有批准的 Codex OAuth 客户端,DCR 也无法使用。主路径是用户或服务 API key,当成 HTTP bearer,不是 mcp login。
先在 User Settings → API keys 创建用户 API key(cu_ 开头)。企业号才用 Account Settings 里的服务密钥(sv_ 开头)。旧账号 key 和 sk_ 无法使用。
CHECKLY_API_KEY 必须在启动 Codex 的那个进程里。Dock / 开始菜单打开的桌面读不到 zshrc。然后:
export CHECKLY_API_KEY=YOUR_CHECKLY_API_KEY
codex mcp add checkly --url https://api.checklyhq.com/mcp --bearer-token-env-var CHECKLY_API_KEY
[mcp_servers.checkly]
url = "https://api.checklyhq.com/mcp"
bearer_token_env_var = "CHECKLY_API_KEY"
enabled = true
用户配置中的服务名是 checkly。URL 带 /mcp 后缀。键里填的是变量名,不是 token。不要把 cu_ / sv_ 写进 http_headers、args、env 表或 URL。这是 bearer,不要 codex mcp login checkly。
多账号登录时需选择账户。固定账户用 X-Checkly-Account,Codex 走 env_http_headers,不要抄 Claude 的 --header:
[mcp_servers.checkly.env_http_headers]
X-Checkly-Account = "CHECKLY_ACCOUNT_ID"
CHECKLY_ACCOUNT_ID 同样是进程环境变量名。服务密钥已经绑定单个账户,一般不必再加该请求头。API key 会话没有邀请成员工具。
验证句:Use Checkly to show which accounts I can access. 触发检查、开 incident 保留操作审批。
远程 MCP 碰不到本机文件系统,不能写、打包或部署检查代码。本地脚手架走:
npx checkly skills install --target=codex
那会装 SKILL.md,不是 MCP 安装器。npx skills add checkly/checkly-cli 也只拷技能。
插件仓是技能 + MCP 的捆。官方 Codex README 是:
codex plugin marketplace add checkly/checkly-plugin
再打开 TUI /plugins 启用 Checkly。插件 .mcp.json 只写了 OAuth scopes,没有 bearer;Codex 没有批准的 OAuth 客户端,装完插件仍要给 checkly 表补 bearer_token_env_var。已经 mcp add checkly 就不要再重复配置同 URL 的表。npx plugins add checkly/checkly-plugin 不是 Codex 主路径。
网页 Cloud 不读取 ~/.codex/config.toml。配置后重新打开会话。用 codex mcp get checkly 看传输是 streamable_http,url 是 https://api.checklyhq.com/mcp,Auth 是 Bearer。/mcp 只是核对工具,不是登录入口。