CloudBase AI ToolKit

CloudBase AI Toolkit

A IA escreve o código. O CloudBase executa o backend.

A camada de integração do CloudBase para ferramentas de programação com IA: o Plugin instala a stack, as Skills orientam a escrita do código, e o MCP opera bancos de dados, funções, armazenamento e implantações pelo chat.

English · 简体中文 · Docs · Changelog · Issues

Atualizações recentes

v2.36.x (2026-10)

• MCP Apps: chegam três painéis — introdução, uso do ambiente e resultado da implantação — lançados como experimentais e desativados por padrão; defina CLOUDBASE_MCP_UI=on para experimentá-los
• Segurança: exclusões, SQL destrutivo e as ações de exclusão correspondentes de callCloudApi pausam para solicitar uma confirmação que identifica o alvo; um argumento com formato de credencial passa por uma verificação delta (comprimento e impressão digital sha256, nunca o valor em si)
• Ambiente: o painel de uso ganha uma visualização de métricas (QPS, invocações, erros, timeouts, carga do MySQL e do CloudRun) com nomes legíveis, e o provisionamento do MySQL é removido da superfície de ferramentas
• Integração: toda resposta de initialize inclui instructions com a primeira chamada somente de leitura a ser feita; agora, a documentação de configuração remota começa pelo OAuth

v2.35.x (2026-10)

• Hospedagem / Autenticação: cada solicitação ao MCP hospedado é executada em seu próprio transporte, com metadados do cliente armazenados em cache por credencial, e uma credencial no nível do projeto agora tem precedência sobre o estado de login da conta
• Ferramentas / Skills: o provisionamento do MySQL é removido da superfície de ferramentas; cada pacote de skills inclui um LICENSE.md ao lado de SKILL.md; uma nova skill de referência do MCP documenta os endpoints remotos, as flags do plugin e os esquemas das ferramentas
• Feedback: prepareFeedback retorna a página de criação de issue do repositório em vez de um relatório de erro preenchido automaticamente, e um servidor hospedado agora ativa o mesmo conjunto padrão de plugins que um servidor local
• Integração / Documentação: toda resposta de initialize agora inclui o servidor instructions — a chamada a fazer primeiro, a ordem necessária para a primeira execução e prompts que podem ser copiados literalmente; agora, a documentação de configuração remota começa pelo OAuth, de modo que somente a URL é necessária para a configuração e o par de chaves é o caminho para CI

v2.34.x (2026-09)

