Heystack

Heystack プラグイン

Heystack 向けのプラグインです。AI アプリのオブザーバビリティとセキュリティを提供し、コーディングエージェントがエディターから Heystack のセットアップ、インシデントの調査、ワークスペースの管理を行えるようにします。

インストール（Claude Code）

/plugin marketplace add heystack-hq/heystack-plugins
/plugin install heystack@heystack

次に /mcp を実行して Heystack にサインインし、組織を選択します。次のように試してみてください：「自分の Heystack アプリを一覧表示して」、「直近のデプロイ以降、なぜ /checkout が失敗しているの？」、または 「このプロジェクトに Heystack をセットアップして、データを受信していることを確認して」。

利用できる機能

heystack（推奨） — オールインワンのプラグインです。

• ?toolsets=core,manage を指定して接続する https://mcp.heystack.dev/mcp のホスト型 MCP サーバー：アプリの健全性、平易な英語でのトレースとログの検索、トレースの表示と解説、セッションのストーリーとリプレイ、問題と原因と考えられるリリースを含むクラッシュ、生成 AI の使用状況とコスト、1 回の呼び出しで作成するインシデントの概要（heystack_investigate）に加え、アプリ、取り込みキー、サンプリング／リプレイ設定、アラートルール、アプリケアを利用できます。チーム管理（メンバー、招待、アクセストークン、監査）と読み取り専用 SQL はオプトインです。プラグインの .mcp.json の URL を ?toolsets=core,manage,team（または advanced）に編集してください。アクセス権の付与、キーやトークンの発行、外部 URL へのデータ送信を行う操作では、必ず確認を求めます。Heystack にサインインします（OAuth）。貼り付けるキーは不要です。詳しいリファレンス：https://heystack.dev/docs/mcp
• heystack-setup スキル — 実行環境（Next.js、Cloudflare Workers/Agents、Node、ブラウザー、Android）を検出し、適切な @heystack/otel エントリーまたは OTLP パスを設定します。MCP サーバーと併用すると、アプリとキーを自動で作成し、heystack_verify_setup でデータが届いていることを確認します。
• heystack-investigate スキル — 調査の流れを支援します：概要 → 概要資料 → トレース／セッション → コードの修正 → 検証。問題のステータスを変更したり、アラートを作成したりするタイミングも案内します。確認なしに破壊的な操作を行うことはありません。

heystack-setup — セットアップスキル単体（MCP サーバーなし）です。既存のインストール向けに提供されています：/plugin install heystack-setup@heystack

その他のエージェント

• Cursor / VS Code / Codex / Gemini CLI / Claude.ai は、同じ MCP URL に接続します。ワンクリックリンクとコマンドについては、https://heystack.dev/docs/mcp をご覧ください。
• スキルは通常の Agent Skills ファイルで、https://heystack.dev/heystack-setup.md および https://heystack.dev/heystack-investigate.md からもそのまま取得できます。ルートの plugin.json / mcp.json / skills/ は、ベンダー共通の Agent Plugins レイアウトに従っています。
• すべてのドキュメントページを Markdown で利用できます：https://heystack.dev/llms.txt

ディレクトリ構成

.claude-plugin/marketplace.json           # Claude Code marketplace (plugins: heystack, heystack-setup)
plugins/heystack/                         # all-in-one: .mcp.json + skills/
plugins/heystack-setup/                   # skill-only (legacy)
plugin.json · mcp.json · skills/          # Agent Plugins (cross-vendor) layout of the `heystack` plugin

スキルの信頼できる情報源は heystack モノレポ（packages/setup-skill、packages/investigate-skill）です。このリポジトリはそのミラーです。