---
title: "使用 API key 连接 Checkly MCP"
summary: "连接 api.checklyhq.com/mcp，通过 CHECKLY_API_KEY 提供 Bearer 凭据，无需 OAuth 登录。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Checkly", "HTTP", "bearer"]
canonical: /tips/checkly-codex-mcp/
---

# 使用 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](https://www.checklyhq.com/docs/admin/creating-api-key) 创建用户 API key（`cu_` 开头）。企业号才用 Account Settings 里的服务密钥（`sv_` 开头）。旧账号 key 和 `sk_` 无法使用。

`CHECKLY_API_KEY` 必须在**启动 Codex 的那个进程**里。Dock / 开始菜单打开的桌面读不到 zshrc。然后：

```bash
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
```

```toml
[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`：

```toml
[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 **碰不到本机文件系统**，不能写、打包或部署检查代码。本地脚手架走：

```bash
npx checkly skills install --target=codex
```

那会装 SKILL.md，不是 MCP 安装器。`npx skills add checkly/checkly-cli` 也只拷技能。

插件仓是技能 + MCP 的捆。官方 Codex README 是：

```bash
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` 只是核对工具，不是登录入口。

## 来源

- [Checkly · Set up the MCP Server](https://www.checklyhq.com/docs/ai/mcp-server/setup/)
- [Checkly · Plugin for AI Coding Agents](https://www.checklyhq.com/docs/ai/plugin/)
- [checkly/checkly-plugin](https://github.com/checkly/checkly-plugin)
- [Checkly · Creating an API key](https://www.checklyhq.com/docs/admin/creating-api-key)