MCP server de Runheed
Commit 9 nov 2026Permite que los coding agents monitoreen errores de producción, lean stack traces, analicen tendencias y resuelvan bugs directamente a través de un cliente MCP.
También conocido como getrunheed/runheed-plugin, runheed-plugin
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.1
- Último commit
- 9 nov 2026
- Licencia
- MIT
¿Qué es Runheed MCP?
Runheed es un MCP server. Permite que los coding agents monitoreen errores de producción, lean stack traces, analicen tendencias y resuelvan bugs directamente a través de un cliente MCP.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Runheed
Runheed ofrece una interfaz de seguimiento de errores diseñada específicamente para que los coding agents monitoreen entornos de producción. Captura excepciones de aplicaciones Node.js o Python y las expone a través de un MCP server. Esto permite que clientes de IA como Claude Code, Cursor, Codex y ChatGPT accedan directamente a stack traces y datos de errores. El servicio está alojado y se conecta mediante un transporte streamable HTTP.
Los desarrolladores pueden configurar el servidor usando OAuth o una clave de agente. El sistema incluye herramientas específicas para diferentes tareas, como runheed_search_errors para encontrar problemas específicos, runheed_get_error_context para ver breadcrumbs y detalles de tiempo de ejecución, y runheed_get_trends para analizar estadísticas en periodos de 24 horas, 7 días o 30 días. Aunque la mayoría de las herramientas son de solo lectura, los agentes también pueden usar runheed_resolve_error para marcar bugs como solucionados o runheed_ignore_error para gestionar excepciones esperadas.
Los planes de suscripción ofrecen diferentes límites de eventos y duraciones de historial. El plan Solo incluye 50,000 eventos y 30 días de historial, mientras que el plan Scale proporciona 1,000,000 de eventos y 180 días de historial. Esta configuración permite un flujo de trabajo autónomo donde un agente identifica un bug, analiza el contexto y aplica una solución.
Qué puedes hacer con él
- 1Analizar tendencias de errores en producciónPide a tu agente que obtenga estadísticas de errores de los últimos 30 días para identificar problemas recurrentes.
- 2Depurar stack traces específicosHaz que un cliente de IA obtenga el mensaje completo, los conteos y los principales stack frames de un grupo de errores específico.
- 3Automatizar la resolución de bugsInstruye a un agente para que marque un error específico como resuelto después de haber implementado una solución.
- 4Monitorear puntuaciones de salud del proyectoSolicita una puntuación de salud (health score) de un proyecto para ver problemas recientes y recibir recomendaciones.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Runheed MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Runheed MCP en Claude Code
$ claude mcp add --transport http runheed-plugin https://runheed.com/api/mcpInstalar Runheed MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp"
}
}
}Instalar Runheed MCP en VS Code
.vscode/mcp.json
{
"servers": {
"runheed-plugin": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Instalar Runheed MCP en VS Code CLI
$ code --add-mcp '{"name":"runheed-plugin","type":"http","url":"https://runheed.com/api/mcp"}'Instalar Runheed MCP en Codex
$ codex mcp add runheed-plugin --url https://runheed.com/api/mcpInstalar Runheed MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.runheed-plugin] url = "https://runheed.com/api/mcp"
Instalar Runheed MCP en Gemini CLI
$ gemini mcp add -s user --transport http runheed-plugin https://runheed.com/api/mcpInstalar Runheed MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblegetrunheed/runheed-plugin is public and reachablegithub.com/getrunheed/runheed-plugin ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/getrunheed/runheed-plugin ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 33 msAprobado
README
Ver en GitHubRunheed
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 sendAuthorization: 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.
Try it first
A demo server holds invented sample errors. It takes no account or key, and nothing is saved:
claude mcp add --transport http runheed-demo https://runheed.com/api/mcp/demo
Then ask your agent: "What is the top Runheed error, and what would you change?" Setup for other clients: https://runheed.com/demo#try
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:
| Client | How |
|---|---|
| Claude Code | claude mcp add --transport http --scope user runheed https://runheed.com/api/mcp, then run /mcp and choose Authenticate |
| Codex | codex mcp add runheed --url https://runheed.com/api/mcp then codex mcp login runheed |
| claude.ai / Claude Desktop | Customize > Connectors > Add custom connector, URL https://runheed.com/api/mcp |
| ChatGPT | Plugins > + > Add custom MCP server, URL https://runheed.com/api/mcp, OAuth |
| Cursor | Add {"mcpServers": {"runheed": {"url": "https://runheed.com/api/mcp"}}} to ~/.cursor/mcp.json, then sign in from Cursor Settings > MCP |
| Google Antigravity | agy 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 CLI | gemini 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
| Tool | What it does |
|---|---|
runheed_search_errors |
Searches the workspace's error groups by text (type or message), status and project. |
runheed_get_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. |
runheed_get_recent |
Returns the error groups seen most recently, newest first. |
runheed_get_trends |
Returns error statistics for the last 24 hours, 7 days or 30 days. |
runheed_get_error_context |
Returns everything recorded around an error: breadcrumbs, runtime, environment, release, the affected user and the agent session. |
runheed_resolve_error |
Marks an error group resolved, with an optional note such as the fixing commit. |
runheed_ignore_error |
Marks an error group ignored, for known or expected errors. |
runheed_unignore_error |
Moves an ignored error group back to unresolved. |
runheed_get_project_health |
Returns 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: hello@greatwork.company. Issues and pull requests for the skill and plugin files are welcome here.
Privacy
Privacy policy: https://runheed.com/privacy. Terms: https://runheed.com/terms
License
MIT. Runheed is made by Great Work LLC.
Preguntas sobre Runheed MCP
¿Cómo agrego Runheed MCP a Claude Code?
Ejecuta claude mcp add --transport http runheed-plugin https://runheed.com/api/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Runheed MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo puedo probar Runheed sin crear una cuenta?
Puedes usar un servidor de demostración que proporciona errores de muestra inventados sin necesidad de una clave ni de guardar datos.
¿Puede mi agente arreglar bugs realmente usando Runheed?
Sí, el servidor proporciona el contexto necesario, como stack traces y breadcrumbs, para que agentes como Claude Code o Cursor puedan identificar y solucionar bugs.