---
title: "安装 Sentry Codex 插件"
summary: "从 getsentry/plugin-codex 安装 sentry@sentry-plugin-marketplace。插件自动登记 mcp.sentry.dev/mcp。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["plugins", "Sentry", "Skills", "MCP"]
canonical: /tips/sentry-codex-plugin/
---

# 安装 Sentry Codex 插件

从 getsentry/plugin-codex 安装 sentry@sentry-plugin-marketplace。插件自动登记 mcp.sentry.dev/mcp。

Sentry 插件用 marketplace 加 getsentry/plugin-codex，再 plugin add sentry@sentry-plugin-marketplace。Cookbook 的 Native install 提供 Codex 安装命令；仓库 README 相同。这是技能库加托管 MCP，不是只跑 `mcp add sentry --url` 那条。

清单 `.agents/plugins/marketplace.json` 的 name 是 `sentry-plugin-marketplace`，插件 name 是 `sentry`，所以是 `sentry@sentry-plugin-marketplace`。插件本体在 `./plugins/sentry`，不要把仓根或 `getsentry/sentry-for-ai` 源代码仓库当成 marketplace 根。

```bash
codex plugin marketplace add getsentry/plugin-codex
codex plugin add sentry@sentry-plugin-marketplace
codex plugin list --json
```

策略是 `ON_INSTALL`：装上应弹出 Sentry OAuth。插件 `.mcp.json` 登记的是 `https://mcp.sentry.dev/mcp?utm_source=plugin`，主机仍是 `mcp.sentry.dev`，带 `/mcp`。已经手写过 `[mcp_servers.sentry]` 就不要和插件那张重复配置。只要远程 MCP、不装技能时，继续走 `mcp add sentry --url https://mcp.sentry.dev/mcp` 再 `mcp login sentry`。

不要默认把文档花括号占位抄进 URL。接到某个 org 或项目时，写成真实 slug，例如 `https://mcp.sentry.dev/mcp/my-org/my-project`。按需添加 `?experimental=1`。

升级先刷新清单，再重新 `plugin add`。Codex **没有** `plugin update`：

```bash
codex plugin marketplace upgrade sentry-plugin-marketplace
codex plugin add sentry@sentry-plugin-marketplace
```

名字以 `codex plugin marketplace list` 为准。`plugin-codex` 是发行仓库，技能修改应提交到 `getsentry/sentry-for-ai`，不要直接改这份发行仓。

Cookbook 还有 `npx @sentry/ai install`，文档页是 `npx @sentry/agent-plugin install`。两条都会侦测本机所有支持的助手并改它们，**不是** Codex 专节。只要 Codex 时跑上面的两条 `plugin` 命令。不要把 `npx skills add` 当这份插件安装器。

少数入口技能默认可见，其余用 Codex 的 `agents/openai.yaml` 关掉隐式调用，按需调用。回 PR 评论还要本机 `gh`。错误正文是攻击者可写的输入，从 Sentry 拉来的内容修 bug 时执行操作时保留工具审批。

0.154 起可先检查当前会话；未显示插件时再新开会话。IDE 扩展没有 `/plugins`，用 CLI 加完再到 TUI 或桌面去装。网页 Cloud 不读取本机 `CODEX_HOME` 插件缓存。配置后用 `codex plugin list` 核对 `sentry@sentry-plugin-marketplace`。

## 来源

- [getsentry/plugin-codex](https://github.com/getsentry/plugin-codex)
- [Sentry · Install the plugin in your coding agent](https://sentry.io/cookbook/install-sentry-plugin-coding-agent/)
- [Sentry · Agent Plugin](https://docs.sentry.io/ai/agent-plugin/)