Cài MCP và SDK cho công cụ AI

Claude Desktop và Cursor dùng JSON nào?

Thêm server monacloud vào phần cấu hình MCP của client. Nếu đã có server khác, giữ chúng và ghép thêm mục này.

{
  "mcpServers": {
    "monacloud": {
      "command": "npx",
      "args": ["-y", "monacloud-mcp"]
    }
  }
}

Codex và Claude Code cài bằng lệnh nào?

JSON ở trên là cấu hình client MCP chung; với Codex dùng lệnh CLI để đăng ký server vào cấu hình của Codex.

codex mcp add monacloud -- npx -y monacloud-mcp
claude mcp add monacloud -- npx -y monacloud-mcp
npx -y monacloud-mcp login

Agent nên gọi tool theo thứ tự nào?

cloud_link kiểm tra liên kết, cloud_prices và cloud_packages đọc giá/cấu hình. Sau khi được duyệt, gọi cloud_vps_create hoặc cloud_db_create, poll bằng cloud_job_status, kiểm tra bằng cloud_services_list.

cloud_service_start, cloud_service_stop, cloud_service_rebuild dùng cho vận hành. Deploy repo dùng cloud_app_create; cloud_agent_deploy dành cho runtime agent riêng.

Cài SDK Python và Node thế nào?

pip install monacloud
npm install monacloud-cloud-sdk

Xem mã và tài liệu tại The MONA Group trên GitHub. Tài liệu đi kèm chưa cung cấp chữ ký method SDK, nên ví dụ HTTP ở API reference là hợp đồng để đối chiếu.

Có cần dán token vào cấu hình JSON không?

Không cần với luồng đăng nhập MCP bên trên. Đăng nhập tương tác một lần; không thêm password hoặc token vào JSON công khai, issue hay repository.

MCP 0.3.2 có những tool app nào?

Host đầu tiên ~150 giây, deploy repo mẫu 10–20 giây; xoá app → tạo lại 31 giây khi có host. Host tính phí như VPS theo giờ/tháng; app không tính thêm. Xem hướng dẫn app từ git.

CLI 0.3.1 có lệnh nào?

npx monacloud plans
npx monacloud invoices
npx monacloud vps create --plan kinh-doanh --monthly
npx monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile --sandbox
npx monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile

Chọn mã gói từ plans. Với repo hiện tại có remote và nhánh, dùng npx monacloud deploy. App thật cần duyệt ước tính; sandbox trả URL giả. Repo private đang mở qua GitHub App.

Deploy repo public của tôi bằng cloud_app_create. Đọc stack, build, cổng, env và database của dự án. Gọi cloud_app_list, cloud_app_host_list, cloud_plan_list, cloud_prices và cloud_balance. Chưa có host thì thử sandbox=true; báo phí giờ/tháng và chờ tôi duyệt trước khi tạo thật. Poll job, kiểm cloud_app_get/cloud_app_logs và HTTPS rồi trả URL. Không đưa secret vào chat. Repo private đang mở qua GitHub App.