Runheed

com.runheed由 runheed.com 发布官方发布者v1.0.1更新于 Nov 6, 2026

Production errors your coding agent can read: search, stack traces, context, trends, resolve.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

Runheed 通过 MCP 提供工作区的生产错误分组，让助手搜索错误、查看堆栈与上下文、查看趋势，并将错误标记为已解决或已忽略。

可以做什么
  • 按文本、状态和项目搜索错误分组，或列出最近出现的错误
  • 完整读取单个错误分组，包括堆栈帧、面包屑和 agent 上下文
  • 查看 24 小时、7 天或 30 天的错误统计，以及项目或工作区健康评分
  • 变更错误状态：带备注标记已解决、忽略，或将已忽略的错误恢复为未解决
适用场景
适合让编码助手调试 Node.js 或 Python 应用的真实生产异常：定位出错的错误、阅读堆栈与上下文、修复代码，再用提交信息将其标记为已解决。
运行要求
远程 Streamable HTTP 端点 runheed.com/api/mcp，无需本地安装包。通过 OAuth 登录，或在 Authorization 头中携带 Bearer agent key（al_...，来自 Settings > Agent keys）进行认证。需要一个有应用上报错误的 Runheed 工作区，以及付费方案（每工作区每月 29 美元起）。
安装前请注意
需要 Runheed agent key 或 OAuth 登录，agent key 应视为机密。有三个工具会变更错误状态（解决、忽略、取消忽略），但可以改回。错误数据（含受影响用户与会话上下文）从托管的 Runheed 服务读取。方案按工作区按月计费。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Runheed，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.runheed%2Frunheed/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "runheed": {
      "type": "http",
      "url": "https://runheed.com/api/mcp"
    }
  }
}

README

Runheed

Error tracking your coding agent can read. Runheed catches exceptions in your Node.js or Python app and serves them over MCP, so Claude Code, Cursor, Codex or any MCP client can read the stack trace, fix the bug and mark it resolved.

  • Website: https://runheed.com
  • MCP server: https://runheed.com/api/mcp (Streamable HTTP). Sign in with OAuth (claude.ai, ChatGPT, Claude Code, Cursor, Codex), or send Authorization: Bearer al_... with an agent key.
  • Setup for agents: https://runheed.com/SETUP.txt

This repo holds the Claude Code plugin, the Google Antigravity plugin, the agent skill and the MCP config. The Runheed service itself is hosted.

Install

Claude Code plugin (signs you in on first use, no key to copy):

/plugin marketplace add getrunheed/runheed-plugin/plugin install runheed@runheed

Or add the server directly:

ClientHow
Claude Codeclaude mcp add --transport http --scope user runheed https://runheed.com/api/mcp, then run /mcp and choose Authenticate
Codexcodex mcp add runheed --url https://runheed.com/api/mcp then codex mcp login runheed
claude.ai / Claude DesktopCustomize > Connectors > Add custom connector, URL https://runheed.com/api/mcp
ChatGPTPlugins > + > Add custom MCP server, URL https://runheed.com/api/mcp, OAuth
CursorAdd {"mcpServers": {"runheed": {"url": "https://runheed.com/api/mcp"}}} to ~/.cursor/mcp.json, then sign in from Cursor Settings > MCP
Google Antigravityagy plugin install https://github.com/getrunheed/runheed-plugin (this repo is also an Antigravity plugin: .antigravity-plugin/plugin.json + mcp_config.json), or add {"mcpServers": {"runheed": {"serverUrl": "https://runheed.com/api/mcp"}}} to ~/.gemini/config/mcp_config.json and click Authenticate under Customizations
Gemini CLIgemini extensions install https://github.com/getrunheed/runheed-plugin

Then add the SDK to your app (Node.js / TypeScript, Python, or plain HTTP). Your agent can do both steps from https://runheed.com/SETUP.txt.

Install the skill in any agent

skills/runheed/SKILL.md tells an agent when to reach for Runheed and how to set it up. It's the same file served at https://runheed.com/SKILL.md.

What your agent can do

ToolWhat it does
runheed_search_errorsSearches the workspace's error groups by text (type or message), status and project.
runheed_get_errorReturns one error group in full: message, status, counts, first and last seen, environment, agent context, the top stack frames and the latest breadcrumbs.
runheed_get_recentReturns the error groups seen most recently, newest first.
runheed_get_trendsReturns error statistics for the last 24 hours, 7 days or 30 days.
runheed_get_error_contextReturns everything recorded around an error: breadcrumbs, runtime, environment, release, the affected user and the agent session.
runheed_resolve_errorMarks an error group resolved, with an optional note such as the fixing commit.
runheed_ignore_errorMarks an error group ignored, for known or expected errors.
runheed_unignore_errorMoves an ignored error group back to unresolved.
runheed_get_project_healthReturns a 0 to 100 health score for a project, with recent issues and recommendations.

Read tools are read-only; the three status tools only flip an error's status, which can be flipped back.

Pricing

One flat price per workspace, every plan includes the MCP server:

  • Solo: $29 a month. 50,000 events a month, 3 projects, 30-day history.
  • Pro: $79 a month. 250,000 events a month, 15 projects, 90-day history.
  • Scale: $199 a month. 1,000,000 events a month, unlimited projects, 180-day history.

Events over your plan's limit are rejected, never charged. Details: https://runheed.com/pricing

Support and contributing

Questions: [email protected]. Issues and pull requests for the skill and plugin files are welcome here.

License

MIT. Runheed is made by Great Work LLC.

来源：README.md，提交 ab8079a

工具

9

runheed_search_errors

Search errors

Searches the workspace's error groups by text (type, message, route, file or extra data), status and project. Returns each matching group with its status, type, message, route, top stack frame, event count, last-seen time and ID.

输入参数limitquerystatusprojectId

runheed_get_error

Get an error

Returns one error group in full: message, status, counts, first and last seen, environment, agent context, the top stack frames and the latest breadcrumbs.

输入参数errorId必填

runheed_get_recent

Get recent errors

Returns the error groups seen most recently, newest first, with status, type, message, route, top stack frame, event count, last-seen time and ID.

输入参数limitprojectId

runheed_get_error_context

Get error context

Returns everything recorded around an error: every breadcrumb, platform, runtime, OS, environment, release, the affected user, the agent session and extra data.

输入参数errorId必填

runheed_resolve_error

Resolve an error

Marks an error group resolved, with an optional note such as the fixing commit. The group reopens on its own if the error happens again. Returns a confirmation.

输入参数commenterrorId必填

runheed_ignore_error

Ignore an error

Marks an error group ignored, for known or expected errors, so new occurrences stop alerting. Returns a confirmation.

输入参数reasonerrorId必填

runheed_unignore_error

Stop ignoring an error

Moves an ignored error group back to unresolved, so new occurrences alert again. Returns a confirmation.

输入参数errorId必填

runheed_get_project_health

Get project health

Returns a 0 to 100 health score for a project (or the whole workspace), errors in the last 24 hours, the unresolved count, the error rate, recent issues and recommendations.

输入参数projectId

版本历史

2
  1. v1.0.1最新Nov 6, 2026
  2. v1.0.0Nov 3, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分