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
AI가 코드를 작성합니다. CloudBase가 백엔드를 운영합니다.
AI 코딩 도구를 위한 CloudBase 통합 레이어: Plugin은 스택을 설치하고, Skills는 코드 작성 방식을 안내하며, MCP는 데이터베이스, 함수, 스토리지를 운영하고 채팅에서 배포합니다.
최근 업데이트
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입니다:
| 구성 요소 | 역할 |
|---|---|
| Plugin | MCP 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-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 | CloudBase 기반 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 지원 IDE | 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를 검증할 수 있어야 합니다.
지원되는 AI 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 가이드.
기능
설정 후 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 도구
설정 옵션
- 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를 통해 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 |
| 자체 호스팅 MCP | Cloud 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 |