• i18n / IDE: localização completa do texto das ferramentas com um lang no nível da instância, além dos parâmetros auth site / region para que o login no site internacional e o roteamento de região sejam resolvidos corretamente
• Cloud API: a lista de serviços permitidos de callCloudApi foi ampliada para 57, com mapeamento de versões integrado (serviços com várias versões, como tke / mongodb / vod, exigem um version explícito)
• Implantação / Ambiente: nova ferramenta appBuild com neutralização do build de hosting; queryEnv informa a região realmente aplicada e domains respeita um envId fornecido
• Skills / Documentação: leituras de fallback das skills agora apontam para o repositório oficial de distribuição, com uma lista de endereços de referência; etapa de decisão para priorizar o SDK no banco de dados do cloudrun; links da documentação do site migrados para os endereços Markdown atuais; compartilhamento após a implantação oferecido após a entrega nos pacotes especializados e nas skills de implantação (opcional, com dados redigidos, no máximo uma vez)
• Implantação / Apps: o canal de upload na nuvem agora funciona de ponta a ponta (deployApp aceita o timestamp retornado por getUploadUrl, e getBuildLog aceita o ID de build retornado por uma implantação), e a criação de rotas do gateway verifica se o upstream existe antes de gravar
• Skills / Contexto: nova skill de boas práticas de padrões de acesso ao PostgreSQL (lotes, índices, controle de acesso por função RLS, capacidade de lançamento); os catálogos de skills inline / OpenAPI de searchKnowledgeBase agora são carregados sob demanda, reduzindo em 9,1% a superfície de 43 ferramentas em cada tools/list
• Runtime / Hosting: o modo CloudRun Function não deve vincular PORT (isso é feito pelo framework de funções) e inclui uma etapa de decisão de credenciais que identifica CLOUDBASE_APIKEY; caminhos e prefixos de hosting são normalizados para que uma barra inicial não possa mais ser interpretada como um diretório vazio
• Conectores: o conector WorkBuddy do site internacional (cloudbase-intl) é criado a partir do mesmo corpus config/source/** que o doméstico — streamableHttp remoto com OAuth MCP padrão em vez de stdio local, com hosts do site da China substituídos por seus equivalentes internacionais

Releases · Star · Acompanhe → Releases

O que é

IDEs com IA (Cursor, Claude Code, Codex, CodeBuddy e outros) são ótimas para gerar código. O que costuma ser um obstáculo é o backend: esquemas, permissões, funções, armazenamento, ambientes e publicação.

CloudBase é o backend completo e nativo de IA da Tencent Cloud (banco de dados, armazenamento, autenticação, funções na nuvem, Cloud Run e muito mais). Este repositório é o Toolkit que conecta esse backend às ferramentas de IA:

Este repositório distribui o pacote npm @cloudbase/cloudbase-mcp, Skills e plugins de IA.

Você ainda precisa do seu próprio ambiente CloudBase e deve confirmar as ações sensíveis propostas pela IA. O Toolkit oferece recursos e caminhos — não julgamento.

Repositórios relacionados

Os repositórios de publicação e sincronização ficam em TencentCloudBase. Diretamente relacionados a este Toolkit:

Prefira o Plugin para obter a stack completa; use apenas Skills quando precisar somente de orientações. Para IDEs com marketplace, use este repositório — não execute também npx plugins add na mesma ferramenta.

Início rápido

A maneira mais rápida de começar

Copie este prompt de IA para sua IDE com IA. O agente lê skill.md e conclui a configuração:

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"]
    }
  }
}

Primeiros prompts

Login to CloudBase

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

As Skills orientam a estrutura e as práticas; o MCP gerencia o ambiente e os recursos. Você deve conseguir verificar dados e APIs no seu próprio ambiente — não apenas obter arquivos-fonte locais.

IDEs com IA compatíveis

Configuração completa: Guias para IDEs.

Recursos

Após a configuração, a IA pode realizar tarefas comuns de backend no seu ambiente (confirme as etapas críticas):

• Banco de dados: PostgreSQL e banco de dados de documentos, modelos de dados, CRUD, permissões e regras de segurança
• Computação: criar, implantar, invocar e depurar funções na nuvem / Cloud Run
• Autenticação e armazenamento: métodos de login, armazenamento de objetos, integração de permissões com dados
• Publicação e operações: hosting estático / publicação de Mini Program; inspecionar logs e reimplantar

Adequado para Web, WeChat Mini Programs e serviços de backend. Visão geral da plataforma: documentação do CloudBase.

Avaliação

Em condições controladas, o mesmo briefing de um aplicativo Todo e o mesmo scaffold de frontend foram usados para comparar dois caminhos de backend: uma VM tradicional na nuvem (runtime, processo e exposição de rede autogerenciados) e o CloudBase (banco de dados gerenciado, autenticação anônima e serviços de backend relacionados). Um agente de IA realizou o desenvolvimento e a verificação de ponta a ponta. Considerando a configuração do modelo e da tarefa, o caminho do CloudBase apresentou resultados mais favoráveis em latência de conclusão, uso de tokens e número de chamadas de ferramentas. Esses resultados dependem do modelo, do framework do agente e da definição da tarefa, e não devem ser generalizados para além desse escopo.

Métodos, dados e limitações: Avaliação da mesma tarefa: VM na nuvem vs. CloudBase

Instalar e conectar

Pré-requisitos

• Node.js v18.15.0+
• Um ambiente CloudBase
• Uma ferramenta de IA compatível com Plugin / Skills / MCP

Opções de configuração

1. Plugin (quando a ferramenta oferece suporte)
   npx plugins add TencentCloudBase/cloudbase-plugin
2. MCP manual (escreva o arquivo de configuração da IDE)

Já usa o CloudBase CLI? tcb ai também configura o MCP e as Skills (docs).

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

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

Outros: guia de configuração da IDE.

Modos de conexão do MCP

Remoto (recomendado): sua IDE se conecta ao MCP da Tencent Cloud por HTTP. Não é necessário ter o Node localmente, e clientes interativos concluem a autorização no navegador.

Escolha o endpoint correspondente ao site em que seu ambiente está. Os dois sites usam contas, consoles e credenciais separados.

OAuth (interativo, recomendado): a URL é toda a configuração. Sua IDE abre o navegador para login e consentimento, e você escolhe o ambiente por lá — sem chaves no arquivo de configuração e sem precisar rotacioná-las.

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

Credenciais estáticas (para clientes sem OAuth e para CI/CD): acrescente env_id e um par de chaves criado no mesmo site do 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>"
      }
    }
  }
}

Um par de chaves estáticas permanece válido até ser rotacionado ou excluído; uma sessão OAuth termina quando você sai da conta. Use o formato estático somente quando o fluxo pelo navegador não for possível — e não o inclua em um repositório.

Local: executa npx @cloudbase/cloudbase-mcp@latest na sua máquina — com todos os recursos, incluindo upload do sistema de arquivos local e download de modelos.

Limitação do modo remoto: os recursos do sistema de arquivos local (upload, download de modelos) não estão disponíveis, e o site internacional ainda não oferece ferramentas NoSQL.

As URLs remotas também aceitam site (domestic / intl, necessário apenas para um ambiente no site da China em ap-singapore, onde a região é ambígua), além de enable_plugins / disable_plugins para limitar as ferramentas. Os nomes canônicos estão em mcp/src/server.ts.

E2E do MCP remoto (cliente oficial do SDK): npm run test:hosted-mcp:e2e — consulte tests/hosted-mcp-e2e/README.md para os modos apikey/OAuth, staging com TLS inseguro e variáveis de ambiente. A ausência de credenciais faz com que o teste seja ignorado (exit 0).

Modo Cloud auto-hospedado: defina CLOUDBASE_MCP_CLOUD_MODE=true (ou MCP_CLOUD_MODE=true) para desativar as ferramentas de arquivos locais e processos para clientes remotos.

Exemplo

Gomoku online: descreva a necessidade; obtenha Web + banco de dados na nuvem / tempo real e faça o deploy.
Demonstração: Gomoku · Mais: tutoriais

Documentação

• Ferramentas do MCP (tools.json)
• Primeiros passos
• Configuração da IDE
• Plugins de IA
• Modelos
• Perguntas frequentes

Perguntas frequentes

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

Comunidade

Atividade

Contribuidores

MIT · TencentCloudBase