SnagRelay MCP server
2026년 10월 11일 커밋콘솔 에러, 본문이 포함된 네트워크 요청 실패, 재현 단계 등 버그 리포트에 대한 접근 권한을 코딩 에이전트에게 제공하여 버그 수정을 자동화합니다.
다른 이름 snagrelay/agent-plugin, agent-plugin
- 스타
- 0
- Tools
- 7
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 10월 11일
- 라이선스
- MIT
SnagRelay MCP란?
SnagRelay은(는) MCP server입니다. 콘솔 에러, 본문이 포함된 네트워크 요청 실패, 재현 단계 등 버그 리포트에 대한 접근 권한을 코딩 에이전트에게 제공하여 버그 수정을 자동화합니다. 7개 도구를 제공합니다. 예: get_issue_context, get_issue_payload, get_related_history.
프로젝트 README에서 생성된 요약
SnagRelay MCP server 정보
SnagRelay는 코딩 에이전트가 사용자가 보고한 에러에 직접 접근할 수 있도록 하여 버그 수정을 자동화합니다. Cursor, Claude Code, Codex 또는 Lovable을 사용하는 개발자는 AI 에이전트에게 티켓 키를 제공하여 디버깅에 필요한 정확한 증거를 가져오게 할 수 있습니다. 여기에는 특정 파일 및 줄 번호가 포함된 콘솔 에러, 재현 단계, 그리고 요청 및 응답 본문이 모두 포함된 네트워크 요청 실패 내역이 포함됩니다.
사용자는 브라우저 기반 로그인 프로세스를 통한 OAuth로 연결하므로 토큰을 수동으로 복사할 필요가 없습니다. 서버는 원격으로 호스팅되며, 팀은 기본 멀티 프로젝트 URL, 프로젝트 전용 URL, 또는 에이전트가 report_progress나 mark_issue_resolved와 같은 쓰기 도구를 사용할 수 없는 읽기 전용 버전을 선택할 수 있습니다. 헤드리스 환경이나 CI 스크립트의 경우 API 토큰을 통해 인증을 처리합니다.
단순한 읽기 기능을 넘어, 이 서버는 이슈를 찾고 이전 수정 사항에서 관련 이력을 가져오며 해결 라이프사이클을 관리하는 도구를 제공합니다. 또한 에이전트가 오픈 이슈를 분류하거나 수정 사항이 준비되었을 때 특정 브랜치에 pull request를 생성할 수 있도록 돕는 내장 SKILL도 포함되어 있습니다.
활용 사례
- 1버그 재현 자동화오류가 발생한 요소와 재현 단계를 포함한 버그의 전체 컨텍스트를 AI 에이전트에게 제공합니다.
- 2네트워크 실패 디버깅에이전트가 요청 또는 응답 실패를 유발하는 특정 데이터를 검사할 수 있도록 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SnagRelay MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SnagRelay MCP 설치
$ claude mcp add --transport http agent-plugin https://mcp.snagrelay.com/v1Cursor에 SnagRelay MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"agent-plugin": {
"url": "https://mcp.snagrelay.com/v1"
}
}
}VS Code에 SnagRelay MCP 설치
.vscode/mcp.json
{
"servers": {
"agent-plugin": {
"type": "http",
"url": "https://mcp.snagrelay.com/v1"
}
}
}VS Code CLI에 SnagRelay MCP 설치
$ code --add-mcp '{"name":"agent-plugin","type":"http","url":"https://mcp.snagrelay.com/v1"}'Codex에 SnagRelay MCP 설치
$ codex mcp add agent-plugin --url https://mcp.snagrelay.com/v1Codex config.toml에 SnagRelay MCP 설치
~/.codex/config.toml
[mcp_servers.agent-plugin] url = "https://mcp.snagrelay.com/v1"
Gemini CLI에 SnagRelay MCP 설치
$ gemini mcp add -s user --transport http agent-plugin https://mcp.snagrelay.com/v1Gemini settings.json에 SnagRelay MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"agent-plugin": {
"url": "https://mcp.snagrelay.com/v1",
"type": "http"
}
}
}SnagRelay MCP 도구 7
README에서 감지됨get_issue_contextget_issue_payloadget_related_historyfind_issueswhoamireport_progressmark_issue_resolved
| get_issue_context | — | |
| get_issue_payload | — | |
| get_related_history | — | |
| find_issues | — | |
| whoami | — | |
| report_progress | — | |
| mark_issue_resolved | — |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능snagrelay/agent-plugin is public and reachablegithub.com/snagrelay/agent-plugin ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-11github.com/snagrelay/agent-plugin ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음7 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기SnagRelay for coding agents
Your users find the bugs. Your agent fixes them. Give Cursor, Claude Code or Codex a ticket key and it reads the evidence a human debugger would open: the broken element, console errors with file and line, failing requests with their request and response bodies, repro steps and a short replay.
This repo is the listing and distribution repo for the SnagRelay MCP server. It holds the plugin manifests for each agent platform, the shared skills and the registry entry. The MCP server itself is hosted by SnagRelay at https://mcp.snagrelay.com/v1.
Connect
Sign-in is OAuth. A SnagRelay page opens in your browser, you click Allow, and there is no token to copy.
| Client | Install |
|---|---|
| Cursor | Open Customize → Marketplace, search SnagRelay, install, then click Needs authentication on the snagrelay MCP server |
| Claude Code | claude plugin marketplace add snagrelay/agent-plugin then claude plugin install snagrelay@snagrelay. Run /mcp and authenticate snagrelay |
| Codex | codex plugin marketplace add snagrelay/agent-plugin then codex plugin add snagrelay@snagrelay. Sign in with codex mcp login snagrelay |
| Lovable | Settings → Connectors → search SnagRelay, or add a custom MCP server with the URL below |
| Bolt | Add a custom remote MCP connector with the URL below |
| Replit | Add a custom MCP server with the URL below |
| Anything else | Point any Streamable HTTP MCP client at https://mcp.snagrelay.com/v1 |
Lovable, Bolt and Replit guides are being written; the custom-connector route works today.
For CI, scripts and other headless clients, create an API token in SnagRelay (Settings → API tokens) and send Authorization: Bearer <token> to the same URL.
Which URL?
All four share one server and one sign-in. Pick the narrowest one that fits.
| URL | Use it when |
|---|---|
https://mcp.snagrelay.com/v1 |
You work across projects. The default |
https://mcp.snagrelay.com/v1/readonly |
You want the agent to read issues but never write. The write tools (report_progress, mark_issue_resolved) are removed and blocked. Good for security-conscious teams and shared machines |
https://mcp.snagrelay.com/v1/{projectId} |
This repo belongs to one SnagRelay project. Hard-scoped, so the agent cannot see other projects |
https://mcp.snagrelay.com/v1/{projectId}/readonly |
Both of the above |
{projectId} is the number from whoami, or from the project's URL in SnagRelay.
Tools
| Tool | Access | What it does |
|---|---|---|
get_issue_context |
read | Full context of one issue by key: the element, repro steps, console errors with file and line, requests with bodies, and a screenshot resource link |
get_issue_payload |
read | One full request or response body, or one console entry, by the index from get_issue_context |
get_related_history |
read | Earlier resolved issues on the same screen or endpoint, with the PR that fixed them |
find_issues |
read | List or search issues when you have no key |
whoami |
read | Signed-in account, plan and accessible projects |
report_progress |
write | Tells SnagRelay which file the agent is editing |
mark_issue_resolved |
write | Marks an issue resolved with the PR, commit and branch. Optionally emails the reporter |
One resource: screenshot, the issue's screenshot, read with resources/read.
Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). None is destructive. The agent is instructed not to call mark_issue_resolved before you have reviewed the fix.
Usage
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
Six skills, written once in skills/ and used by every client.
| Skill | What it does |
|---|---|
fix-issue |
Load context and fix a SnagRelay issue on a branch, then stop for your review |
open-pr |
Branch feature/{key}-{summary}, PR title [{key}] {type}: {description}, full description |
resolve-issue |
Commit and open a PR if needed, then mark the issue resolved |
triage |
List open issues so you can pick one |
connect |
Diagnose a broken MCP connection |
scope |
When the agent may (and may not) call SnagRelay |
Cursor also gets rules/snagrelay-context.mdc, which tells the agent to load an issue's context before proposing a fix.
Claude Code namespaces plugin skills: run /snagrelay:fix-issue PROJ-123. In Cursor and Codex, say fix PROJ-123 or use /fix-issue.
Data and privacy
The agent receives what your users' widget captured on the page: element, console, network, replay and screenshot. Secrets are stripped on the server before anything reaches the agent: authorization and cookie headers, API keys, tokens, passwords, CSRF values, secret-looking query and form parameters, bearer tokens, JWTs and long hex or base64 strings. Issues are visible to the agent only as long as your plan's history window (history_days) allows. See TELEMETRY.md for the full list and SECURITY.md to report a vulnerability.
This repo contains no code that runs on your machine: only manifests, skills, a rule and a remote MCP URL.
Requirements
- A SnagRelay account. The free plan includes the MCP server, network bodies and 1 project. See pricing
- Cursor, Claude Code, Codex, or any MCP client that supports Streamable HTTP with OAuth
Links
Website · Docs · Pricing · Support · Privacy · Terms
Contributing
Edit skills/ and rules/, never the manifests by hand: see AGENTS.md. MIT licensed.
SnagRelay MCP 질문
SnagRelay MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http agent-plugin https://mcp.snagrelay.com/v1를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SnagRelay MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SnagRelay MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: get_issue_context, get_issue_payload, get_related_history, find_issues, whoami.
에이전트가 버그 리포트를 수정하지 못하고 읽기만 가능하도록 제한할 수 있나요?
네, readonly URL을 사용하면 report_progress나 mark_issue_resolved와 같은 쓰기 도구 사용을 제한할 수 있습니다.
에이전트가 비밀번호나 API 키와 같은 민감한 정보를 볼 수 있나요?
아니요, 데이터가 에이전트에 도달하기 전 서버 단계에서 authorization 헤더, 쿠키, 토큰과 같은 보안 정보는 모두 제거됩니다.
에이전트는 어떤 종류의 디버깅 증거를 받게 되나요?
에이전트는 오류가 발생한 요소, 파일 및 줄 번호가 포함된 콘솔 에러, 본문이 포함된 네트워크 요청, 재현 단계 및 스크린샷 링크를 받습니다.