Cloudways MCP: quyền của Access Token, kết nối Claude · Cursor và quản lý server bằng AI
Kết nối Cloudways MCP với Claude Code và hoàn tất thiết lập truy vấn server Cloudways qua hội thoại bằng Access Token chỉ đọc. Vì cái tên, bạn dễ nhầm rằng phải cài thứ gì đó lên server Cloudways, nhưng nơi thực sự đăng ký là tệp cài đặt ở phía chương trình AI.
Với cùng token đó, danh sách server, trạng thái dịch vụ và mức dùng CPU đều truy vấn được, còn lệnh xóa cache thì bị từ chối do lỗi quyền.
1️⃣ Cách Cloudways MCP hoạt động
Cloudways MCP là server kết nối cho phép các chương trình AI như Claude, Cursor, ChatGPT gọi API Cloudways thay cho bạn, và được cung cấp cho mọi khách hàng Cloudways mà không tính thêm phí.
Cấu trúc chia làm ba nơi. Chương trình AI (MCP client) nhận yêu cầu và chọn công cụ sẽ dùng, sau đó server MCP từ xa do Cloudways vận hành (mcp.cloudways.com) chuyển yêu cầu đó thành lệnh gọi API Cloudways rồi thực thi. Trên server Cloudways được quản lý thì không cài gì cả.
Việc đăng ký thực hiện trên máy tính đã cài Claude Code, và cũng làm được trên PC Windows. Lần này không làm trên server Cloudways mà trên một server Linux riêng, nơi cài và sử dụng Claude Code.
Có hơn 250 công cụ, nhưng lúc đầu chương trình AI chỉ thấy 66 công cụ. Phần còn lại được tìm và chạy khi có yêu cầu, nên không cần thiết lập gì thêm.
2️⃣ Tạo Access Token và phạm vi quyền
Dù đã đăng ký địa chỉ MCP, Cloudways vẫn không nhận yêu cầu nếu không có Access Token. Token được tạo trong menu hồ sơ ở góc trên bên phải của Cloudways, tại [API Integration].
Nhấn [Create Access Token] để mở cửa sổ đặt tên, thời hạn và phạm vi quyền, rồi tiếp tục ở đó.
Phạm vi quyền (Scope) có ba loại, mặc định là [Limited Access(Beta)]. [Read-Only Access] chỉ truy vấn trạng thái server, cài đặt ứng dụng và mức sử dụng, không thể tạo, thay đổi hay xóa, còn [Full Access] dùng mọi API trong phạm vi quyền của tài khoản. [Limited Access] chỉ cho phép những chức năng đã chọn.
Lần kết nối đầu tiên, hãy bắt đầu với [Read-Only Access]. [Read-Only Access] không có rủi ro xóa nhầm, nhưng muốn cho AI thực thi việc gì đó như xóa cache hay sao lưu thì phải mở riêng chức năng đó bằng [Limited Access].
Thời hạn có thể chọn từ 1 ngày đến không hết hạn; khi thử nghiệm đã dùng 1 tháng.
Giá trị token chỉ hiển thị một lần lúc tạo; đóng cửa sổ là không xem lại được và phải thu hồi (Revoke) rồi tạo mới, vì vậy hãy sao chép giá trị token ngay khi còn ở trang đó.
Cách dùng API Key cũ sẽ kết thúc vào giữa tháng 10 năm 2026, nên MCP đã kết nối bằng API Key cũng phải chuyển sang Access Token.
3️⃣ Thiết lập kết nối Claude · Cursor · VS Code
Dù đã tạo token, bạn vẫn chưa dùng được trong hội thoại cho đến khi đăng ký vào chương trình AI. Claude Code hỗ trợ trực tiếp MCP HTTP từ xa nên chỉ cần một dòng lệnh để đăng ký. Lần này lệnh được chạy trong terminal của một server Linux riêng, nơi cài và sử dụng Claude Code (không phải server Cloudways).
claude mcp add --transport http --header "X-Access-Token: YOUR_TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/Trong lệnh, [cloudways] là tên đăng ký; điền Access Token đã tạo vào [X-Access-Token] và tên chương trình AI đang dùng (claude-code) vào [X-Mcp-Host]. Chỉ nhập giá trị bắt đầu bằng [cw_]; nếu nhập cả dấu ngoặc nhọn (< >) trong phần hướng dẫn thì giá trị sẽ không được nhận là token.
Đăng ký với [-s user] thì chạy claude từ thư mục nào cũng thấy công cụ Cloudways, còn [-s local] chỉ thấy khi chạy từ thư mục đã chạy lệnh đăng ký. Ban đầu đã đăng ký local trong thư mục làm việc, nhưng khi chạy từ thư mục khác thì không thấy công cụ, nên đã đổi sang user.
Dù đăng ký là user, Claude Code chỉ tải tên công cụ trước và tải phần mô tả khi dùng, nên lượng token sử dụng không khác nhiều so với local.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedChạy [claude mcp list], nếu cuối dòng [cloudways] hiện [Connected] là đã kết nối. Đăng ký xong không có nghĩa là dùng được ngay trong hội thoại hiện tại. Công cụ MCP được tải khi bắt đầu phiên, nên công cụ Cloudways chỉ xuất hiện từ phiên mở mới.
Thông tin đăng ký được lưu trong [.claude.json] ở thư mục home — tệp cài đặt của Claude Code; với tài khoản root trên Linux là [/root/.claude.json]. user được ghi trong [mcpServers] ở đầu tệp này, còn local được ghi dưới [projects] theo đường dẫn thư mục tương ứng. Claude Desktop trên Windows thì điền cùng địa chỉ và token vào [%APPDATA%\Claude\claude_desktop_config.json].
Các chương trình AI khác như Cursor, VS Code cũng điền cùng địa chỉ và token vào tệp cài đặt, theo định dạng được hướng dẫn trong Trung tâm trợ giúp Cloudways cho từng chương trình.
4️⃣ Những việc có thể chạy bằng prompt
Khi kết nối bằng token Read-Only, đã lần lượt yêu cầu danh sách server, chi tiết server, trạng thái dịch vụ, mức dùng CPU, danh sách ứng dụng và trạng thái chứng chỉ SSL, và mọi yêu cầu truy vấn đều nhận được kết quả. Thời gian phản hồi bên dưới là thời gian server Cloudways MCP trả kết quả, không gồm thời gian AI soạn câu trả lời.
| Yêu cầu | Công cụ được chạy | Thời gian phản hồi | Nội dung phản hồi |
|---|---|---|---|
| Hiện danh sách server của tôi | server_list | 0,72 giây | 1 server, đang chạy (running), Vultr khu vực Seoul, 1GB, MariaDB 10.11 |
| Cho biết thông tin chi tiết server | server_get | 0,68 giây | Debian 12, ổ đĩa 25GB, 1 ứng dụng đã cài (WordPress) |
| Kiểm tra trạng thái dịch vụ | service_status | 5,10 giây | 8 đang chạy (Nginx · Apache · MySQL · PHP 8.2-FPM · Redis · Varnish · Memcached · Imunify360), 1 đã dừng (New Relic) |
| Mức dùng CPU 24 giờ gần nhất | monitoring_server_graph | 1,75 giây | 288 giá trị cách nhau 5 phút, mức dùng trung bình khoảng 13%, cao nhất khoảng 30% |
| Hiện danh sách ứng dụng | app_list | 0,67 giây | 1 WordPress, tên miền kết nối cw.testpilotweb.com |
| Kiểm tra trạng thái chứng chỉ SSL | app_get | 3,04 giây | Let's Encrypt đã cài và xác minh, bật tự động gia hạn |
| Xóa cache | app_purge_cache | 0,42 giây | Bị từ chối — 403 insufficient_scope |
Mức dùng CPU được trả về dưới dạng tỷ lệ CPU rảnh (Idle CPU), nên trung bình 86,8% tương ứng với mức dùng khoảng 13%. Không có công cụ riêng để truy vấn trạng thái SSL, nên đã kiểm tra qua mục Let’s Encrypt trong thông tin chi tiết ứng dụng ([app_get]).
Có vẻ như yêu cầu gì với AI cũng sẽ được thực thi, nhưng phạm vi thực thi do quyền của token quyết định. Khi yêu cầu xóa cache, công cụ [app_purge_cache] đã được chạy, nhưng Cloudways từ chối với lỗi [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Có thể xem công cụ nào là thao tác ghi qua danh sách mà công cụ [get_write_tools] trả về.
5️⃣ Lỗi kết nối và làm mới danh sách công cụ
Nếu không kết nối được, trước tiên hãy kiểm tra trong [claude mcp list] xem dòng [cloudways] có phải [Connected] không. Nếu địa chỉ không khớp với [https://mcp.cloudways.com/mcp/] đến tận dấu gạch chéo cuối, kết nối sẽ thất bại mà không có thông báo lỗi; còn nếu hiện [401 Unauthorized] thì token đã nhập sai hoặc đã bị thu hồi, hết hạn.
Khi đổi token, hãy xóa đăng ký bằng [claude mcp remove cloudways -s user] rồi đăng ký lại với token mới; nếu lệnh [claude] không chạy trong terminal, hãy chỉ định đường dẫn đầy đủ của tệp thực thi Claude Code để chạy.
Dễ nghĩ rằng đóng cửa sổ rồi mở lại thì danh sách công cụ cũng được làm mới, nhưng các chương trình như Claude Desktop, Cursor lưu danh sách công cụ từ lần kết nối đầu tiên và vẫn chạy ở khay hệ thống dù đã đóng cửa sổ. Nếu sau khi Cloudways thêm công cụ mà không thấy công cụ mới, hãy tắt rồi bật lại kết nối cloudways trong phần cài đặt, hoặc thoát hẳn chương trình (Cmd+Q trên macOS, thoát từ biểu tượng ở khay hệ thống trên Windows) rồi chạy lại.
🔢 FAQ & nội dung đề xuất
ℹ️ Thông báo tiếp thị liên kết
Nội dung trên trang này có chứa liên kết affiliate (tiếp thị liên kết). Khi khách truy cập mua sản phẩm hoặc dịch vụ qua các liên kết này, trang sẽ nhận hoa hồng từ bên bán. Trong quá trình đó, số tiền người mua phải trả (sẽ giảm khi có chương trình khuyến mãi ↓) không hề tăng lên. Giá, khuyến mãi và tình trạng hàng được đăng theo thời điểm viết bài và có thể khác với thực tế, vì vậy hãy kiểm tra lại lần cuối với bên bán trước khi mua. Việc chọn và đánh giá sản phẩm dựa trên tiêu chí riêng của trang; việc có nhận hoa hồng hay không không ảnh hưởng đến thứ tự giới thiệu hay nội dung đánh giá.