> Cài MCP monacloud-mcp 0.5.0 cho Claude, Cursor, Codex và SDK Python, Node. CLI monacloud 0.4.1 deploy thư mục hiện tại, thêm --sandbox để thử miễn phí.

Nguồn: https://monacloud.vn/docs/mcp-va-sdk · Cập nhật: 2026-09-21

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

MCP `monacloud-mcp` 0.5.0 có `cloud_app_detect(local_dir)` và `cloud_app_create({local_dir})` để đưa source local lên web. CLI `monacloud` 0.4.1 mặc định deploy thư mục hiện tại; đặt `MONACLOUD_TOKEN` là chạy, CLI tự tải MCP qua npx. Thêm `--sandbox` để thử miễn phí.

## Claude Code cài ở đâu?

Chạy lệnh này trong terminal.

Claude Code

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

## Claude.ai thêm connector thế nào?

Vào Settings → Connectors → Add custom connector. Điền tên và URL, bấm Add rồi đăng nhập MONA Pass.

Claude.ai (người bấm)

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

## Codex thêm cấu hình nào?

Thêm hai dòng sau vào `~/.codex/config.toml`.

Codex

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

## Gemini (Antigravity) cài bằng lệnh nào?

Chạy trong terminal. Antigravity lưu cấu hình 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 dùng JSON nào?

Thêm server `monacloud` 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.
```

## 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 người dùng đồng ý với báo giá, 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?

Cài SDK Python và Node

```
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](https://monacloud.vn/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.5.0 có những tool app nào?

| Tool | Công dụng |
| --- | --- |
| `cloud_app_detect(local_dir)` | Đoán stack/port/Dockerfile, offline |
| `cloud_app_create({local_dir})` | Tự đóng zip và upload source local; vẫn nhận `repo_url` cho git |
| `cloud_app_list`, `cloud_app_get` | 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 |

Ví local đọc số dư qua `GET /api/me`. 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](https://monacloud.vn/docs/deploy-nodejs).

**Số đo 05/09/2026 (tối):** upload API 112 giây gồm build image; MCP local 33 giây khi host đã có. Host đầu tiên ~150 giây, deploy repo mẫu 10–20 giây; xoá app rồi tạo lại mất 31 giây khi có host.

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

Đặt `MONACLOUD_TOKEN` là chạy; CLI tự tải MCP qua npx. Trong thư mục có Dockerfile/package.json:

Các lệnh CLI monacloud 0.4.1

```
npx -y monacloud deploy --sandbox
npx -y monacloud deploy
npx -y monacloud deploy --git
npx monacloud plans
npx monacloud invoices
npx monacloud vps create --plan kinh-doanh --monthly
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
```

Chọn mã gói từ `plans`. Mặc định `npx -y monacloud deploy` deploy thư mục hiện tại. `--git` dùng remote hiện tại; `--repo <url>` dùng GitHub public chỉ định. App tính phí cần bạn đồng ý với báo giá; sandbox trả URL giả. Repo private đang mở qua GitHub App.

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