SnagRelay

面向编码 Agent 的 SnagRelay

用户发现 Bug，Agent 修复 Bug。给 Cursor、Claude Code 或 Codex 一个工单编号，它就会读取人工调试时会查看的证据：出问题的元素、带文件名和行号的控制台错误、包含请求和响应正文的失败请求、复现步骤，以及一段简短的回放。

此仓库是 SnagRelay MCP 服务的目录和分发仓库。其中包含各 Agent 平台的插件清单、共享技能和注册表条目。MCP 服务本身由 SnagRelay 托管，地址为 https://mcp.snagrelay.com/v1。

连接

通过 OAuth 登录。SnagRelay 页面会在浏览器中打开，点击允许即可，无需复制令牌。

客户端	安装
Cursor	打开自定义 → Marketplace，搜索 SnagRelay 并安装，然后点击 snagrelay MCP 服务上的需要身份验证
Claude Code	执行 claude plugin marketplace add snagrelay/agent-plugin，然后执行 claude plugin install snagrelay@snagrelay。运行 /mcp 并对 snagrelay 进行身份验证
Codex	执行 codex plugin marketplace add snagrelay/agent-plugin，然后执行 codex plugin add snagrelay@snagrelay。使用 codex mcp login snagrelay 登录
Lovable	前往设置 → 连接器 → 搜索 SnagRelay，或使用下方 URL 添加自定义 MCP 服务
Bolt	使用下方 URL 添加自定义远程 MCP 连接器
Replit	使用下方 URL 添加自定义 MCP 服务
其他平台	将任意 Streamable HTTP MCP 客户端指向 https://mcp.snagrelay.com/v1

Lovable、Bolt 和 Replit 的指南正在编写中；目前可使用自定义连接器方式。

对于 CI、脚本和其他无头客户端，请在 SnagRelay 中创建 API 令牌（设置 → API 令牌），并向同一 URL 发送 Authorization: Bearer <token>。

选哪个 URL？

四个 URL 共用同一个服务和同一种登录方式。请选择最适合你需求的 URL。

URL	适用场景
https://mcp.snagrelay.com/v1	你需要在多个项目间工作。默认选项
https://mcp.snagrelay.com/v1/readonly	你希望 Agent 读取问题，但绝不写入。写入工具（report_progress、mark_issue_resolved）会被移除并禁用。适合注重安全的团队和共用机器
https://mcp.snagrelay.com/v1/{projectId}	此仓库属于一个 SnagRelay 项目。范围已严格限定，因此 Agent 无法查看其他项目
https://mcp.snagrelay.com/v1/{projectId}/readonly	同时具备以上两种限制

{projectId} 是 whoami 返回的编号，或 SnagRelay 项目 URL 中的编号。

工具

工具	访问权限	功能
get_issue_context	读取	按工单编号获取单个问题的完整上下文：相关元素、复现步骤、带文件名和行号的控制台错误、请求正文，以及截图资源链接
get_issue_payload	读取	根据 get_issue_context 返回的索引，获取一份完整的请求或响应正文，或一条控制台记录
get_related_history	读取	获取同一屏幕或端点上的早期已解决问题，以及修复这些问题的 PR
find_issues	读取	在没有工单编号时列出或搜索问题
whoami	读取	已登录的账户、套餐和可访问的项目
report_progress	写入	告知 SnagRelay Agent 正在编辑哪个文件
mark_issue_resolved	写入	使用 PR、提交和分支信息将问题标记为已解决。还可选择通过电子邮件通知报告者

一个资源：screenshot，即问题截图，通过 resources/read 读取。

每个工具都包含 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。没有任何工具具有破坏性。系统指示 Agent 在你审查修复内容之前，不要调用 mark_issue_resolved。

用法

fix PROJ-123
-> get_issue_context("PROJ-123")
-> reads the failing request and its response body, the console error with file and line, the repro steps
-> get_related_history: has this broken before, and what fixed it?
-> proposes a targeted fix on feature/PROJ-123-<summary>

技能

六项技能，只需在 skills/ 中编写一次，即可供每个客户端使用。

技能	功能
fix-issue	加载上下文，并在分支上修复 SnagRelay 问题，然后暂停以供你审核
open-pr	创建分支 feature/{key}-{summary}，PR 标题为 [{key}] {type}: {description}，并填写完整描述
resolve-issue	根据需要提交更改并创建 PR，然后将问题标记为已解决
triage	列出未解决的问题，供你选择
connect	诊断 MCP 连接故障
scope	说明 Agent 可以（以及不可以）何时调用 SnagRelay

Cursor 还会获取 rules/snagrelay-context.mdc，该文件会告知 Agent 在提出修复方案前加载问题的上下文。

Claude Code 会为插件技能添加命名空间：运行 /snagrelay:fix-issue PROJ-123。在 Cursor 和 Codex 中，说 fix PROJ-123 或使用 /fix-issue。

数据与隐私

Agent 会接收用户的小组件在页面上捕获的内容：元素、控制台、网络、回放和截图。在任何内容传给 Agent 之前，服务器都会剥离机密信息：授权和 Cookie 标头、API 密钥、令牌、密码、CSRF 值、看起来像机密信息的查询参数和表单参数、持有者令牌、JWT，以及较长的十六进制或 base64 字符串。根据套餐的历史记录保留期限（history_days），Agent 只能查看期限内的问题。完整列表请参阅 TELEMETRY.md，报告漏洞请参阅 SECURITY.md。

此仓库不包含任何会在你的计算机上运行的代码：只有清单、技能、规则和远程 MCP URL。

要求

• SnagRelay 账号。免费套餐包含 MCP 服务、网络请求正文和 1 个项目。请参阅定价
• Cursor、Claude Code、Codex，或任何支持通过 OAuth 使用 Streamable HTTP 的 MCP 客户端

链接

网站 · 文档 · 定价 · 支持 · 隐私 · 条款

贡献

请编辑 skills/ 和 rules/，切勿手动修改清单：请参阅 AGENTS.md。采用 MIT 许可证。