CloudBase AI ToolKit

공식

AI 프롬프트에서 라이브 앱까지 한 번의 클릭으로 전환합니다. CloudBase AI ToolKit은 AI IDE(Cursor, Copilot 등)를 Tencent CloudBase에 직접 연결하는 브리지입니다.

Cloud Base AI Tool Kit MCP(으)로 무엇을 할 수 있나요?

  • CloudBase 환경에 로그인 — AI가 인증을 수행하고 환경을 선택하도록 요청하여 이후 작업이 사용자 백엔드를 대상으로 하게 합니다.
  • 데이터베이스 레코드 조회 및 수정database 도구를 사용하여 CloudBase의 문서 또는 PostgreSQL 데이터베이스에 대해 CRUD 작업을 수행합니다.
  • 클라우드 함수 및 정적 호스팅 배포 — AI에게 클라우드 함수를 작성, 배포, 호출하거나 프론트엔드 자산을 정적 호스팅에 게시하도록 지시합니다.
  • 인증 및 스토리지 관리 — 로그인 방법을 구성하고, 객체 스토리지 권한을 설정하며, 데이터 모델에 접근 규칙을 연결합니다.
  • 로그 확인 및 서비스 재배포 — 런타임 로그를 읽어 문제를 디버깅하고 CloudRun 서비스 또는 함수의 재배포를 트리거합니다.

문서

CloudBase AI Toolkit

CloudBase AI Toolkit

AI가 코드를 작성합니다. CloudBase가 백엔드를 운영합니다.

AI 코딩 도구를 위한 CloudBase 통합 레이어: Plugin은 스택을 설치하고, Skills는 코드 작성 방식을 안내하며, MCP는 데이터베이스, 함수, 스토리지를 운영하고 채팅에서 배포합니다.

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

최근 업데이트

v2.25.x (2026-07)

  • CloudRun / Gateway: TCP 데이터베이스 사용 시 VPC 안내; upstreamResourceType 및 경로 전송을 통한 도메인/라우트
  • CloudRun / Gateway: 재배포 시 원격 VPC 및 환경 구성 유지; 배포 후 사용자 지정 도메인 접근 URL 선호
  • Plugin: Open Plugin / 마켓플레이스 패키징을 통한 간편 설치

Releases · Star · Watch → Releases

개요

AI IDE(Cursor, Claude Code, Codex, CodeBuddy 등)는 코드 생성에 강점이 있습니다. 일반적으로 막히는 부분은 백엔드입니다: 스키마, 권한, 함수, 스토리지, 환경, 그리고 릴리스.

CloudBase는 Tencent Cloud의 AI 네이티브 올인원 백엔드(데이터베이스, 스토리지, 인증, 클라우드 함수, Cloud Run 등)입니다. 이 저장소는 해당 백엔드를 AI 도구에 연결하는 Toolkit입니다:

구성 요소역할
PluginMCP Server, Agent Skills, Hooks를 함께 설치—IDE별 설정 최소화
Agent Skills시나리오 스킬(Web / Mini Program / 데이터베이스 / 인증 / 함수 등)을 실제 CloudBase 실무에 적용
MCP로그인, 데이터 조회 및 변경, 함수 및 호스팅 관리, 로그 읽기—대화에서 직접 처리

이 저장소는 npm 패키지 @cloudbase/cloudbase-mcp, Skills, AI 플러그인을 제공합니다.

자체 CloudBase 환경이 필요하며, AI가 제안하는 민감한 작업은 직접 확인해야 합니다. Toolkit은 기능과 경로를 제공할 뿐 판단을 대신하지 않습니다.

관련 저장소

게시 및 동기화 저장소는 TencentCloudBase 아래에 있습니다. 이 Toolkit과 직접 관련된 항목:

저장소내용일반 진입점
CloudBase-AI-Toolkit (이 저장소)MCP Server 소스; Claude Code / Codex용 마켓플레이스 소스npx @cloudbase/cloudbase-mcp@latest
cloudbase-pluginOpen Plugin Spec 게시 저장소(CI 동기화): MCP + Skills + Hooksnpx plugins add TencentCloudBase/cloudbase-plugin · CNB 대체: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git
cloudbase-sites-pluginSites 플러그인: Vite Web 생성 및 배포npx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git
cloudbase-skillsAgent 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-examplesCloudBase 예제 및 사례 연구예제 탐색 / 복제
OpenVibeCodingCloudBase 기반 Vibecoding 템플릿프로젝트 스타터로 사용

전체 스택은 Plugin을, 지식 제약만 필요한 경우 Skills만 사용하세요. 마켓플레이스 IDE의 경우 이 저장소를 사용하세요—같은 도구에서 npx plugins add을 동시에 실행하지 마세요.

빠른 시작

도구에 맞는 기본 경로를 선택하세요.

도구권장 경로
Claude Code / Codex (네이티브 마켓플레이스)이 저장소를 마켓플레이스로 추가한 후 cloudbase 플러그인 설치 (플러그인 문서)
Open Plugin Spec 도구npx plugins add TencentCloudBase/cloudbase-plugin
여러 도구를 하나의 CLI로 관리CloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai
CodeBuddy / WorkBuddy / ZCode (내장)IDE 내장 CloudBase 플러그인 또는 커넥터 사용
기타 MCP 지원 IDEMCP 구성만 사용(아래)

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를 검증할 수 있어야 합니다.

