CloudBase AI ToolKit

CloudBase AI Toolkit

AI viết mã. CloudBase vận hành backend.

Lớp tích hợp CloudBase dành cho các công cụ lập trình AI: Plugin cài đặt toàn bộ stack, Skills định hướng cách viết mã, MCP thao tác với cơ sở dữ liệu, hàm, bộ nhớ lưu trữ và triển khai ngay trong cuộc trò chuyện.

English · 简体中文 · Tài liệu · Nhật ký thay đổi · Vấn đề

Cập nhật gần đây

v2.37.x (2026-11)

• Chẩn đoán: lỗi backend không rõ nguyên nhân được chuyển thành hướng dẫn bước tiếp theo; lỗi CLS của hàm kèm RequestId và hai hướng tự kiểm tra song song; thông báo cập nhật mã cho biết khi Status vẫn đang chạy
• An toàn / CloudRun: thao tác xóa hàng loạt sẽ từ chối thực hiện nếu client không thể xác nhận; đường dẫn đích CloudRun phải nằm trong dự án và không được trỏ đến thư mục thông tin xác thực của máy chủ
• PostgreSQL: migrationVersion phải là dấu thời gian lịch hợp lệ; migrationDetail chỉ cần có phiên bản; nới lỏng một số kiểm tra đường dẫn và SQL báo nhầm
• Hệ sinh thái: biến thể plugin Codex theo định dạng Agent Plugins; gói skill-market Qianwen; gói connector WorkBuddy cho trang web Trung Quốc

v2.36.x (2026-10)

• MCP Apps: ba bảng — môi trường, mức sử dụng môi trường và kết quả triển khai — được bật mặc định; đặt CLOUDBASE_MCP_UI=off để ẩn chúng
• An toàn: thao tác xóa, SQL phá hủy dữ liệu và các hành động xóa callCloudApi tương ứng sẽ tạm dừng để yêu cầu xác nhận, trong đó nêu rõ mục tiêu; đối số có dạng thông tin xác thực sẽ được kiểm tra chênh lệch một lần (độ dài cùng dấu vân tay sha256, không bao giờ là chính giá trị đó)
• Môi trường: bảng mức sử dụng có thêm chế độ xem chỉ số (QPS, số lần gọi, lỗi, hết thời gian chờ, tải MySQL và CloudRun) với tên dễ hiểu; việc cấp phát MySQL đã bị loại khỏi các công cụ
• Bắt đầu sử dụng: mọi phản hồi initialize đều có instructions kèm theo, nêu lệnh gọi chỉ đọc đầu tiên cần thực hiện; tài liệu thiết lập từ xa hiện ưu tiên OAuth

Bản phát hành · Đánh dấu sao · Theo dõi → Bản phát hành

Đây là gì

Các IDE AI (Cursor, Claude Code, Codex, CodeBuddy và các công cụ khác) rất giỏi tạo mã. Trở ngại thường gặp là backend: lược đồ, quyền, hàm, bộ nhớ lưu trữ, môi trường và phát hành.

CloudBase là backend tất cả trong một, ưu tiên AI của Tencent Cloud (cơ sở dữ liệu, bộ nhớ lưu trữ, xác thực, hàm đám mây, Cloud Run và nhiều dịch vụ khác). Repo này là Toolkit kết nối backend đó với các công cụ AI:

Repo này cung cấp gói npm @cloudbase/cloudbase-mcp, Skills và plugin AI.

Bạn vẫn cần môi trường CloudBase của riêng mình và nên xác nhận các thao tác nhạy cảm mà AI đề xuất. Toolkit cung cấp năng lực và lộ trình—không thay bạn phán đoán.

Các repo liên quan

Các repo phát hành và đồng bộ nằm trong TencentCloudBase. Những repo liên quan trực tiếp đến Toolkit này:

Ưu tiên Plugin nếu cần toàn bộ stack; chỉ dùng Skills khi bạn chỉ cần các ràng buộc về kiến thức. Với các IDE có marketplace, hãy dùng repo này—không chạy thêm npx plugins add trên cùng công cụ.

Bắt đầu nhanh

Cách nhanh nhất để bắt đầu

Sao chép prompt AI này vào IDE AI của bạn. Agent sẽ đọc skill.md và hoàn tất thiết lập:

Set up CloudBase for me:
1. Open https://docs.cloudbase.net/skill.md and complete the setup following its instructions.
2. Tell me when you're done, and suggest the most relevant next step.

npx plugins add TencentCloudBase/cloudbase-plugin

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

Prompt đầu tiên

Login to CloudBase

Use CloudBase Skills to build a todo app with login, database and permissions, then deploy

Skills định hình cấu trúc và thực tiễn; MCP xử lý môi trường và tài nguyên. Bạn cần có thể xác minh dữ liệu và API trong môi trường của riêng mình—không chỉ nhận được các tệp mã nguồn cục bộ.

Các IDE AI được hỗ trợ

Thiết lập đầy đủ: Hướng dẫn cho IDE.

Khả năng

Sau khi thiết lập, AI có thể thực hiện các công việc backend thông thường trong môi trường của bạn (hãy xác nhận các bước quan trọng):

