Tích hợp MCP cho plugin Claude Code
Skill hướng dẫn toàn bộ quy trình gắn MCP server (stdio, SSE, HTTP, WebSocket) vào plugin Claude Code: cấu hình, xác thực và gỡ lỗi.
Lập trìnhTrung cấp★ 522⑂ 47Điểm AI 9/10Cập nhật lần cuối: 23 thg 7, 2026
Skill này làm được gì
- So sánh hai cách khai báo MCP server trong plugin: file
.mcp.jsonriêng hoặc trườngmcpServerstrongplugin.json. - Cung cấp mẫu JSON cho cả bốn loại transport: stdio (tiến trình cục bộ), SSE (dịch vụ hosted có OAuth), HTTP (xác thực bằng token), WebSocket (thời gian thực).
- Giải thích cách mở rộng biến môi trường
${CLAUDE_PLUGIN_ROOT}, quy tắc đặt tên toolmcp__plugin_<plugin>_<server>__<tool>và cách khai báoallowed-toolstrong frontmatter của command. - Đưa ra checklist bảo mật (bắt buộc HTTPS/WSS, không hardcode token, tránh wildcard quyền) và quy trình chẩn đoán khi kết nối hoặc xác thực thất bại.
Phù hợp với ai
- Lập trình viên tự xây dựng và phát hành plugin cho Claude Code.
- Người muốn phơi bày API/CSDL nội bộ thành tool MCP cho cả nhóm dùng.
- Người cần kết nối các MCP server hosted như Asana, GitHub qua OAuth.
- Ai đang debug lỗi server không hiện trong
/mcphoặc xác thực thất bại.
Ví dụ sử dụng
- "Gắn một stdio MCP server truy vấn PostgreSQL nội bộ vào plugin" → tạo
.mcp.jsondùng đường dẫn${CLAUDE_PLUGIN_ROOT}và biếnDB_URL. - "Kết nối Asana bằng SSE và viết command tạo task" → cấu hình SSE kèm command chỉ pre-allow đúng các tool cần thiết.
- "Tool MCP không xuất hiện" → dùng
claude --debugvà lệnh/mcpđể lần lượt kiểm tra kết nối, discovery và quyền.
· · · 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/tzachbon/smart-ralph/HEAD/.agents/skills/MCP Integration/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 .agents/skills/MCP Integration từ repo GitHub tzachbon/smart-ralph vào ~/.claude/skills/mcp-integration/ 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/tzachbon/smart-ralph.git /tmp/smart-ralph && mkdir -p ~/.claude/skills && cp -r "/tmp/smart-ralph/.agents/skills/MCP Integration" ~/.claude/skills/mcp-integration⚠ Đâ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/tzachbon/smart-ralph.git /tmp/smart-ralph - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r "/tmp/smart-ralph/.agents/skills/MCP Integration" ~/.claude/skills/mcp-integration - Kiểm tra các thư mục
references/vàexamples/đã được chép kèm bằngls ~/.claude/skills/mcp-integration. - Khởi động lại Claude Code rồi thử yêu cầu "thêm MCP server vào plugin của tôi".
- Nếu gặp lỗi kết nối, chạy
claude --debugvà dùng lệnh/mcpđể xem danh sách server.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT