MCP server Runheed
Commit 9 de nov. de 2026Permita que agentes de codificação monitorem erros de produção, leiam stack traces, analisem tendências e resolvam bugs diretamente através de um cliente MCP.
Também conhecido como getrunheed/runheed-plugin, runheed-plugin
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.1
- Último commit
- 9 de nov. de 2026
- Licença
- MIT
O que é o MCP Runheed?
Runheed é um MCP server. Permita que agentes de codificação monitorem erros de produção, leiam stack traces, analisem tendências e resolvam bugs diretamente através de um cliente MCP.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Runheed
O Runheed oferece uma interface de rastreamento de erros projetada especificamente para agentes de codificação monitorarem ambientes de produção. Ele captura exceções de aplicações Node.js ou Python e as expõe por meio de um MCP server. Isso permite que clientes de IA como Claude Code, Cursor, Codex e ChatGPT acessem stack traces e dados de erro diretamente. O serviço é hospedado e se conecta via streamable HTTP transport.
Desenvolvedores podem configurar o servidor usando OAuth ou uma chave de agente. O sistema inclui ferramentas específicas para diferentes tarefas, como runheed_search_errors para encontrar problemas específicos, runheed_get_error_context para visualizar breadcrumbs e detalhes de runtime, e runheed_get_trends para analisar estatísticas de 24 horas, 7 dias ou 30 dias. Embora a maioria das ferramentas seja apenas de leitura, os agentes também podem usar runheed_resolve_error para marcar bugs como corrigidos ou runheed_ignore_error para lidar com exceções esperadas.
Os planos de assinatura oferecem diferentes limites de eventos e durações de histórico. O plano Solo inclui 50.000 eventos e 30 dias de histórico, enquanto o plano Scale oferece 1.000.000 de eventos e 180 dias de histórico. Essa configuração possibilita um fluxo de trabalho autônomo onde um agente identifica um bug, analisa o contexto e aplica uma correção.
O que você pode fazer com ele
- 1Analisar tendências de erros de produçãoPeça ao seu agente para recuperar estatísticas de erros dos últimos 30 dias para identificar problemas recorrentes.
- 2Depurar stack traces específicosFaça com que um cliente de IA recupere a mensagem completa, contagens e os principais stack frames de um grupo de erro específico.
- 3Automatizar a resolução de bugsInstrua um agente a marcar um erro específico como resolvido após ele ter implementado uma correção.
- 4Monitorar scores de saúde do projetoSolicite um score de saúde de um projeto para visualizar problemas recentes e receber recomendações.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Runheed
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Runheed no Claude Code
$ claude mcp add --transport http runheed-plugin https://runheed.com/api/mcpInstalar o MCP Runheed no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp"
}
}
}Instalar o MCP Runheed no VS Code
.vscode/mcp.json
{
"servers": {
"runheed-plugin": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Instalar o MCP Runheed no VS Code CLI
$ code --add-mcp '{"name":"runheed-plugin","type":"http","url":"https://runheed.com/api/mcp"}'Instalar o MCP Runheed no Codex
$ codex mcp add runheed-plugin --url https://runheed.com/api/mcpInstalar o MCP Runheed no Codex config.toml
~/.codex/config.toml
[mcp_servers.runheed-plugin] url = "https://runheed.com/api/mcp"
Instalar o MCP Runheed no Gemini CLI
$ gemini mcp add -s user --transport http runheed-plugin https://runheed.com/api/mcpInstalar o MCP Runheed no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp",
"type": "http"
}
}
}Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelgetrunheed/runheed-plugin is public and reachablegithub.com/getrunheed/runheed-plugin ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-09github.com/getrunheed/runheed-plugin ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPinitialize answered with protocol 2025-06-18 in 33 msPassou
README
Ver no 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.
Perguntas sobre o MCP Runheed
Como adiciono o MCP Runheed ao Claude Code?
Execute claude mcp add --transport http runheed-plugin https://runheed.com/api/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Runheed ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Como posso testar o Runheed sem criar uma conta?
Você pode usar um servidor de demonstração que fornece exemplos de erros inventados sem a necessidade de uma chave ou de salvar qualquer dado.
Meu agente pode realmente corrigir bugs usando o Runheed?
Sim, o servidor fornece o contexto necessário, como stack traces e breadcrumbs, para que agentes como Claude Code ou Cursor possam identificar e corrigir bugs.