Runheed MCP server
2026년 11월 9일 커밋코딩 에이전트가 MCP 클라이언트를 통해 프로덕션 에러를 모니터링하고, 스택 트레이스를 읽으며, 트렌드를 분석하고, 버그를 직접 해결할 수 있습니다.
다른 이름 getrunheed/runheed-plugin, runheed-plugin
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
Runheed MCP란?
Runheed은(는) MCP server입니다. 코딩 에이전트가 MCP 클라이언트를 통해 프로덕션 에러를 모니터링하고, 스택 트레이스를 읽으며, 트렌드를 분석하고, 버그를 직접 해결할 수 있습니다.
프로젝트 README에서 생성된 요약
Runheed MCP server 정보
Runheed는 코딩 에이전트가 프로덕션 환경을 모니터링할 수 있도록 설계된 에러 트래킹 인터페이스를 제공합니다. Node.js 또는 Python 애플리케이션의 예외를 캡처하여 MCP server를 통해 노출합니다. 이를 통해 Claude Code, Cursor, Codex, ChatGPT와 같은 AI 클라이언트가 스택 트레이스와 에러 데이터에 직접 접근할 수 있습니다. 이 서비스는 호스팅되며 streamable HTTP 전송 방식을 통해 연결됩니다.
개발자는 OAuth 또는 에이전트 키를 사용하여 서버를 설정할 수 있습니다. 시스템에는 특정 이슈를 찾는 runheed_search_errors, 브레드크럼 및 런타임 세부 정보를 확인하는 runheed_get_error_context, 24시간/7일/30일 동안의 통계를 분석하는 runheed_get_trends와 같이 다양한 작업을 위한 전용 도구가 포함되어 있습니다. 대부분의 도구는 읽기 전용이지만, 에이전트는 runheed_resolve_error를 사용하여 버그를 해결된 상태로 표시하거나 runheed_ignore_error를 사용하여 예상된 예외를 처리할 수도 있습니다.
구독 플랜에 따라 이벤트 제한 및 히스토리 보관 기간이 달라집니다. Solo 플랜은 50,000개의 이벤트와 30일간의 히스토리를 제공하며, Scale 플랜은 1,000,000개의 이벤트와 180일간의 히스토리를 제공합니다. 이러한 설정을 통해 에이전트가 버그를 식별하고, 컨텍스트를 분석하며, 수정 사항을 적용하는 자율적인 워크플로우를 구현할 수 있습니다.
활용 사례
- 1프로덕션 에러 트렌드 분석에이전트에게 지난 30일간의 에러 통계를 가져오도록 요청하여 반복되는 문제를 식별합니다.
- 2특정 스택 트레이스 디버깅AI 클라이언트가 특정 에러 그룹에 대한 전체 메시지, 횟수 및 상위 스택 프레임을 가져오도록 합니다.
- 3버그 해결 자동화에이전트가 수정을 완료한 후 특정 에러를 해결됨으로 표시하도록 지시합니다.
- 4프로젝트 상태 점수 모니터링프로젝트의 상태 점수를 요청하여 최근 이슈를 확인하고 권장 사항을 받습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Runheed MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Runheed MCP 설치
$ claude mcp add --transport http runheed-plugin https://runheed.com/api/mcpCursor에 Runheed MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp"
}
}
}VS Code에 Runheed MCP 설치
.vscode/mcp.json
{
"servers": {
"runheed-plugin": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}VS Code CLI에 Runheed MCP 설치
$ code --add-mcp '{"name":"runheed-plugin","type":"http","url":"https://runheed.com/api/mcp"}'Codex에 Runheed MCP 설치
$ codex mcp add runheed-plugin --url https://runheed.com/api/mcpCodex config.toml에 Runheed MCP 설치
~/.codex/config.toml
[mcp_servers.runheed-plugin] url = "https://runheed.com/api/mcp"
Gemini CLI에 Runheed MCP 설치
$ gemini mcp add -s user --transport http runheed-plugin https://runheed.com/api/mcpGemini settings.json에 Runheed MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능getrunheed/runheed-plugin is public and reachablegithub.com/getrunheed/runheed-plugin ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 33 ms통과
README
GitHub에서 보기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 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를 테스트할 수 있나요?
키를 요구하거나 데이터를 저장하지 않고 가상의 샘플 에러를 제공하는 데모 서버를 사용할 수 있습니다.
Runheed를 사용하여 에이전트가 실제로 버그를 수정할 수 있나요?
네, 서버가 스택 트레이스와 브레드크럼 같은 필수 컨텍스트를 제공하므로 Claude Code 또는 Cursor와 같은 에이전트가 버그를 식별하고 수정할 수 있습니다.