지원되는 AI IDE

Supported AI IDEs
도구플랫폼가이드
CloudBase AI CLICLI가이드
OpenClawCLI가이드
WorkBuddy독립 IDE가이드
ZCode독립 IDE (≥ 3.4.1 내장)가이드
Codex App가이드
Cursor독립 IDE가이드
WindSurfIDE / 플러그인가이드
CodeBuddy독립 IDE (내장)가이드
CLINEVS Code 플러그인가이드
GitHub CopilotVS Code 플러그인가이드
Trae독립 IDE가이드
Tongyi LingmaIDE / 플러그인가이드
RooCodeVS Code 플러그인가이드
Baidu Comate플러그인가이드
Augment Code플러그인가이드
Claude CodeCLI가이드
Gemini CLICLI가이드
Codex CLICLI가이드
OpenCodeCLI가이드
Qwen CodeCLI가이드

전체 설정: IDE 가이드.

기능

설정 후 AI는 환경에서 일반적인 백엔드 작업을 수행할 수 있습니다(중요한 단계는 확인 필요):

  • 데이터베이스: PostgreSQL 및 문서 DB, 데이터 모델, CRUD, 권한 및 보안 규칙
  • 컴퓨팅: 클라우드 함수 / Cloud Run 작성, 배포, 호출, 디버깅
  • 인증 및 스토리지: 로그인 방법, 객체 스토리지, 데이터와의 권한 연동
  • 릴리스 및 운영: 정적 호스팅 / Mini Program 게시; 로그 확인 및 재배포

Web, WeChat Mini Programs, 백엔드 서비스에 적합합니다. 플랫폼 개요: CloudBase 문서.

평가

통제된 조건에서 동일한 Todo 애플리케이션 요구사항과 프론트엔드 스캐폴드를 사용하여 두 백엔드 경로를 비교했습니다: 기존 클라우드 VM(자체 관리 런타임, 프로세스, 네트워크 노출)과 CloudBase(관리형 데이터베이스, 익명 인증, 관련 백엔드 서비스). AI 에이전트가 엔드투엔드 개발 및 검증을 수행했습니다. 모델과 작업 설정을 고려할 때 CloudBase 경로가 완료 지연 시간, 토큰 사용량, 도구 호출 횟수에서 더 유리했습니다. 이러한 결과는 모델, 에이전트 프레임워크, 작업 정의에 따라 달라지며 해당 범위를 넘어 일반화해서는 안 됩니다.

방법, 데이터, 한계: 동일 작업 평가: 클라우드 VM vs CloudBase

설치 및 연결

사전 요구 사항

  • Node.js v18.15.0+
  • CloudBase 환경
  • Plugin / Skills / MCP를 지원하는 AI 도구

설정 옵션

  1. Plugin (도구가 지원하는 경우)
    npx plugins add TencentCloudBase/cloudbase-plugin
  2. CloudBase AI CLI
    npm i -g @cloudbase/cli && tcb ai
  3. 수동 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를 통해 Tencent Cloud MCP에 연결; 로컬 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
자체 호스팅 MCPCloud Mode 필수

예제

온라인 오목: 요구사항을 설명하면 Web + 클라우드 데이터베이스 / 실시간 및 배포를 얻을 수 있습니다.
데모: 오목 · 더 보기: 튜토리얼

문서

FAQ

Vercel / Netlify와 어떻게 다른가요?

Vercel / Netlify는 프론트엔드 또는 컨테이너 배포에 중점을 둡니다. CloudBase는 백엔드 구성 요소(데이터베이스, 인증, 함수)를 제공합니다. Toolkit은 AI 도구가 채팅에서 이를 사용할 수 있게 합니다. 배포는 경로의 일부일 뿐입니다.

GUI IDE 없이 사용할 수 있나요?

네. MCP Server를 구성하거나 해당 Plugin / Skills를 설치할 수 있는 모든 도구에서 작동합니다—Claude Code, Gemini CLI, OpenCode 포함. 지원 목록

내 코드는 어디로 이동하나요?

배포 대상은 사용자 자신의 CloudBase 환경입니다. 로컬 모드에서는 MCP가 사용자 머신에서 실행되며, 배포 전까지 코드가 외부로 나가지 않습니다. 클라우드 트래픽은 HTTPS를 사용합니다.

MCP 서버 자체 호스팅은 안전한가요?

로컬 npx은 도구를 직접 실행하는 것과 동일합니다. 원격 호스트의 경우 CLOUDBASE_MCP_CLOUD_MODE=true을 설정하여 로컬 파일/프로세스 도구를 비활성화하세요. Tencent Cloud 호스팅 HTTP에는 이 보호 기능이 포함되어 있습니다.

비용은?

Toolkit(MCP 포함)은 MIT 라이선스의 오픈 소스입니다. CloudBase에는 무료 할당량이 있으며, 초과 사용 시 요금이 부과됩니다—요금 안내 참조.

로그인 시 환경이 존재하지 않는다고 표시되나요?

콘솔에서 환경이 존재하고 정상인지 확인한 후 다시 로그인하여 올바른 환경을 선택하세요.

커뮤니티

문서docs.cloudbase.net
이슈GitHub Issues
릴리스Changelog

활동

Repo Activity

기여자

Contributors


MIT · TencentCloudBase