CloudBase AI ToolKit
официальныйПереход от AI-подсказки к работающему приложению в один клик. CloudBase AI ToolKit — это мост, который напрямую соединяет вашу AI IDE (Cursor, Copilot и т. д.) с Tencent CloudBase.
Что можно делать с Cloud Base AI Tool Kit MCP?
- Log into your CloudBase environment — ask the AI to authenticate and select an environment so subsequent operations target your own backend.
- Query and modify database records — use
databasetools to perform CRUD operations on CloudBase’s document or PostgreSQL databases. - Deploy cloud functions and static hosting — instruct the AI to author, deploy, and invoke cloud functions or publish frontend assets to static hosting.
- Manage auth and storage — configure login methods, set object storage permissions, and link access rules to your data models.
- Inspect logs and redeploy services — read runtime logs to debug issues and trigger redeployment of CloudRun services or functions.
Документация
CloudBase AI Toolkit
ИИ пишет код. CloudBase запускает бэкенд.
Интеграционный слой CloudBase для ИИ-инструментов написания кода: Plugin устанавливает стек, Skills направляют стиль написания кода, MCP управляет базами данных, функциями, хранилищем и развертыванием прямо из чата.
Последние обновления
v2.25.x (июль 2026)
- CloudRun / Gateway: рекомендации по VPC при использовании TCP-баз данных; Domain/Route с
upstreamResourceTypeи передачей пути - CloudRun / Gateway: сохранение удаленного VPC и конфигурации окружения при повторном развертывании; предпочтение пользовательских доменных URL после развертывания
- Plugin: упрощенная установка через Open Plugin / упаковку marketplace
Releases · Star · Watch → Releases
Что это такое
ИИ-IDE (Cursor, Claude Code, Codex, CodeBuddy и другие) сильны в генерации кода. Обычно вас блокирует бэкенд: схемы, разрешения, функции, хранилище, окружения и релиз.
CloudBase — это AI-нативный универсальный бэкенд Tencent Cloud (база данных, хранилище, аутентификация, облачные функции, Cloud Run и многое другое). Этот репозиторий — Toolkit, который соединяет этот бэкенд с ИИ-инструментами:
| Компонент | Роль |
|---|---|
| Plugin | Устанавливает MCP Server, Agent Skills и Hooks вместе — меньше ручной настройки для каждой IDE |
| Agent Skills | Сценарные навыки (Web / Mini Program / база данных / аутентификация / функции и т. д.) для практичной работы с CloudBase |
| MCP | Вход, запрос и изменение данных, управление функциями и хостингом, чтение логов — прямо из диалога |
Этот репозиторий поставляет npm-пакет @cloudbase/cloudbase-mcp, Skills и ИИ-плагины.
Вам всё равно понадобится собственное окружение CloudBase, и вы должны подтверждать чувствительные действия, которые предлагает ИИ. Toolkit предоставляет возможности и путь — но не суждение.
Связанные репозитории
Репозитории публикации и синхронизации находятся в TencentCloudBase. Напрямую связаны с этим Toolkit:
| Репозиторий | Содержимое | Типичная точка входа |
|---|---|---|
| CloudBase-AI-Toolkit (этот репозиторий) | Исходный код MCP Server; исходный код marketplace для Claude Code / Codex | npx @cloudbase/cloudbase-mcp@latest |
| cloudbase-plugin | Репозиторий публикации Open Plugin Spec (синхронизируется через CI): MCP + Skills + Hooks | npx plugins add TencentCloudBase/cloudbase-plugin · запасной вариант CNB: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git |
| cloudbase-sites-plugin | Плагин Sites: создание и развертывание Vite Web | npx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git |
| cloudbase-skills | Коллекция Agent Skills | npx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git |
| skills | Каталог установки отдельных навыков (также на skills.sh) | npx skills add tencentcloudbase/skills --skill <name> |
| awesome-cloudbase-examples | Примеры CloudBase и кейсы | Просмотр / клонирование примеров |
| OpenVibeCoding | Шаблон Vibecoding на CloudBase | Использовать как стартовый проект |
Предпочитайте Plugin для полного стека; Skills — когда нужны только ограничения знаний. Для IDE с marketplace используйте этот репозиторий — не запускайте также npx plugins add в том же инструменте.
Быстрый старт
Выберите один путь по умолчанию для вашего инструмента.
| Ваш инструмент | Рекомендуемый путь |
|---|---|
| Claude Code / Codex (нативный marketplace) | Добавьте этот репозиторий как marketplace, затем установите плагин cloudbase (документация плагина) |
| Инструменты Open Plugin Spec | npx plugins add TencentCloudBase/cloudbase-plugin |
| Предпочитаете один CLI для многих инструментов | CloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai |
| CodeBuddy / WorkBuddy / ZCode (встроенные) | Используйте встроенный плагин CloudBase или коннектор IDE |
| Другие IDE с поддержкой MCP | Только конфигурация MCP (ниже) |
Plugin
npx plugins add TencentCloudBase/cloudbase-plugin
Подробности и различия IDE: документация AI-плагинов.
Только MCP
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
Хостируемый HTTP, самостоятельный Cloud Mode и область действия плагина: Установка и подключение.
Первые запросы
Login to CloudBase
Use CloudBase Skills to build a todo app with login, database and permissions, then deploy
Skills формируют структуру и практику; MCP управляет окружением и ресурсами. Вы должны иметь возможность проверять данные и API в собственном окружении — не только получать локальные исходные файлы.
Поддерживаемые ИИ-IDE
| Инструмент | Платформа | Руководство |
|---|---|---|
| CloudBase AI CLI | CLI | Руководство |
| OpenClaw | CLI | Руководство |
| WorkBuddy | Автономная IDE | Руководство |
| ZCode | Автономная IDE (≥ 3.4.1 встроенная) | Руководство |
| Codex App | Приложение | Руководство |
| Cursor | Автономная IDE | Руководство |
| WindSurf | IDE / плагины | Руководство |
| CodeBuddy | Автономная IDE (встроенная) | Руководство |
| CLINE | Плагин VS Code | Руководство |
| GitHub Copilot | Плагин VS Code | Руководство |
| Trae | Автономная IDE | Руководство |
| Tongyi Lingma | IDE / плагины | Руководство |
| RooCode | Плагин VS Code | Руководство |
| Baidu Comate | Плагины | Руководство |
| Augment Code | Плагины | Руководство |
| Claude Code | CLI | Руководство |
| Gemini CLI | CLI | Руководство |
| Codex CLI | CLI | Руководство |
| OpenCode | CLI | Руководство |
| Qwen Code | CLI | Руководство |
Полная настройка: руководства по IDE.
Возможности
После настройки ИИ может выполнять типичную бэкенд-работу в вашем окружении (подтверждайте критические шаги):
- База данных: PostgreSQL и документная БД, модели данных, CRUD, разрешения и правила безопасности
- Вычисления: создание, развертывание, вызов и отладка облачных функций / Cloud Run
- Аутентификация и хранилище: способы входа, объектное хранилище, связывание разрешений с данными
- Релиз и эксплуатация: статический хостинг / публикация Mini Program; просмотр логов и повторное развертывание
Подходит для Web, WeChat Mini Programs и бэкенд-сервисов. Обзор платформы: документация CloudBase.
Оценка
В контролируемых условиях одно и то же техническое задание Todo-приложения и фронтенд-каркас использовались для сравнения двух бэкенд-путей: традиционная облачная VM (самоуправляемая среда выполнения, процесс и сетевая экспозиция) и CloudBase (управляемая база данных, анонимная аутентификация и связанные бэкенд-сервисы). ИИ-агент выполнял сквозную разработку и проверку. При данной модели и постановке задачи путь CloudBase оказался более благоприятным по задержке завершения, использованию токенов и количеству вызовов инструментов. Эти результаты обусловлены моделью, агентским фреймворком и определением задачи и не должны обобщаться за пределами этого контекста.
Методы, данные и ограничения: Оценка одной задачи: облачная VM против CloudBase
Установка и подключение
Предварительные требования
- Node.js v18.15.0+
- Окружение CloudBase
- ИИ-инструмент с поддержкой Plugin / Skills / MCP
Варианты настройки
- Plugin (если инструмент поддерживает)
npx plugins add TencentCloudBase/cloudbase-plugin - CloudBase AI CLI
npm i -g @cloudbase/cli && tcb ai - Ручной MCP (напишите файл конфигурации IDE)
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
WindSurf (.windsurf/settings.json)
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
CodeBuddy
CloudBase встроен (MCP / Skills); ручная настройка обычно не требуется.
Другие: руководство по настройке IDE.
Режимы подключения MCP
Локальный (по умолчанию): npx на вашей машине — полный набор функций, включая локальную загрузку файлов/шаблонов.
Хостируемый: IDE подключается по HTTP к MCP Tencent Cloud; локальный Node не требуется. Некоторые функции локальных файлов недоступны.
{
"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>"
}
}
}
}
Хостируемые URL могут использовать enable_plugins / disable_plugins. Канонические имена находятся в mcp/src/server.ts.
Самостоятельный Cloud Mode: установите CLOUDBASE_MCP_CLOUD_MODE=true (или MCP_CLOUD_MODE=true), чтобы локальные файловые и процессные инструменты были отключены для удалённых вызывающих.
| Сценарий | Рекомендация |
|---|---|
| Личное использование | Локальный npx |
| Команда / нулевая эксплуатация | Хостируемый HTTP |
| Самостоятельный MCP | Cloud Mode обязателен |
Пример
Онлайн-гомоку: опишите потребность; получите Web + облачную базу данных / realtime и развертывание.
Демо: Гомоку · Больше: учебники
Документация
FAQ
Чем это отличается от Vercel / Netlify?
Они сосредоточены на доставке фронтендов или контейнеров. CloudBase предоставляет бэкенд-строительные блоки (база данных, аутентификация, функции). Toolkit позволяет ИИ-инструментам использовать их в чате. Развертывание — лишь часть пути.
Могу ли я использовать это без GUI IDE?
Да. Любой инструмент, который может настроить MCP Server или установить соответствующий Plugin / Skills, подходит — включая Claude Code, Gemini CLI, OpenCode. Список поддержки
Куда попадает мой код?
Развертывание направлено в ваше собственное окружение CloudBase. В локальном режиме MCP работает на вашей машине; код не покидает её до развертывания. Облачный трафик использует HTTPS.
Безопасно ли самостоятельное размещение MCP-сервера?
Локальный npx эквивалентен самостоятельному запуску инструментов. Для удалённых хостов установите CLOUDBASE_MCP_CLOUD_MODE=true, чтобы отключить локальные файловые/процессные инструменты. Хостируемый HTTP Tencent Cloud включает эту защиту.
Стоимость?
Toolkit (включая MCP) — открытый исходный код под MIT. У CloudBase есть бесплатные квоты; использование сверх них оплачивается — см. тарифы.
Вход говорит, что окружение не существует?
Убедитесь, что окружение существует и здорово в консоли, затем войдите снова и выберите правильное.
Сообщество
| Документация | docs.cloudbase.net |
| Проблемы | GitHub Issues |
| Релизы | Changelog |