CloudBase AI ToolKit
offiziellVon der KI-Eingabeaufforderung zur Live-App mit einem Klick. CloudBase AI ToolKit ist die Brücke, die Ihre KI-IDE (Cursor, Copilot usw.) direkt mit Tencent CloudBase verbindet.
Was kann man mit CloudBase AI ToolKit MCP machen?
- Bei CloudBase anmelden — Authentifizieren Sie das KI-Tool gegenüber Ihrer CloudBase-Umgebung, damit es auf Ihre Backend-Ressourcen zugreifen kann.
- Daten abfragen und ändern — Arbeiten Sie mit PostgreSQL- und Document-DB-Daten, einschließlich Modellen, CRUD-Operationen, Berechtigungen und Sicherheitsregeln.
- Compute bereitstellen und debuggen — Erstellen, bereitstellen, aufrufen und debuggen Sie Cloud Functions und Cloud Run-Dienste direkt aus der Konversation.
- Auth und Storage verwalten — Konfigurieren Sie Anmeldemethoden und Objektspeicher, einschließlich der Verknüpfung von Berechtigungen mit Daten.
- Logs veröffentlichen und einsehen — Veröffentlichen Sie statisches Hosting oder Mini Programs und lesen Sie anschließend Logs und stellen Sie über
getBuildLogunddeployApperneut bereit. - Cloud-APIs aufrufen — Rufen Sie freigegebene CloudBase-Service-APIs über
callCloudApiauf, mit expliziterversionfür Dienste mit mehreren Versionen.
Dokumentation
CloudBase AI Toolkit
Die KI schreibt den Code. CloudBase betreibt das Backend.
Die CloudBase-Integrationsschicht für KI-Coding-Tools: Das Plugin installiert den Stack, Skills steuern, wie Code geschrieben wird, MCP bedient Datenbanken, Funktionen, Storage und Deployments direkt aus dem Chat.
Aktuelle Updates
v2.36.x (2026-10)
- MCP Apps: Drei Panels kommen hinzu – Erste Schritte, Umgebungsnutzung und Deployment-Ergebnis – experimentell ausgeliefert und standardmäßig deaktiviert; setze
CLOUDBASE_MCP_UI=on, um sie auszuprobieren - Sicherheit: Löschvorgänge, destruktives SQL und die entsprechenden
callCloudApi-Löschaktionen pausieren für eine Bestätigung, die das Ziel benennt; ein Argument in Form eines Credentials erhält eine Delta-Prüfung (Länge plus sha256-Fingerabdruck, niemals der Wert selbst) - Umgebung: Das Nutzungs-Panel erhält eine Metrik-Ansicht (QPS, Aufrufe, Fehler, Timeouts, MySQL- und CloudRun-Last) mit lesbaren Namen, und die MySQL-Bereitstellung wird aus der Tool-Oberfläche entfernt
- Onboarding: Jede
initialize-Antwort enthältinstructionsmit dem ersten schreibgeschützten Aufruf, der ausgeführt werden sollte; die Remote-Setup-Dokumentation beginnt nun mit OAuth
v2.35.x (2026-10)
- Hosted / Auth: Jede gehostete MCP-Anfrage läuft auf ihrem eigenen Transport mit clientseitigen Metadaten, die pro Credential zwischengespeichert werden, und ein projektbezogenes Credential hat nun Vorrang vor dem Anmeldestatus des Kontos
- Tools / Skills: Die MySQL-Bereitstellung wird aus der Tool-Oberfläche entfernt; jedes Skill-Paket enthält eine
LICENSE.mdnebenSKILL.md; ein neues MCP-Referenz-Skill dokumentiert die Remote-Endpunkte, die Plugin-Flags und die Tool-Schemas - Feedback:
prepareFeedbackgibt die Seite für neue Issues des Repositories zurück statt eines automatisch ausgefüllten Fehlerberichts, und ein gehosteter Server aktiviert nun denselben Standard-Plugin-Satz wie ein lokaler - Onboarding / Docs: Jede
initialize-Antwort enthält nun Server-instructions– den zuerst auszuführenden Aufruf, die Reihenfolge, die ein erster Lauf benötigt, und Prompts, die wörtlich kopiert werden können; die Remote-Setup-Dokumentation beginnt nun mit OAuth, sodass allein die URL die Konfiguration ist und ein Schlüsselpaar der CI-Pfad ist
v2.34.x (2026-09)
- i18n / IDE: Vollständige Lokalisierung der Tool-Texte mit einem instanzbezogenen
lang, plusauthsite/region-Parameter, damit die Anmeldung auf der internationalen Site und das Region-Routing korrekt aufgelöst werden - Cloud API: Die
callCloudApi-Service-Allowlist wurde auf 57 erweitert, mit integrierter Versionszuordnung (Mehrversions-Dienste wietke/mongodb/voderfordern eine expliziteversion) - Deploy / Env: Neues
appBuild-Tool mit Hosting-Build-Neutralisierung;queryEnvmeldet die tatsächlich angewendete Region unddomainsrespektiert eine übergebene envId - Skills / Docs: Skill-Fallback-Lesevorgänge verweisen nun auf das offizielle Distributions-Repository mit einer Referenz-Adressliste; SDK-first-Datenbank-Entscheidungsgate für cloudrun; Site-Dokumentationslinks wurden auf die aktuellen Markdown-Adressen umgestellt; Post-Deployment-Sharing wird nach der Auslieferung in den Expert-Packs und den Deploy-Skills angeboten (Opt-in, redigiert, höchstens einmal)
- Deploy / Apps: Der Cloud-Upload-Kanal läuft nun vollständig durch (
deployAppakzeptiert den Zeitstempel, dengetUploadUrlzurückgibt,getBuildLogakzeptiert die Build-ID, die ein Deployment zurückgibt), und die Erstellung von Gateway-Routen prüft, ob das Upstream existiert, bevor geschrieben wird - Skills / Context: Neues Skill mit Best Practices für PostgreSQL-Zugriffsmuster (Batching, Indizes, RLS-Rollen-Gating, Startkapazität); die Inline-Skill- / OpenAPI-Kataloge von
searchKnowledgeBasewerden nun bei Bedarf geladen, was die 43-Tool-Oberfläche bei jedemtools/listum 9,1 % reduziert - Runtime / Hosting: Der CloudRun-Function-Modus darf
PORTnicht binden (das erledigt das Function-Framework) und erhält ein Credential-Entscheidungsgate, dasCLOUDBASE_APIKEYbenennt; Hosting-Pfade und -Präfixe werden normalisiert, sodass ein führender Schrägstrich nicht mehr als leeres Verzeichnis gelesen werden kann - Connectors: Der WorkBuddy-Connector für die internationale Site (
cloudbase-intl) wird aus demselbenconfig/source/**-Korpus wie der inländische erstellt – Remote-streamableHttpmit Standard-MCP-OAuth statt lokalem stdio, wobei Hosts der China-Site auf ihre internationalen Entsprechungen umgeschrieben werden
Releases · Star · Watch → Releases
Was es ist
KI-IDEs (Cursor, Claude Code, Codex, CodeBuddy und andere) sind stark darin, Code zu generieren. Was dich üblicherweise blockiert, ist das Backend: Schemas, Berechtigungen, Funktionen, Storage, Umgebungen und Release.
CloudBase ist Tencent Clouds KI-native All-in-One-Backend (Datenbank, Storage, Auth, Cloud Functions, Cloud Run und mehr). Dieses Repository ist das Toolkit, das dieses Backend mit KI-Tools verbindet:
| Baustein | Rolle |
|---|---|
| Plugin | Installiert MCP Server, Agent Skills und Hooks gemeinsam – weniger Verdrahtung pro IDE |
| Agent Skills | Szenario-Skills (Web / Mini Program / Datenbank / Auth / Funktionen usw.) hin zu funktionierender CloudBase-Praxis |
| MCP | Anmelden, Daten abfragen und ändern, Funktionen und Hosting verwalten, Logs lesen – direkt aus der Konversation |
Dieses Repository liefert das npm-Paket @cloudbase/cloudbase-mcp, Skills und KI-Plugins.
Du benötigst weiterhin deine eigene CloudBase-Umgebung, und du solltest sensible Aktionen bestätigen, die die KI vorschlägt. Das Toolkit bietet Fähigkeit und Weg – kein Urteilsvermögen.
Verwandte Repositories
Publishing- und Sync-Repositories liegen unter TencentCloudBase. Direkt mit diesem Toolkit verwandt:
| Repository | Inhalte | Typischer Einstieg |
|---|---|---|
| CloudBase-AI-Toolkit (dieses Repo) | MCP-Server-Quellcode; Marketplace-Quelle für Claude Code / Codex | npx @cloudbase/cloudbase-mcp@latest |
| dsh-plugin | DeepSeek Harness Plugin (@cloudbase/dsh-plugin): MCP-Bridge + DB/Storage/Auth-Panel | dsh plugin add @cloudbase/dsh-plugin |
| cloudbase-plugin | Open Plugin Spec Publish-Repo (CI-synchronisiert): MCP + Skills + Hooks | npx plugins add TencentCloudBase/cloudbase-plugin · CNB-Fallback: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git |
| cloudbase-sites-plugin | Sites-Plugin: Vite Web erstellen & deployen | npx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git |
| cloudbase-skills | Agent-Skills-Sammlung | npx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git |
| skills | Installationskatalog pro Skill (auch auf skills.sh) | npx skills add tencentcloudbase/skills --skill <name> |
| awesome-cloudbase-examples | CloudBase-Beispiele und Fallstudien | Beispiele durchsuchen / klonen |
| OpenVibeCoding | Vibecoding-Vorlage auf CloudBase | Als Projektstarter verwenden |
Bevorzuge das Plugin für den vollständigen Stack; Skills allein, wenn du nur Wissensbeschränkungen benötigst. Für Marketplace-IDEs verwende dieses Repository – führe nicht zusätzlich npx plugins add im selben Tool aus.
Schnellstart
Schnellster Einstieg
Kopiere diesen KI-Prompt in deine KI-IDE. Der Agent liest skill.md und schließt die Einrichtung ab:
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.
Wähle einen Standardpfad für dein Tool (Plugin / CLI / MCP)
| Dein Tool | Empfohlener Pfad |
|---|---|
| Claude Code / Codex (nativer Marketplace) | Füge dieses Repo als Marketplace hinzu und installiere dann das cloudbase-Plugin (Plugin-Dokumentation) |
| Open-Plugin-Spec-Tools | npx plugins add TencentCloudBase/cloudbase-plugin |
| Eine CLI für viele Tools bevorzugt | CloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai |
| CodeBuddy / WorkBuddy / Doubao / MiniMax Code / DeepSeek Harness / ZCode / Kimi (integriert) | Verwende das integrierte CloudBase-Plugin oder den Connector der IDE; für CodeBuddy kannst du auch über den Plugin-Marketplace installieren |
| Andere MCP-fähige IDEs | Nur MCP-Konfiguration (unten) |
Plugin
npx plugins add TencentCloudBase/cloudbase-plugin
Details und IDE-Unterschiede: KI-Plugin-Dokumentation.
Nur MCP
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
Remote-HTTP, selbst gehosteter Cloud-Modus und Plugin-Scoping: Installation & Verbindung.
Erste Prompts
Login to CloudBase
Use CloudBase Skills to build a todo app with login, database and permissions, then deploy
Skills prägen Struktur und Praxis; MCP kümmert sich um Umgebung und Ressourcen. Du solltest in der Lage sein, Daten und APIs in deiner eigenen Umgebung zu überprüfen – nicht nur lokale Quelldateien zu erhalten.
Unterstützte KI-IDEs
| Tool | Plattform | Anleitung |
|---|---|---|
| CloudBase AI CLI | CLI | Anleitung |
| OpenClaw | CLI | Anleitung |
| WorkBuddy | Eigenständige IDE | Anleitung |
| Doubao | Desktop & Web (Plugin-Marketplace) | Anleitung |
| MiniMax Code | Desktop-App & Terminal-CLI (Plugin-Marketplace) | Anleitung |
| DeepSeek Harness | Desktop-App (Plugin) | Anleitung |
| ZCode | Eigenständige IDE (≥ 3.4.1 integriert) | Anleitung |
| Kimi Code | CLI (Plugin-Marketplace) | Anleitung |
| Kimi Work | Desktop-App (Plugin-Panel) | Anleitung |
| Codex App | App | Anleitung |
| Cursor | Eigenständige IDE | Anleitung |
| WindSurf | IDE / Plugins | Anleitung |
| CodeBuddy | Eigenständige IDE (integriert) | Anleitung |
| CLINE | VS Code Plugin | Anleitung |
| GitHub Copilot | VS Code Plugin | Anleitung |
| Trae | Eigenständige IDE | Anleitung |
| Tongyi Lingma | IDE / Plugins | Anleitung |
| RooCode | VS Code Plugin | Anleitung |
| Baidu Comate | Plugins | Anleitung |
| Augment Code | Plugins | Anleitung |
| Claude Code | CLI | Anleitung |
| Gemini CLI | CLI | Anleitung |
| Codex CLI | CLI | Anleitung |
| OpenCode | CLI | Anleitung |
| Qwen Code | CLI | Anleitung |
Vollständige Einrichtung: IDE-Anleitungen.
Fähigkeiten
Nach der Einrichtung kann die KI typische Backend-Arbeiten in deiner Umgebung erledigen (kritische Schritte bestätigen):
- Datenbank: PostgreSQL und Dokumenten-DB, Datenmodelle, CRUD, Berechtigungen und Sicherheitsregeln
- Compute: Cloud Functions / Cloud Run erstellen, deployen, aufrufen und debuggen
- Auth & Storage: Anmeldemethoden, Objektspeicher, Berechtigungsverknüpfung mit Daten
- Release & Betrieb: Static Hosting / Mini-Programm-Veröffentlichung; Logs einsehen und erneut deployen
Geeignet für Web, WeChat Mini Programs und Backend-Dienste. Plattformübersicht: CloudBase-Dokumentation.
Evaluierung
Unter kontrollierten Bedingungen wurden mit demselben Todo-Anwendungs-Briefing und Frontend-Gerüst zwei Backend-Pfade verglichen: eine traditionelle Cloud-VM (selbst verwaltete Runtime, Prozess und Netzwerkexposition) und CloudBase (verwaltete Datenbank, anonyme Auth und zugehörige Backend-Dienste). Ein KI-Agent führte die End-to-End-Entwicklung und -Verifikation durch. Angesichts des Modells und der Aufgabenstellung war der CloudBase-Pfad bei Abschlusslatenz, Token-Verbrauch und Anzahl der Tool-Aufrufe günstiger. Diese Ergebnisse sind an Modell, Agent-Framework und Aufgabendefinition gebunden und sollten nicht über diesen Rahmen hinaus verallgemeinert werden.
Methoden, Daten und Grenzen: Gleiche Aufgabe: Cloud-VM vs. CloudBase
Installation & Verbindung
Voraussetzungen
- Node.js v18.15.0+
- Eine CloudBase-Umgebung
- Ein KI-Tool, das Plugin / Skills / MCP unterstützt
Einrichtungsoptionen
- Plugin (wenn das Tool es unterstützt)
npx plugins add TencentCloudBase/cloudbase-plugin - CloudBase AI CLI
npm i -g @cloudbase/cli && tcb ai - Manuelles MCP (IDE-Konfigurationsdatei schreiben)
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 ist integriert (MCP / Skills); eine manuelle Konfiguration ist in der Regel nicht nötig.
Du kannst auch über den Plugin-Marketplace installieren: siehe CodeBuddy-Einrichtungsanleitung.
Weitere: IDE-Einrichtungsanleitung.
MCP-Verbindungsmodi
Remote (empfohlen): Deine IDE verbindet sich per HTTP mit Tencent Cloud MCP. Kein lokales Node nötig, und interaktive Clients schließen die Autorisierung im Browser ab.
| Standort | MCP-Endpunkt |
|---|---|
| China (Inland) | https://tcb-api.cloud.tencent.com/mcp/v1 |
| International | https://tcb-api.tencentcloud.com/mcp/v1 |
Wähle den Endpunkt, der zum Standort deiner Umgebung passt – die beiden Standorte verwenden getrennte Konten, Konsolen und Anmeldedaten.
OAuth (interaktiv, empfohlen): Die URL ist die gesamte Konfiguration. Deine IDE öffnet den Browser für Anmeldung und Zustimmung, und du wählst dort die Umgebung aus – keine Schlüssel in der Konfigurationsdatei und nichts, was rotiert werden muss.
{
"mcpServers": {
"cloudbase": {
"type": "http",
"url": "https://tcb-api.cloud.tencent.com/mcp/v1"
}
}
}
Statische Anmeldedaten (für einen Client ohne OAuth und für CI/CD): Hänge env_id und ein Schlüsselpaar an, das am selben Standort wie der Endpunkt erstellt wurde.
{
"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>"
}
}
}
}
Ein statisches Schlüsselpaar bleibt gültig, bis es rotiert oder gelöscht wird; eine OAuth-Sitzung endet, wenn du dich abmeldest. Verwende die statische Form nur dort, wo der Browser-Ablauf nicht möglich ist – und halte sie aus einem Repository heraus.
Lokal: führt npx @cloudbase/cloudbase-mcp@latest auf deinem Rechner aus – volle Funktionalität, einschließlich Upload aus dem lokalen Dateisystem und Template-Download.
Kompromiss bei Remote: Funktionen für das lokale Dateisystem (Upload, Template-Download) sind nicht verfügbar, und der internationale Standort stellt noch keine NoSQL-Tools bereit.
Remote-URLs akzeptieren außerdem site (domestic / intl, nur nötig für eine Umgebung am China-Standort in ap-singapore, wo die Region mehrdeutig ist), sowie enable_plugins / disable_plugins zum Reduzieren der Tools. Die kanonischen Namen stehen in mcp/src/server.ts.
Remote MCP E2E (offizieller SDK-Client): npm run test:hosted-mcp:e2e – siehe tests/hosted-mcp-e2e/README.md für apikey-/OAuth-Modi, TLS-unsicheres Staging und Umgebungsvariablen. Fehlende Anmeldedaten werden übersprungen (Exit 0).
Selbst gehosteter Cloud-Modus: Setze CLOUDBASE_MCP_CLOUD_MODE=true (oder MCP_CLOUD_MODE=true), damit lokale Datei- und Prozess-Tools für Remote-Aufrufer deaktiviert werden.
| Szenario | Empfehlung |
|---|---|
| Persönlich / schnellster Start | Remote-URL (OAuth) |
| Lokale Dateifunktionen benötigt | Lokales npx |
| CI / Automatisierung | Remote + statische Anmeldedaten |
| Selbst gehostetes MCP | Cloud-Modus erforderlich |
Beispiel
Online-Gomoku: Beschreibe den Bedarf; erhalte Web + Cloud-Datenbank / Realtime und deploye.
Demo: Gomoku · Mehr: Tutorials
Dokumentation
FAQ
Wie unterscheidet sich das von Vercel / Netlify?
Diese konzentrieren sich auf das Ausliefern von Frontends oder Containern. CloudBase bietet Backend-Bausteine (Datenbank, Auth, Functions). Das Toolkit ermöglicht KI-Tools, sie im Chat zu nutzen. Das Deployment ist nur ein Teil des Weges.
Kann ich das ohne GUI-IDE verwenden?
Ja. Jedes Tool, das einen MCP-Server konfigurieren oder das passende Plugin / die passenden Skills installieren kann, funktioniert – einschließlich Claude Code, Gemini CLI, OpenCode. Unterstützungsliste
Wohin gelangt mein Code?
Das Deployment zielt auf deine eigene CloudBase-Umgebung. Im lokalen Modus läuft MCP auf deinem Rechner; der Code muss ihn erst verlassen, wenn du deployst. Cloud-Datenverkehr verwendet HTTPS.
Ist das Selbst-Hosten des MCP-Servers sicher?
Lokales npx ist gleichbedeutend damit, die Tools selbst auszuführen. Für Remote-Hosts setze CLOUDBASE_MCP_CLOUD_MODE=true, um lokale Datei-/Prozess-Tools zu deaktivieren. Tencent Cloud Remote-HTTP enthält diesen Schutz.
Kosten?
Das Toolkit (einschließlich MCP) ist Open Source unter MIT. CloudBase hat kostenlose Kontingente; die Nutzung darüber hinaus wird abgerechnet – siehe Abrechnung.
Die Anmeldung meldet, dass die Umgebung nicht existiert?
Bestätige in der Konsole, dass eine Umgebung existiert und fehlerfrei ist, melde dich dann erneut an und wähle die richtige aus.
Umgebung am Inlandsstandort in `ap-singapore` wird als international behandelt?
Sowohl der Inlandsstandort (cloud.tencent.com) als auch der internationale Standort (tencentcloud.com) bieten die Region ap-singapore an, daher ist die Region allein mehrdeutig. Ohne expliziten Standort verwendet MCP standardmäßig intl für ap-singapore (abwärtskompatibel). Nutzer des Inlandsstandorts in Singapur müssen TCB_SITE=domestic (zusammen mit TCB_REGION=ap-singapore) in der MCP-env setzen oder eine .cloudbase/project.json im Projektstamm hinzufügen:
{ "site": "domestic", "region": "ap-singapore", "envId": "your-env-id" }
Anmeldedaten werden pro Standort gespeichert (credential.domestic / credential.intl), sodass inländische und internationale Anmeldungen koexistieren können; das veraltete Einzel-Slot-auth.json wird als domestic gelesen und beim ersten Schreiben migriert.
Remote-Modus: nichts Zusätzliches zu übergeben – der Endpunkt-Host entscheidet über den Standort (tcb-api.cloud.tencent.com = China-Standort, tcb-api.tencentcloud.com = internationaler Standort), und es gibt keinen site-Query-Parameter. Dies deckt auch eine Umgebung am China-Standort in ap-singapore ab: Verwende weiterhin den Endpunkt des China-Standorts.
Community
| Docs | docs.cloudbase.net |
| Issues | GitHub Issues |
| Releases | Changelog |