Sửa Lỗi “Server Disconnected” Và “Failed” Khi Thêm MCP Vào Claude Desktop
Thêm MCP server vào Claude Desktop mà gặp Server disconnected, Failed hay No servers added? Bài này tổng hợp các lỗi chúng tôi gặp khi cài cho khách thật — đặc biệt trên Claude Desktop bản Microsoft Store và chế độ Gateway — cùng cách xử lý từng lỗi.
Cách nhanh nhất
Phần lớn các lỗi dưới đây biến mất nếu cài bằng lệnh một dòng của RevidAPI (chọn phần mềm ở trang Kết nối app & MCP), vì lệnh tự xử lý đúng thư mục cấu hình, cài sẵn máy chủ và khởi động lại Claude. Ví dụ Blender:
Windows — mở PowerShell, dán dòng này rồi nhấn Enter:
irm https://revidapi.com/mcp/blender.ps1 | iex
macOS — mở Terminal, dán dòng này rồi nhấn Enter:
curl -fsSL https://revidapi.com/mcp/blender.sh | bash
Lỗi “No servers added” dù đã sửa file
Nguyên nhân thường gặp:
- Claude chưa thoát hẳn. Bản Microsoft Store chạy ngầm dù đã đóng cửa sổ. Windows: chạy Stop-Process -Name claude -Force trong PowerShell rồi mở lại từ menu Start. Mac: Cmd+Q.
- Sửa nhầm file. Bản Store đọc file trong %LOCALAPPDATA%\Packages\Claude_…\LocalCache; chế độ Gateway đọc thư mục Claude-3p.
- File JSON lỗi. Thiếu hoặc thừa dấu phẩy là Claude bỏ qua cả file.
Edit Config báo “Vị trí không sẵn dùng … Claude-3p”
Gặp trên bản Microsoft Store khi dùng chế độ Gateway: nút Edit Config trỏ vào thư mục thật không tồn tại, còn app đọc thư mục ảo trong Packages. Không cần mở Edit Config — lệnh cài một dòng tự tìm đúng thư mục ảo và ghi vào đó.
“Failed” / “Server disconnected” kèm os error 32
Bấm View logs. Nếu thấy Failed to install: pywin32 … os error 32, nghĩa là uvx đang tự cài thư viện trong hộp cát của bản Store và bị chương trình khác (thường là diệt virus) giữ file.
Cách sửa bền: cài sẵn máy chủ bằng uv tool install rồi trỏ command tới file .exe, thay vì dùng uvx. Lệnh cài của RevidAPI làm đúng như vậy.
Các lỗi khác
| Thông báo | Nguyên nhân và cách xử lý |
|---|---|
spawn … ENOENT |
App không tìm thấy lệnh (uvx, npx). App mở từ biểu tượng không thấy PATH của terminal; ghi đường dẫn đầy đủ vào command. |
Could not connect / 10061 |
Phần mềm chưa bật máy chủ (Blender: Start MCP Server; SketchUp: Start Server). |
Invalid JSON khi chạy tay |
Bình thường: máy chủ MCP chỉ nói chuyện với Claude qua stdin. Bấm Ctrl+C, không cần chạy tay. |
No such option: --allow-dir |
Excel MCP bị cài bản cũ do máy có Python cũ. Cài lại với –python 3.12. |
| SketchUp máy chủ lỗi ngay khi khởi động | Gói sketchup-mcp chưa hợp thư viện MCP mới; cần ghim phiên bản (lệnh cài đã làm). |
Vẫn chưa chạy?
Gửi ảnh chụp màn hình lỗi cho admin qua Zalo, admin xem và cài giúp.
Câu hỏi thường gặp
Lỗi có phải do API key không?
Hầu như không. Nếu chat với Claude vẫn trả lời bình thường thì API key đúng; lỗi nằm ở MCP server hoặc file cấu hình.
Chạy lại lệnh cài nhiều lần có sao không?
Không. Lệnh chỉ thêm hoặc cập nhật đúng một mục, sao lưu file cũ thành .bak.
Chế độ Gateway có dùng MCP được không?
Được. Chúng tôi đã chạy Blender MCP trên Claude Desktop bản Store ở chế độ Gateway.
Đọc thêm: MCP server là gì, Blender MCP, câu hỏi thường gặp.
Cần cài giúp?
Nhắn Zalo admin 0978 382 335, admin cài qua điều khiển từ xa miễn phí. Nhóm Zalo cộng đồng hỏi đáp nhanh.
