关于 Heystack
Heystack 插件让编码 Agent 在编辑器中配置 Heystack,并调查 AI 应用的运行问题、管理工作区。它结合托管 MCP 服务与设置和调查技能,可查看追踪、日志、会话回放、崩溃及 LLM 使用情况。
主要功能
- 01查询应用健康、追踪与日志
- 02查看会话故事和回放
- 03检查问题、崩溃及可疑版本
- 04查看生成式 AI 使用量和成本
- 05设置运行时并验证数据接收
- 06管理应用、采样和告警规则
适用场景
- 01排查部署后接口故障
- 02查看崩溃及相关版本
- 03为项目接入 Heystack 并验证数据
- 04管理应用配置和告警
MCP 相关
托管 MCP 服务通过同一 URL 为客户端提供应用监控和工作区管理工具集;团队管理和只读 SQL 可选启用。授予访问权限、创建密钥或令牌及向外部 URL 发送数据的操作需要确认。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.heystack.dev/mcpclaude mcp add --transport http dev-heystack-heystack https://mcp.heystack.dev/mcp{"mcpServers":{"dev-heystack-heystack":{"type":"http","url":"https://mcp.heystack.dev/mcp"}}}在 Cursor 中打开{"servers":{"dev-heystack-heystack":{"type":"http","url":"https://mcp.heystack.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"dev-heystack-heystack":{"type":"http","url":"https://mcp.heystack.dev/mcp"}}}{"mcpServers":{"dev-heystack-heystack":{"serverUrl":"https://mcp.heystack.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.heystack.dev/mcp需要授权工具
详细介绍
Heystack 插件
适用于 Heystack 的插件——为 AI 应用提供可观测性和安全保障——让你的编码 Agent 能在编辑器中设置 Heystack、调查事件并管理工作区。
安装(Claude Code)
/plugin marketplace add heystack-hq/heystack-plugins
/plugin install heystack@heystack
然后运行 /mcp,使用 Heystack 登录并选择组织。试试:“列出我的 Heystack 应用”“自上次部署以来,为什么 /checkout 一直失败?”或“在此项目中设置 Heystack,并验证它是否正在接收数据”。
你将获得
heystack(推荐)——一体化插件:
- 托管 MCP 服务,地址为
https://mcp.heystack.dev/mcp(通过?toolsets=core,manage连接):应用健康状态、用自然语言搜索追踪和日志、打开并解读追踪、会话故事和回放、包含可疑版本的问题和崩溃、生成式 AI 使用量和费用、单次调用即可生成的事件档案(heystack_investigate);以及应用、数据接收密钥、采样/回放配置、警报规则和应用维护。团队管理(成员、邀请、访问令牌)和只读 SQL 默认不启用:编辑插件的.mcp.jsonURL,将其改为?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。
其他 Agent
- 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);此仓库是其镜像。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。