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

MCP monacloud-mcp 0.3.2 và CLI monacloud 0.3.1 đã LIVE: deploy repo public, quản lý app, gói tháng, hóa đơn và credit. Đăng nhập MONA Pass một lần; thử sandbox, duyệt phí host rồi nhận URL HTTPS. Repo private đang mở qua GitHub App.

## 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.


```json
{
  "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.


```bash
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?


```bash
pip install monacloud
npm install monacloud-cloud-sdk
```

Xem mã và tài liệu tại [The MONA Group trên GitHub](https://github.com/themonagroup). Tài liệu đi kèm chưa cung cấp chữ ký method SDK, nên ví dụ HTTP ở [API reference](/docs/api) 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?

| Tool | Công dụng |
|---|---|
| `cloud_app_create`, `cloud_app_list`, `cloud_app_get` | Deploy repo public, liệt kê và đọc app |
| `cloud_app_deploy`, `cloud_app_env_set` | Deploy lại; thay toàn bộ env rồi deploy để áp dụng |
| `cloud_app_domain_add`, `cloud_app_logs`, `cloud_app_delete` | Thêm domain, đọc log, xoá app |
| `cloud_app_host_list` | Kiểm tra host trước khi tạo |
| `cloud_plan_list` | Đọc gói, giá tháng/năm |
| `cloud_subscription_list`, `cloud_subscription_update` | Xem và đổi subscription |
| `cloud_invoice_list`, `cloud_invoice_pdf` | Xem hoá đơn và tải file |
| `cloud_credit_redeem` | Dùng mã credit được cung cấp |

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](/docs/deploy-nodejs).

## CLI 0.3.1 có lệnh nào?

```bash
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.

## Prompt mẫu cho AI


```text
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.
```

Trước: [API reference: endpoint và ví dụ curl](/docs/api) · Tiếp: [Ví VND và nạp tiền bằng VietQR](/docs/vi-va-nap-tien)

[Đọc trang HTML](https://monacloud.vn/docs/mcp-va-sdk)