MCP server Runheed
Коммит 9 нояб. 2026 г.Позволяет coding agents отслеживать ошибки в продакшене, читать stack traces, анализировать тренды и исправлять баги напрямую через MCP client.
Также известен как getrunheed/runheed-plugin, runheed-plugin
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 1.0.1
- Последний коммит
- 9 нояб. 2026 г.
- Лицензия
- MIT
Что такое Runheed MCP?
Runheed — это MCP server. Позволяет coding agents отслеживать ошибки в продакшене, читать stack traces, анализировать тренды и исправлять баги напрямую через MCP client.
Сводка сгенерирована из README проекта
О Runheed MCP server
Runheed предоставляет интерфейс отслеживания ошибок, разработанный специально для coding agents для мониторинга продакшн-сред. Он перехватывает исключения из Node.js или Python приложений и предоставляет их через MCP server. Это позволяет AI-клиентам, таким как Claude Code, Cursor, Codex и ChatGPT, получать прямой доступ к stack traces и данным об ошибках. Сервис является хостинговым и подключается через streamable HTTP transport.
Разработчики могут настроить сервер с помощью OAuth или ключа агента. Система включает специализированные инструменты для различных задач, таких как runheed_search_errors для поиска конкретных проблем, runheed_get_error_context для просмотра breadcrumbs и деталей выполнения, а также runheed_get_trends для анализа статистики за 24 часа, 7 дней или 30 дней. Хотя большинство инструментов предназначены только для чтения, агенты также могут использовать runheed_resolve_error, чтобы пометить баги как исправленные, или runheed_ignore_error для обработки ожидаемых исключений.
Тарифные планы предлагают различные лимиты событий и длительность хранения истории. План Solo включает 50,000 событий и 30-дневную историю, в то время как план Scale предоставляет 1,000,000 событий и 180-дневную историю. Такая конфигурация обеспечивает автономный рабочий процесс, при котором агент находит баг, анализирует контекст и применяет исправление.
Что вы можете с ним делать
- 1Анализ трендов ошибок в продакшенеПопросите вашего агента получить статистику ошибок за последние 30 дней, чтобы выявить повторяющиеся проблемы.
- 2Отладка конкретных stack tracesПопросите AI-клиент получить полное сообщение, количество вхождений и основные stack frames для конкретной группы ошибок.
- 3Автоматизация исправления баговДайте агенту команду пометить конкретную ошибку как исправленную после того, как он внедрит фикс.
- 4Мониторинг показателей здоровья проектаЗапросите показатель здоровья (health score) проекта, чтобы увидеть последние проблемы и получить рекомендации.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Runheed MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Runheed MCP в Claude Code
$ claude mcp add --transport http runheed-plugin https://runheed.com/api/mcpУстановка Runheed MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp"
}
}
}Установка Runheed MCP в VS Code
.vscode/mcp.json
{
"servers": {
"runheed-plugin": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Установка Runheed MCP в VS Code CLI
$ code --add-mcp '{"name":"runheed-plugin","type":"http","url":"https://runheed.com/api/mcp"}'Установка Runheed MCP в Codex
$ codex mcp add runheed-plugin --url https://runheed.com/api/mcpУстановка Runheed MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.runheed-plugin] url = "https://runheed.com/api/mcp"
Установка Runheed MCP в Gemini CLI
$ gemini mcp add -s user --transport http runheed-plugin https://runheed.com/api/mcpУстановка Runheed MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp",
"type": "http"
}
}
}Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийgetrunheed/runheed-plugin is public and reachablegithub.com/getrunheed/runheed-plugin ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-09github.com/getrunheed/runheed-plugin ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 33 msПройдено
README
Открыть на 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.
Вопросы о Runheed MCP
Как добавить Runheed MCP в Claude Code?
Выполните claude mcp add --transport http runheed-plugin https://runheed.com/api/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Runheed MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как я могу протестировать Runheed без создания аккаунта?
Вы можете использовать демо-сервер, который предоставляет вымышленные примеры ошибок и не требует API-ключ или сохранение данных.
Может ли мой агент действительно исправлять баги с помощью Runheed?
Да, сервер предоставляет необходимый контекст, такой как stack traces и breadcrumbs, чтобы такие агенты, как Claude Code или Cursor, могли находить и исправлять ошибки.