• Cơ sở dữ liệu: PostgreSQL và document DB, mô hình dữ liệu, CRUD, quyền và quy tắc bảo mật
• Tính toán: viết, triển khai, gọi và gỡ lỗi hàm đám mây / Cloud Run
• Xác thực và bộ nhớ lưu trữ: phương thức đăng nhập, lưu trữ đối tượng, liên kết quyền với dữ liệu
• Phát hành và vận hành: hosting tĩnh / phát hành Mini Program; kiểm tra nhật ký và triển khai lại

Phù hợp với Web, WeChat Mini Programs và dịch vụ backend. Tổng quan nền tảng: tài liệu CloudBase.

Đánh giá

Trong điều kiện được kiểm soát, cùng một yêu cầu ứng dụng Todo và bộ khung frontend được dùng để so sánh hai lộ trình backend: máy ảo đám mây truyền thống (tự quản lý runtime, tiến trình và mức độ phơi lộ mạng) và CloudBase (cơ sở dữ liệu được quản lý, xác thực ẩn danh và các dịch vụ backend liên quan). Một agent AI thực hiện phát triển và xác minh từ đầu đến cuối. Với mô hình và thiết lập tác vụ này, lộ trình CloudBase có kết quả thuận lợi hơn về thời gian hoàn thành, mức sử dụng token và số lần gọi công cụ. Các kết quả này phụ thuộc vào mô hình, framework agent và định nghĩa tác vụ, không nên khái quát vượt quá phạm vi đó.

Phương pháp, dữ liệu và giới hạn: Đánh giá cùng tác vụ: máy ảo đám mây so với CloudBase

Cài đặt và kết nối

Điều kiện tiên quyết

• Node.js v18.15.0+
• Một môi trường CloudBase
• Một công cụ AI hỗ trợ Plugin / Skills / MCP

Tùy chọn thiết lập

1. Plugin (khi công cụ hỗ trợ)
   npx plugins add TencentCloudBase/cloudbase-plugin
2. MCP thủ công (ghi vào tệp cấu hình IDE)

Đã dùng CloudBase CLI? tcb ai cũng thiết lập MCP và Skills (tài liệu).

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

Các công cụ khác: Hướng dẫn thiết lập IDE.

Chế độ kết nối MCP

Từ xa (được khuyến nghị): IDE kết nối qua HTTP đến Tencent Cloud MCP. Không cần Node cục bộ; các client tương tác hoàn tất xác thực trong trình duyệt.

Chọn endpoint tương ứng với trang web nơi môi trường của bạn được lưu trữ—hai trang web sử dụng tài khoản, bảng điều khiển và thông tin xác thực riêng biệt.

OAuth (tương tác, được khuyến nghị): URL là toàn bộ cấu hình. IDE mở trình duyệt để đăng nhập và chấp thuận, sau đó bạn chọn môi trường tại đó—không cần khóa trong tệp cấu hình và không cần luân chuyển khóa.

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
    }
  }
}

Thông tin xác thực tĩnh (dành cho client không có OAuth và CI/CD): thêm env_id cùng một cặp khóa được tạo trên cùng trang web với endpoint.

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<Tencent Cloud Secret ID>",
        "X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
      }
    }
  }
}

Cặp khóa tĩnh vẫn có hiệu lực cho đến khi được luân chuyển hoặc xóa; phiên OAuth kết thúc khi bạn đăng xuất. Chỉ dùng dạng tĩnh khi không thể sử dụng quy trình qua trình duyệt—và không đưa nó vào repo.

Cục bộ: chạy npx @cloudbase/cloudbase-mcp@latest trên máy của bạn—đầy đủ tính năng, bao gồm tải lên từ hệ thống tệp cục bộ và tải mẫu xuống.

Đánh đổi khi dùng từ xa: không có các tính năng dùng hệ thống tệp cục bộ (tải lên, tải mẫu xuống), và trang web quốc tế hiện chưa cung cấp công cụ NoSQL.

URL từ xa cũng chấp nhận site (domestic / intl, chỉ cần cho môi trường trên trang web Trung Quốc trong ap-singapore, khi khu vực chưa rõ), cùng với enable_plugins / disable_plugins để giới hạn công cụ. Tên chuẩn nằm trong mcp/src/server.ts. Remote MCP E2E (client SDK chính thức): npm run test:hosted-mcp:e2e — xem tests/hosted-mcp-e2e/README.md để biết các chế độ apikey/OAuth, staging không bảo mật TLS và biến môi trường. Thiếu thông tin xác thực thì bỏ qua (thoát với mã 0).

Chế độ Cloud tự lưu trữ: đặt CLOUDBASE_MCP_CLOUD_MODE=true (hoặc MCP_CLOUD_MODE=true) để tắt các công cụ tệp và tiến trình cục bộ đối với các bên gọi từ xa.

Ví dụ

Gomoku trực tuyến: mô tả nhu cầu; nhận Web + cơ sở dữ liệu đám mây / realtime và triển khai.
Bản demo: Gomoku · Xem thêm: hướng dẫn

Tài liệu

• Công cụ MCP (tools.json)
• Bắt đầu
• Thiết lập IDE
• Plugin AI
• Mẫu
• Câu hỏi thường gặp

Câu hỏi thường gặp

{ "site": "domestic", "region": "ap-singapore", "envId": "your-env-id" }

Cộng đồng

Hoạt động

Người đóng góp

MIT · TencentCloudBase