Chẩn đoán lỗi MCP server (mcptoon)
Kỹ năng dùng CLI mcptoon để dò lỗi MCP server theo từng lớp: cấu hình → kết nối → tool.
Làm được gì
Khi MCP server chết hoặc tool biến mất, kỹ năng hướng dẫn Claude chạy lần lượt mcptoon doctor → mcptoon health → mcptoon list/manifest/inspect/call để khoanh vùng lỗi từ trên xuống. Kèm theo là bảng tra nhanh các sự cố phổ biến (không tìm thấy binary, timeout, spawn ENOENT, sai schema...) với nguyên nhân và cách khắc phục, rồi kết thúc bằng mcptoon sync và kiểm tra lại health.
Dành cho ai
- Lập trình viên quản lý nhiều MCP server bằng mcptoon
- Người thường chỉnh cấu hình MCP dạng stdio/HTTP và hay gặp lỗi
- Nhóm muốn dùng
health --jsonlàm cổng kiểm tra trong CI
Ví dụ sử dụng
- "Tất cả MCP server đều chết sau khi tôi sửa file" → kiểm tra cấu hình bị ghi đè trong thư mục agent, sửa
~/.mcptoon/config.jsonrồi sync. - "Gọi tool báo unknown tool" → kiểm tra công tắc bật/tắt của tool, chạy sync, nếu vẫn lỗi thì xem manifest.
- "Lỗi schema khi truyền tham số" → dùng
mcptoon inspect <server> <tool>để khớp chính xác inputSchema.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/activeing123/mcptoon/HEAD/plugin/mcptoon-skills/skills/triage/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục plugin/mcptoon-skills/skills/triage từ repo GitHub activeing123/mcptoon vào ~/.claude/skills/triage/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
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⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải mã nguồn:
git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon - Tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/triage ~/.claude/skills/triage - Kiểm tra đã có CLI mcptoon chưa:
mcptoon --version(nếu chưa, làm theo README của repo). - Khởi động lại Claude Code và thử yêu cầu: "MCP server của tôi lỗi, hãy chẩn đoán".