> Đặt MONACLOUD_TOKEN, chạy npx -y monacloud deploy trong thư mục dự án, thử --sandbox miễn phí, đồng ý báo giá rồi nhận URL HTTPS, không cần GitHub.

Nguồn: https://monacloud.vn/docs/bat-dau-nhanh · Cập nhật: 2026-09-21

# Bắt đầu nhanh trong 5 phút

Đặt `MONACLOUD_TOKEN` rồi chạy `npx -y monacloud deploy` trong thư mục dự án, không cần GitHub. Bạn thử `--sandbox` miễn phí trước, đồng ý với báo giá host rồi nhận URL HTTPS. Upload API đo 112 giây; MCP local 33 giây khi đã có host.

## Tôi cần chuẩn bị gì trong 5 phút?

Chuẩn bị email, thư mục dự án hoặc repository của app và công cụ AI bạn đang dùng. Năm phút là thời gian làm quen với luồng, không bao gồm chờ chuyển khoản hoặc triển khai toàn bộ ứng dụng.

1. Mở [console](https://console.monacloud.vn), chọn đăng ký MONA Pass và làm theo bước xác minh.
2. Giao cho AI: AI gọi `cloud_topup`, in mã VietQR ngay trong terminal; bạn kiểm tra người nhận, số tiền, nội dung rồi quét bằng app ngân hàng. Console vẫn có trang ví nếu bạn muốn nạp tay.
3. Đợi số dư cập nhật rồi mới tạo tài nguyên tính phí. Bạn có thể thử sandbox ngay khi chưa nạp tiền.

**Kiểm thử 17/09/2026:** nạp bằng QR do AI tạo, tiền cộng ví tự động. Nếu chưa có QR hợp lệ, dừng chuyển khoản và gọi [1900 636 648](tel:1900636648); xem [ví và nạp tiền](https://monacloud.vn/docs/vi-va-nap-tien).

## Không có GitHub thì đưa web lên thế nào?

Mở terminal trong thư mục dự án có Dockerfile/package.json. Đặt `MONACLOUD_TOKEN` trong môi trường, CLI tự tải MCP qua npx:

Thử sandbox rồi deploy thư mục hiện tại

```
npx -y monacloud deploy --sandbox
npx -y monacloud deploy
```

Lệnh đầu thử miễn phí. Sau khi bạn đồng ý với báo giá, lệnh thứ hai upload thư mục hiện tại. Không cần tạo repository. Dùng `--git` để lấy remote hiện tại hoặc `--repo <url>` nếu có GitHub public.

Với AI, dùng `cloud_app_detect(local_dir)` rồi `cloud_app_create({local_dir})`; MCP tự đóng zip và upload. Ví local đọc số dư qua `GET /api/me`. Xem [hướng dẫn local: MCP, CLI và hai lệnh curl](https://monacloud.vn/agent-guide#deploy-từ-thư-mục-local-không-cần-github).

| Kết quả mong đợi | Thời gian đo ngày 05/09/2026 (tối) |
| --- | --- |
| Upload API tới khi URL HTTPS trả 200, gồm build image | 112 giây |
| MCP `cloud_app_create(local_dir)` tới khi có URL HTTPS, host đã có | 33 giây |
| App host đầu tiên | ~150 giây |

Đây là số đo, không phải cam kết thời gian build cho mọi dự án.

## Tạo VPS bằng prompt hay CLI thế nào?

Cài MCP cho AI và đăng nhập một lần. MCP 0.5.0 và CLI 0.4.1 hỗ trợ deploy thư mục local và repo public.

Khởi tạo CLI và đăng nhập MCP

```
npx monacloud init
npx -y monacloud-mcp login
```

**Claude Code.** Chạy trong terminal.

Claude Code

```
claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp
```

**Claude.ai (người bấm).** Vào Settings → Connectors → Add custom connector. Điền thông tin, bấm Add rồi đăng nhập MONA Pass.

Claude.ai

```
Name: MONA Cloud
URL: https://mcp.monacloud.vn/mcp
```

**Codex.** Thêm vào `~/.codex/config.toml`.

Codex

```
[mcp_servers.monacloud]
url = "https://mcp.monacloud.vn/mcp"
```

**Gemini (Antigravity).** Chạy trong terminal. Cấu hình lưu tại `~/.gemini/config/mcp_config.json`; kiểm tra bằng `agy mcp list`.

Gemini (Antigravity)

```
agy mcp add monacloud https://mcp.monacloud.vn/mcp
```

**Cursor.** Thêm vào `.cursor/mcp.json`.

Cursor

```
{ "mcpServers": { "monacloud": { "url": "https://mcp.monacloud.vn/mcp" } } }
```

## Giao thẳng cho AI tự cài

Prompt cho Claude, Codex hoặc Gemini

```
Cài MCP MONA Cloud giúp tôi rồi kiểm tra chạy được chưa. Nếu bạn là Claude Code: chạy `claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp`. Nếu là Codex: thêm `[mcp_servers.monacloud]` với `url = "https://mcp.monacloud.vn/mcp"` vào `~/.codex/config.toml`. Nếu là Gemini/Antigravity: chạy `agy mcp add monacloud https://mcp.monacloud.vn/mcp`. Cài xong gọi thử `cloud_domain_search` với tên tôi muốn mua rồi báo giá cho tôi.
```

Giao prompt cuối bài cho AI. AI dùng `cloud_vps_create`, nhận job rồi dùng `cloud_job_status` theo dõi kết quả.

## Tôi muốn thử API trực tiếp thì sao?

Đặt token trong máy của bạn rồi gửi lệnh sandbox:

Đặt địa chỉ API và token trong shell

```
export MONACLOUD_API="https://api.monacloud.vn"
# Đặt token trong phiên shell riêng, không gửi vào chat.
export MONACLOUD_TOKEN="<token-cua-ban>"
```

Tạo VPS trong sandbox

```
curl -sS -X POST "$MONACLOUD_API/api/lxc" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN" \
  -H "X-Vibecloud-Sandbox: 1" \
  -H "Content-Type: application/json" \
  -d '{"app_name":"app-demo","cpu":1,"ram_gb":1,"disk_gb":10}'
```

Theo dõi job tạo VPS

```
export JOB_ID="<id-tra-ve-khi-tao>"
curl -sS "$MONACLOUD_API/api/jobs/$JOB_ID" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN"
```

Sandbox hoàn tất ở `done`; job tính phí hoàn tất ở `succeeded`. Đọc `result.service_id`, kiểm tra service, rồi mới lấy credential theo [hướng dẫn SSH](https://monacloud.vn/docs/ssh-va-console).

## Khi nào chuyển sang máy chủ tính phí?

Đọc [giá](https://monacloud.vn/bang-gia), xác nhận số dư và cấu hình. Sau khi bạn đồng ý với báo giá, bỏ header `X-Vibecloud-Sandbox: 1` ở lệnh tạo; lệnh này sẽ tính tiền.

**Số đo 05/09/2026:** VPS mất 11 giây để tạo, không bao gồm deploy source.

## Deploy app từ repo public thế nào?

Deploy repo Node.js mẫu: sandbox, sau đó tính phí

```
npx -y monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile --sandbox
npx -y monacloud deploy --repo https://github.com/themonagroup/monacloud-example-node --branch main --build dockerfile
```

App không tính thêm; host tính như VPS theo giờ hoặc gói tháng. Đọc [hướng dẫn app từ git](https://monacloud.vn/docs/deploy-nodejs) để xem prompt `cloud_app_create`, curl `POST /api/apps` và URL mẫu. Repo private đang mở qua GitHub App. Console đã có /apps, /subscriptions, /invoices và đổi mã credit.

## Prompt mẫu cho AI

Prompt deploy thư mục local · không chứa secret

```
Đưa dự án trong thư mục này lên web bằng MONA Cloud. Token ở biến MONACLOUD_TOKEN. Dùng cloud_app_detect rồi cloud_app_create với local_dir, xong đưa tôi link https.
```