注册 MCP 端点：Claude Code / Cursor / Codex 与 OAuth

你将得到什么

• 在 Claude Code、Cursor 或 Codex 中挂好名为 appsignal 的远程 MCP
• 一次成功的鉴权：浏览器 OAuth，或 Account Settings → MCP Tokens 生成的 Bearer Token
• 用一句提示词验证：Agent 能列出你的 app_name/app_environment

开始前准备

1. 可登录的 AppSignal 账号，且组织下至少有一个已接入、正在上报的应用（否则验证步会看到空列表）。
2. 任选其一客户端：Claude Code（终端）、Cursor、Codex CLI；可选 VS Code / Gemini CLI / GitHub Copilot CLI（官方 Docs 均有章节）。
3. 先打开通读：https://docs.appsignal.com/mcp/setup

核心事实（先记住）

步骤 1：Claude Code 注册（推荐 OAuth）

按官方 Claude Code 小节：

claude mcp add --transport http appsignal https://appsignal.com/api/mcp

说明（官方强调）：

• 必须带 --transport http，否则 Claude Code 会把 URL 当成本地 STDIO 程序去跑。
• OAuth 路径：首次调用 AppSignal 工具时，Claude Code 会打开浏览器登录；在 AppSignal 页选择组织与要暴露的应用，再 Allow access。
• 若使用 Bearer Token，改为：

claude mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer <YOUR_MCP_TOKEN>"

把 <YOUR_MCP_TOKEN> 换成你在 MCP Tokens 页生成的真实值；不要把 Token 提交到 Git 或发到聊天群。

然后新开 Claude Code 会话，执行：

claude mcp list

对照结果：列表中 appsignal 显示为 Connected / ✔（文案以你客户端版本为准）。若在 VS Code 内嵌 Claude Code，也可在聊天里运行 /mcp，对 Needs Auth 的项点 Authenticate；仍卡住时按官方用终端执行 claude mcp login "claude.ai AppSignal"。

步骤 2：Cursor 注册

按官方 Cursor 小节，编辑用户级 ~/.cursor/mcp.json（Settings → Customize → MCPs → + Add New MCP Server → User）：

OAuth（推荐，无 headers）：

{
  "mcpServers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp"
    }
  }
}

Bearer Token：

{
  "mcpServers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

保存后，Cursor 对 OAuth 会打开浏览器授权；成功后在 MCPs 列表里 appsignal 应出现在 Connected，带绿色指示与工具数量。

步骤 3：（可选）Codex / VS Code

Codex（OAuth）：

codex mcp add appsignal --url https://appsignal.com/api/mcp

官方说明：添加过程中会打开 AppSignal 授权页；之后可用 codex mcp list 核对，Auth 列显示 OAuth 或 Bearer token。

VS Code（用户或工作区 mcp.json，OAuth 示例）：

{
  "servers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "type": "http"
    }
  }
}

VS Code 按需启动 MCP；打开 Copilot Chat 并使用工具后才会看到运行状态。

步骤 4：验证连接

在已连接的客户端里发送：

List my AppSignal applications

对照结果：返回若干 app_name/app_environment 对（例如 MyStore/production）。若提示无应用：

1. 核对 OAuth 时是否选对了组织；
2. Token 是否勾选了目标应用；
3. 应用是否已向 AppSignal 上报数据。

本课小结

下一课用这些应用名做只读错误与性能排查。