MCP

HiTechCloud cung cấp một máy chủ MCP tại /mcp. Sau khi kết nối, Claude (hoặc bất kỳ MCP client nào khác) có thể quản lý trực tiếp tài khoản của bạn: liệt kê và tạo cơ sở dữ liệu, quản lý tên miền, bản ghi DNS, tác vụ cron, tài khoản email và mọi thứ khác có trong /api/.

Trên trang Tài khoản > MCP của giao diện, bạn có thể tạo và quản lý token dùng với Claude (MCP).

Tài liệu HiTechCloud API

Yêu cầu​

• Máy chủ phải chạy phiên bản Enterprise.
• Gói của bạn phải bật cả hai tính năng API và MCP. Nếu không thấy /account/mcp trên thanh bên của tài khoản, hãy nhờ nhà cung cấp hosting bật chúng.

1. Tạo token​

1. Vào Tài khoản → MCP (/account/mcp).
2. Đặt tên cho token (ví dụ Laptop - Claude Desktop) và nhấn Tạo token mới.
3. Sao chép token ngay: nó chỉ hiển thị một lần, ngay sau khi tạo.

Khi tạo token, bạn cũng có thể đặt:

• Expiry: không bao giờ, 30 ngày, 90 ngày hoặc 1 năm. Mặc định token không hết hạn, vì vậy hãy đặt một trong các giới hạn thời gian nếu bạn muốn nó tự ngừng hoạt động sau một thời gian.
• Chỉ đọc: giới hạn token chỉ dùng yêu cầu GET/HEAD, để Claude có thể tra cứu (liệt kê website, kiểm tra dung lượng đĩa, đọc bản ghi DNS, v.v.) nhưng không thể tạo, thay đổi hay xoá gì. Nên dùng cho mọi trường hợp ngoài trợ lý đáng tin cậy của riêng bạn.

Cả hai thiết lập được hiển thị bên cạnh mỗi token sau đó, và thu hồi token bất cứ lúc nào từ cùng trang sẽ có hiệu lực ngay nếu không còn cần đến hoặc bạn nghĩ nó đã bị lộ.

2. Kết nối​

Endpoint MCP của panel là https://<your-panel-domain>:<port>/mcp. Hãy sao chép từ /account/mcp thay vì tự gõ: trang in ra chính xác URL cho máy chủ này, kèm cổng. Panel mặc định không lắng nghe trên cổng 443 — nó lắng nghe trên 2083 — nên URL thiếu cổng sẽ không kết nối được.

Claude Code (CLI)​

claude mcp add --transport http hitechcloud https://<your-panel-domain>:<port>/mcp \
  --header "Authorization: Bearer <your-token>"

Claude Desktop​

Thêm nội dung sau vào claude_desktop_config.json:

{
  "mcpServers": {
    "hitechcloud": {
      "url": "https://<your-panel-domain>:<port>/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

Khởi động lại Claude Desktop sau khi lưu. Các công cụ của HiTechCloud sẽ xuất hiện trong bộ chọn công cụ.

3. Sử dụng​

Sau khi kết nối, chỉ cần hỏi Claude bằng ngôn ngữ tự nhiên, ví dụ:

• "Liệt kê mọi website của tôi và trạng thái của chúng"
• "Tạo một cơ sở dữ liệu MySQL mới tên shop và một người dùng cho nó"
• "Thêm bản ghi A cho shop.example.com trỏ tới 1.2.3.4"
• "Cho tôi xem dung lượng đĩa của example.com"
• "Tạo tác vụ cron hằng ngày chạy /var/www/html/backup.sh lúc 2 giờ sáng"

Mọi thao tác Claude thực hiện đều chạy qua chính các endpoint /api/ và kiểm tra quyền giống như giao diện panel và REST API: Claude chỉ hoạt động trong phạm vi tài khoản của bạn và các tính năng được bật trong gói. Nếu một yêu cầu thất bại với lỗi quyền, thường là do tính năng đó chưa được bật trong gói của bạn. Với token chỉ đọc, mọi thao tác ngoài tra cứu sẽ bị chặn.

Các công cụ​

Không có bộ công cụ AI riêng được viết tay. Máy chủ MCP cung cấp một công cụ cho mỗi endpoint REST được ghi tài liệu, được tạo lúc khởi động từ cùng danh sách endpoint mà tài liệu API hiển thị. Vì vậy danh sách công cụ và REST API là cùng một bề mặt, và bất cứ thứ gì bạn đọc được trong tài liệu API, bạn đều có thể yêu cầu MCP client thực hiện.

Tên công cụ được suy ra từ đường dẫn endpoint: bỏ tiền tố /api/, rồi đổi mọi / và - thành _. Tham số đường dẫn giữ nguyên tên. Khi cùng một đường dẫn được ghi tài liệu cho nhiều phương thức HTTP, phương thức viết thường được thêm vào cuối để phân biệt.

Mỗi công cụ nhận tham số đường dẫn dưới dạng đối số có tên, cùng một đối tượng body cho POST/PUT/PATCH hoặc một đối tượng query tuỳ chọn cho GET/DELETE. Mô tả của mỗi công cụ nhắc lại tính năng gói mà nó cần.

Các nhóm hiện có, và tính năng gói mà mỗi nhóm phụ thuộc:

Hai endpoint được cố ý không cung cấp dưới dạng công cụ: /api/login và /api/endpoints.

Những gì trợ lý không thể làm​

MCP client không bao giờ có nhiều quyền hơn bạn. Mỗi lời gọi công cụ được thực hiện lại qua API riêng của panel bằng token của bạn, nên nó đi qua đúng các kiểm tra mà trình duyệt của bạn trải qua: tính năng của gói, phiên bản của máy chủ, cổng route và chế độ demo. Công cụ cần một tính năng mà gói của bạn không có sẽ trả về "Access denied" — công cụ vẫn xuất hiện trong danh sách, vì danh sách thuộc về sản phẩm, không thuộc về gói của bạn.

Các thao tác được ghi vào Tài khoản → Hoạt động dưới tên tài khoản của bạn, không phải "AI", vì đối với panel, chính bạn đã cho phép chúng.

Token chỉ đọc bị giới hạn ở GET và HEAD trên mọi đường dẫn trừ chính /mcp, đường dẫn này phải để mở vì giao thức truyền MCP là JSON-RPC qua POST. Đặc biệt, token chỉ đọc không thể tạo token khác: nó không thể dùng account_mcp_post để tự cấp cho mình thông tin xác thực toàn quyền.

Khắc phục sự cố​

Lưu ý bảo mật​

• Hãy coi token MCP như mật khẩu: bất kỳ ai có nó đều có thể thao tác trên tài khoản của bạn qua mọi endpoint /api/ được bật (trừ khi nó là token chỉ đọc).
• Ưu tiên token chỉ đọc và/hoặc thời hạn ngắn cho mọi trường hợp ngoài trợ lý đáng tin cậy của riêng bạn: điều này hạn chế đáng kể những gì một token bị lộ có thể làm.
• Token được lưu dạng băm; bộ phận hỗ trợ không thể khôi phục token bị mất, chỉ có thể cấp token mới.
• Thu hồi token có hiệu lực ngay lập tức.