클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

MCP 서버 장애 진단 (mcptoon)

mcptoon CLI로 MCP 서버 고장을 설정→연결→툴 계층 순으로 진단하고 고치는 스킬.

개발·코딩중급★ 202⑂ 8AI 점수 7/10마지막 업데이트: 2026. 9. 19.

무엇을 해주나

MCP 서버가 갑자기 안 붙거나 툴이 사라졌을 때, mcptoon doctor → mcptoon health → mcptoon list/manifest/inspect/call 순서로 계층을 하나씩 좁혀가며 원인을 찾도록 Claude를 유도합니다. 자주 나오는 실패 증상(바이너리 없음, 타임아웃, spawn ENOENT, 스키마 오류 등)을 원인·해결책과 짝지은 표가 들어 있어, 수정 후 mcptoon sync와 재검증까지 한 흐름으로 끝냅니다.

이런 분께 추천

  • mcptoon으로 여러 MCP 서버를 관리하는 개발자
  • stdio/HTTP MCP 서버 설정을 자주 손보며 오류에 시달리는 사람
  • CI에서 health --json으로 MCP 상태를 게이트하고 싶은 팀

활용 예시

  • "어제까지 되던 MCP 서버가 전부 죽었어" → 에이전트 디렉터리 설정이 덮어써졌는지 확인하고 ~/.mcptoon/config.json 수정 후 sync.
  • "툴 호출 시 unknown tool이 뜬다" → 해당 툴 토글 상태 확인 후 sync, 그래도 안 되면 manifest로 등록 여부 확인.
  • "인자 스키마 오류" → mcptoon inspect <server> <tool>로 inputSchema를 확인하고 호출 인자를 맞춤.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/activeing123/mcptoon/HEAD/plugin/mcptoon-skills/skills/triage/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 activeing123/mcptoon 의 plugin/mcptoon-skills/skills/triage 폴더를 내 ~/.claude/skills/triage/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon && mkdir -p ~/.claude/skills && cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/triage ~/.claude/skills/triage

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/triage ~/.claude/skills/triage
  5. mcptoon CLI가 설치돼 있는지 확인합니다: mcptoon --version (없다면 저장소 README의 설치 방법을 따르세요).
  6. Claude Code를 다시 실행한 뒤 "MCP 서버가 죽었어, 진단해줘"라고 요청해 동작을 확인합니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0