MCP Tester
Kiểm máy chủ MCP của NextX ngay trên trình duyệt: còn sống không, khoá/đăng nhập có đúng không, AI thấy công cụ nào và vì sao không thấy công cụ X, gọi thử ra gì. Khoá và token chỉ nằm trong tab này.
https://mcp.nextx.vn/mcpĐúng như khi trợ lý AI (ChatGPT, Claude, Gemini, Grok…) nối vào: chọn workspace, tick quyền, xong quay lại đây.
Kết quả kiểm
- 1
Máy chủ còn sống (/health)
- 2
Khai báo OAuth (Protected Resource Metadata)
- 3
Bắt tay (initialize)
- 4
Lấy danh sách công cụ (tools/list)
- 5
Đối chiếu quyền với danh mục
Session này
Xác thực: Đăng nhập NextX (OAuth)
Giao thức: 2025-06-18
Máy chủ: —
Công cụ thấy được: —
Gửi kèm khi nhờ hỗ trợ. Không chứa khoá hay token.
Cấu hình cho client
Chỉ cần URL — trợ lý mở trang đăng nhập, chọn workspace, tick quyền.
{
"url": "https://mcp.nextx.vn/mcp",
"transport": "streamable-http"
}Bảng lỗi thường gặp
| Hiện tượng | Nguyên nhân | Cách sửa |
|---|---|---|
| 401 ở bước bắt tay | Khoá sai / đã thu hồi / hết hạn, hoặc token đăng nhập hết hạn | Tạo lại khoá trong app hoặc đăng nhập lại. Khoá sandbox không dùng được ở production. |
| 403 insufficient_scope khi gọi công cụ | Kết nối chưa được cấp quyền cho công cụ đó | Kết nối lại và tick thêm quyền; với API key thì thêm scope cho khoá trong app. |
| 404 /health hoặc /mcp | Sai địa chỉ máy chủ (thiếu /mcp hoặc nhầm môi trường) | Dùng đúng địa chỉ ở ô Máy chủ phía trên. |
| 429 | Vượt giới hạn lượt gọi | Chờ ít phút rồi retry; giảm tần suất gọi. |
| Lỗi mạng ngay lập tức | Máy chủ tự host chưa mở CORS cho trang này, hoặc chặn bởi mạng | Mở CORS cho cổng nhà phát triển, hoặc kiểm bằng client MCP ngoài trình duyệt. |
| Quá 30 giây | Máy chủ quá tải hoặc đang có sự cố | Xem Trạng thái hệ thống, retry sau. |
| 0 công cụ | Khoá/kết nối không có scope nào khớp công cụ | Thêm scope đọc cho khoá hoặc tick quyền khi kết nối. |
| Production chạy, Sandbox 401 (hoặc ngược lại) | Khoá và token gắn với MỘT môi trường | Tạo khoá riêng ở app sandbox cho máy chủ sandbox. |
Nhật ký JSON-RPC
Chưa có lệnh nào.