SnagRelay

コーディングエージェント向け SnagRelay

ユーザーがバグを見つけ、エージェントが修正します。Cursor、Claude Code、Codex にチケットキーを渡すと、人間のデバッガーが開くような証拠を読み取ります。問題のある要素、ファイル名と行番号付きのコンソールエラー、リクエスト本文とレスポンス本文を含む失敗したリクエスト、再現手順、短いリプレイを確認できます。

このリポジトリは、SnagRelay MCP サーバーの掲載および配布用リポジトリです。各エージェントプラットフォーム向けのプラグインマニフェスト、共通のスキル、レジストリエントリを格納しています。MCP サーバー自体は SnagRelay が https://mcp.snagrelay.com/v1 でホストしています。

接続

サインインには OAuth を使用します。SnagRelay のページがブラウザーで開くので、許可をクリックするだけです。トークンをコピーする必要はありません。

クライアント	インストール
Cursor	Customize → Marketplace を開き、SnagRelay を検索してインストールし、snagrelay MCP サーバーの Needs authentication をクリックします
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	Settings → Connectors で SnagRelay を検索するか、以下の URL を使用してカスタム MCP サーバーを追加します
Bolt	以下の URL を使用して、カスタムのリモート MCP コネクターを追加します
Replit	以下の URL を使用して、カスタム MCP サーバーを追加します
その他	Streamable HTTP に対応した MCP クライアントを https://mcp.snagrelay.com/v1 に接続します

Lovable、Bolt、Replit 向けのガイドを作成中ですが、カスタムコネクターを使う方法は現在も利用できます。

CI、スクリプト、その他のヘッドレスクライアントでは、SnagRelay（Settings → API tokens）で API トークンを作成し、同じ URL に Authorization: Bearer <token> を送信します。

どの URL を使いますか？

4 つの URL はすべて同じサーバーとサインインを共有します。用途に合う、最も範囲の狭い URL を選んでください。

URL	使用するケース
https://mcp.snagrelay.com/v1	複数のプロジェクトで作業する場合。デフォルトです
https://mcp.snagrelay.com/v1/readonly	エージェントにイシューを読み取らせても、書き込みはさせたくない場合。書き込みツール（report_progress、mark_issue_resolved）は削除され、使用できません。セキュリティを重視するチームや共有マシンに適しています
https://mcp.snagrelay.com/v1/{projectId}	このリポジトリが 1 つの SnagRelay プロジェクトに属する場合。プロジェクトの範囲が厳密に限定され、エージェントは他のプロジェクトを参照できません
https://mcp.snagrelay.com/v1/{projectId}/readonly	上記 2 つの条件を両方満たす場合

{projectId} は、whoami で確認するか、SnagRelay のプロジェクト URL から確認できる番号です。

ツール

ツール	アクセス	機能
get_issue_context	読み取り	キーで指定した 1 件のイシューの全コンテキストを取得します。要素、再現手順、ファイル名と行番号付きのコンソールエラー、本文付きのリクエスト、スクリーンショットのリソースリンクが含まれます
get_issue_payload	読み取り	get_issue_context のインデックスで指定した 1 件の完全なリクエスト本文、レスポンス本文、またはコンソールエントリを取得します
get_related_history	読み取り	同じ画面またはエンドポイントで以前に解決されたイシューと、修正した PR を一覧表示します
find_issues	読み取り	キーがない場合にイシューを一覧表示または検索します
whoami	読み取り	サインイン中のアカウント、プラン、アクセス可能なプロジェクトを表示します
report_progress	書き込み	エージェントが編集しているファイルを SnagRelay に通知します
mark_issue_resolved	書き込み	PR、コミット、ブランチを指定してイシューを解決済みにします。任意で報告者にメールを送信できます

リソースは 1 つです。イシューのスクリーンショットである screenshot は、resources/read で読み取ります。

すべてのツールには MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）が付いています。破壊的なツールはありません。エージェントには、修正内容を確認する前に 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/ に一度だけ記述し、すべてのクライアントで使用する6つのスキルです。

スキル	機能
fix-issue	コンテキストを読み込み、ブランチ上で SnagRelay の課題を修正して、レビューのために停止します
open-pr	feature/{key}-{summary} ブランチを作成し、PR タイトルを [{key}] {type}: {description} として、詳細な説明を記載します
resolve-issue	必要に応じてコミットして PR を作成し、課題を解決済みにします
triage	対応する課題を選べるよう、未解決の課題を一覧表示します
connect	MCP 接続の問題を診断します
scope	エージェントが SnagRelay を呼び出してよい場合と、呼び出してはいけない場合を定めます

Cursor では、エージェントに修正を提案させる前に課題のコンテキストを読み込むよう指示する rules/snagrelay-context.mdc も使用します。

Claude Code ではプラグインのスキルに名前空間が付与されるため、/snagrelay:fix-issue PROJ-123 を実行します。Cursor と Codex では、fix PROJ-123 と入力するか、/fix-issue を使用します。

データとプライバシー

エージェントは、ユーザーのウィジェットがページ上で収集したデータ（要素、コンソール、ネットワーク、リプレイ、スクリーンショット）を受け取ります。エージェントに届く前に、サーバー側でシークレットが取り除かれます。対象には、authorization ヘッダーと cookie ヘッダー、API キー、トークン、パスワード、CSRF 値、シークレットと思われるクエリパラメーターとフォームパラメーター、ベアラートークン、JWT、長い 16 進数文字列や Base64 文字列が含まれます。エージェントが課題を参照できるのは、プランの履歴保持期間（history_days）内に限られます。全項目は TELEMETRY.md を、脆弱性の報告については SECURITY.md を参照してください。

このリポジトリには、マシン上で実行されるコードは含まれていません。マニフェスト、スキル、ルール、リモート MCP URL のみが含まれています。

要件

• SnagRelay アカウント。無料プランには MCP サーバー、ネットワーク本文、1 つのプロジェクトが含まれます。料金 をご覧ください。
• Cursor、Claude Code、Codex、または Streamable HTTP と OAuth に対応する MCP クライアント

リンク

ウェブサイト · ドキュメント · 料金 · サポート · プライバシー · 利用規約

コントリビューション

skills/ と rules/ を編集し、マニフェストは手動で編集しないでください。AGENTS.md を参照してください。MIT ライセンスです。