CloudBase AI ToolKit
oficialVe de un prompt de IA a una aplicación en vivo con un solo clic. CloudBase AI ToolKit es el puente que conecta tu IDE de IA (Cursor, Copilot, etc.) directamente con Tencent CloudBase.
¿Qué puedes hacer con Cloud Base AI Tool Kit MCP?
- Inicia sesión en tu entorno de CloudBase — pide a la IA que se autentique y seleccione un entorno para que las operaciones posteriores apunten a tu propio backend.
- Consulta y modifica registros de la base de datos — usa las herramientas de
databasepara realizar operaciones CRUD en las bases de datos de documentos o PostgreSQL de CloudBase. - Despliega funciones en la nube y alojamiento estático — indica a la IA que cree, despliegue e invoque funciones en la nube o publique activos de frontend en el alojamiento estático.
- Gestiona autenticación y almacenamiento — configura métodos de inicio de sesión, establece permisos de almacenamiento de objetos y vincula reglas de acceso a tus modelos de datos.
- Inspecciona registros y vuelve a desplegar servicios — lee los registros de ejecución para depurar problemas y activa el redespliegue de servicios o funciones de CloudRun.
Documentación
CloudBase AI Toolkit
La IA escribe el código. CloudBase ejecuta el backend.
La capa de integración de CloudBase para herramientas de codificación con IA: el Plugin instala la pila, las Skills orientan cómo se escribe el código, MCP opera bases de datos, funciones, almacenamiento y despliega desde el chat.
Actualizaciones recientes
v2.25.x (2026-07)
- CloudRun / Gateway: guía de VPC al usar bases de datos TCP; Dominio/Ruta con
upstreamResourceTypey transmisión de ruta - CloudRun / Gateway: conserva la configuración remota de VPC y entorno al redesplegar; prefiere URLs de acceso de dominio personalizado después del despliegue
- Plugin: instalación más fácil mediante Open Plugin / empaquetado de marketplace
Releases · Star · Watch → Releases
Qué es
Los IDEs de IA (Cursor, Claude Code, Codex, CodeBuddy y otros) son muy buenos generando código. Lo que normalmente te bloquea es el backend: esquemas, permisos, funciones, almacenamiento, entornos y lanzamiento.
CloudBase es el backend integral nativo de IA de Tencent Cloud (base de datos, almacenamiento, autenticación, funciones en la nube, Cloud Run y más). Este repositorio es el Toolkit que conecta ese backend con las herramientas de IA:
| Pieza | Rol |
|---|---|
| Plugin | Instala MCP Server, Agent Skills y Hooks juntos—menos configuración por IDE |
| Agent Skills | Skills de escenarios (Web / Mini Program / base de datos / autenticación / funciones, etc.) hacia prácticas viables de CloudBase |
| MCP | Iniciar sesión, consultar y modificar datos, gestionar funciones y hosting, leer registros—desde la conversación |
Este repositorio incluye el paquete npm @cloudbase/cloudbase-mcp, Skills y plugins de IA.
Aún necesitas tu propio entorno de CloudBase, y debes confirmar las acciones sensibles que la IA proponga. El Toolkit proporciona capacidad y camino—no juicio.
Repositorios relacionados
Los repositorios de publicación y sincronización viven bajo TencentCloudBase. Directamente relacionados con este Toolkit:
| Repositorio | Contenido | Entrada típica |
|---|---|---|
| CloudBase-AI-Toolkit (este repositorio) | Código fuente de MCP Server; fuente de marketplace para Claude Code / Codex | npx @cloudbase/cloudbase-mcp@latest |
| cloudbase-plugin | Repositorio de publicación de Open Plugin Spec (sincronizado por CI): MCP + Skills + Hooks | npx plugins add TencentCloudBase/cloudbase-plugin · Respaldo CNB: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git |
| cloudbase-sites-plugin | Plugin de sitios: creación y despliegue de Vite Web | npx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git |
| cloudbase-skills | Colección de Agent Skills | npx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git |
| skills | Catálogo de instalación por skill (también en skills.sh) | npx skills add tencentcloudbase/skills --skill <name> |
| awesome-cloudbase-examples | Ejemplos y casos de estudio de CloudBase | Explorar / clonar ejemplos |
| OpenVibeCoding | Plantilla de vibecoding en CloudBase | Usar como iniciador de proyecto |
Prefiere Plugin para la pila completa; Skills solas cuando solo necesitas restricciones de conocimiento. Para IDEs de marketplace usa este repositorio—no ejecutes también npx plugins add en la misma herramienta.
Inicio rápido
Elige una ruta predeterminada para tu herramienta.
| Tu herramienta | Ruta sugerida |
|---|---|
| Claude Code / Codex (marketplace nativo) | Añade este repositorio como marketplace, luego instala el plugin cloudbase (documentación del plugin) |
| Herramientas de Open Plugin Spec | npx plugins add TencentCloudBase/cloudbase-plugin |
| Prefiere un solo CLI para muchas herramientas | CloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai |
| CodeBuddy / WorkBuddy / ZCode (integrados) | Usa el plugin o conector de CloudBase integrado del IDE |
| Otros IDEs compatibles con MCP | Solo configuración de MCP (abajo) |
Plugin
npx plugins add TencentCloudBase/cloudbase-plugin
Detalles y diferencias entre IDEs: documentación de plugins de IA.
Solo MCP
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
HTTP alojado, Cloud Mode autoalojado y alcance de plugins: Instalación y conexión.
Primeros prompts
Login to CloudBase
Use CloudBase Skills to build a todo app with login, database and permissions, then deploy
Las Skills dan forma a la estructura y las prácticas; MCP gestiona el entorno y los recursos. Deberías poder verificar datos y APIs en tu propio entorno—no solo obtener archivos fuente locales.
IDEs de IA compatibles
| Herramienta | Plataforma | Guía |
|---|---|---|
| CloudBase AI CLI | CLI | Guía |
| OpenClaw | CLI | Guía |
| WorkBuddy | IDE independiente | Guía |
| ZCode | IDE independiente (≥ 3.4.1 integrado) | Guía |
| Codex App | App | Guía |
| Cursor | IDE independiente | Guía |
| WindSurf | IDE / plugins | Guía |
| CodeBuddy | IDE independiente (integrado) | Guía |
| CLINE | Plugin de VS Code | Guía |
| GitHub Copilot | Plugin de VS Code | Guía |
| Trae | IDE independiente | Guía |
| Tongyi Lingma | IDE / plugins | Guía |
| RooCode | Plugin de VS Code | Guía |
| Baidu Comate | Plugins | Guía |
| Augment Code | Plugins | Guía |
| Claude Code | CLI | Guía |
| Gemini CLI | CLI | Guía |
| Codex CLI | CLI | Guía |
| OpenCode | CLI | Guía |
| Qwen Code | CLI | Guía |
Configuración completa: Guías de IDE.
Capacidades
Después de la configuración, la IA puede realizar trabajo típico de backend en tu entorno (confirma los pasos críticos):
- Base de datos: PostgreSQL y base de datos documental, modelos de datos, CRUD, permisos y reglas de seguridad
- Computación: crear, desplegar, invocar y depurar funciones en la nube / Cloud Run
- Autenticación y almacenamiento: métodos de inicio de sesión, almacenamiento de objetos, vinculación de permisos con datos
- Lanzamiento y operaciones: hosting estático / publicación de Mini Program; inspeccionar registros y redesplegar
Adecuado para Web, WeChat Mini Programs y servicios backend. Resumen de la plataforma: Documentación de CloudBase.
Evaluación
En condiciones controladas, se usó el mismo resumen de aplicación Todo y el mismo andamiaje de frontend para comparar dos rutas de backend: una VM tradicional en la nube (runtime, proceso y exposición de red autogestionados) y CloudBase (base de datos gestionada, autenticación anónima y servicios backend relacionados). Un agente de IA realizó el desarrollo y la verificación de extremo a extremo. Dado el modelo y la configuración de la tarea, la ruta de CloudBase fue más favorable en latencia de finalización, uso de tokens y número de llamadas a herramientas. Estos resultados dependen del modelo, el marco del agente y la definición de la tarea, y no deben generalizarse más allá de ese alcance.
Métodos, datos y límites: Evaluación de misma tarea: VM en la nube vs CloudBase
Instalación y conexión
Requisitos previos
- Node.js v18.15.0+
- Un entorno de CloudBase
- Una herramienta de IA que admita Plugin / Skills / MCP
Opciones de configuración
- Plugin (cuando la herramienta lo admita)
npx plugins add TencentCloudBase/cloudbase-plugin - CloudBase AI CLI
npm i -g @cloudbase/cli && tcb ai - MCP manual (escribe el archivo de configuración del 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 está integrado (MCP / Skills); normalmente no se necesita configuración manual.
Otros: Guía de configuración de IDE.
Modos de conexión MCP
Local (predeterminado): npx en tu máquina—funciones completas, incluida la carga de archivos locales / plantillas.
Alojado: el IDE se conecta por HTTP al MCP de Tencent Cloud; no se necesita Node local. Algunas funciones de archivos locales no están disponibles.
{
"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>"
}
}
}
}
Las URLs alojadas pueden usar enable_plugins / disable_plugins. Los nombres canónicos viven en mcp/src/server.ts.
Cloud Mode autoalojado: establece CLOUDBASE_MCP_CLOUD_MODE=true (o MCP_CLOUD_MODE=true) para que las herramientas de archivos y procesos locales estén deshabilitadas para llamadores remotos.
| Escenario | Sugerencia |
|---|---|
| Personal | Local npx |
| Equipo / cero operaciones | HTTP alojado |
| MCP autoalojado | Cloud Mode requerido |
Ejemplo
Gomoku en línea: describe la necesidad; obtén Web + base de datos en la nube / tiempo real y despliega.
Demo: Gomoku · Más: tutoriales
Documentación
FAQ
¿En qué se diferencia esto de Vercel / Netlify?
Esos se centran en publicar frontends o contenedores. CloudBase proporciona bloques de construcción de backend (base de datos, autenticación, funciones). El Toolkit permite que las herramientas de IA los usen en el chat. El despliegue es solo parte del camino.
¿Puedo usar esto sin un IDE gráfico?
Sí. Cualquier herramienta que pueda configurar un MCP Server o instalar el Plugin / Skills correspondiente funciona—incluidos Claude Code, Gemini CLI, OpenCode. Lista de soporte
¿A dónde va mi código?
El despliegue apunta a tu propio entorno de CloudBase. En modo local, MCP se ejecuta en tu máquina; el código no necesita salir hasta que despliegues. El tráfico en la nube usa HTTPS.
¿Es seguro autoalojar el servidor MCP?
Local npx equivale a ejecutar las herramientas tú mismo. Para hosts remotos, establece CLOUDBASE_MCP_CLOUD_MODE=true para deshabilitar las herramientas de archivos/procesos locales. El HTTP alojado de Tencent Cloud incluye esta protección.
¿Costo?
El Toolkit (incluido MCP) es de código abierto bajo MIT. CloudBase tiene cuotas gratuitas; el uso más allá de eso se factura—consulta facturación.
¿El inicio de sesión dice que el entorno no existe?
Confirma que existe un entorno y que está saludable en la consola, luego inicia sesión de nuevo y elige el correcto.
Comunidad
| Documentación | docs.cloudbase.net |
| Problemas | GitHub Issues |
| Lanzamientos | Changelog |