CloudBase AI ToolKit

offiziell

Von 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 getBuildLog und deployApp erneut bereit.
  • Cloud-APIs aufrufen — Rufen Sie freigegebene CloudBase-Service-APIs über callCloudApi auf, mit expliziter version für Dienste mit mehreren Versionen.

Dokumentation

CloudBase AI Toolkit

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.

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

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ält instructions mit 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.md neben SKILL.md; ein neues MCP-Referenz-Skill dokumentiert die Remote-Endpunkte, die Plugin-Flags und die Tool-Schemas
  • Feedback: prepareFeedback gibt 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, plus auth site / 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 wie tke / mongodb / vod erfordern eine explizite version)
  • Deploy / Env: Neues appBuild-Tool mit Hosting-Build-Neutralisierung; queryEnv meldet die tatsächlich angewendete Region und domains respektiert 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 (deployApp akzeptiert den Zeitstempel, den getUploadUrl zurückgibt, getBuildLog akzeptiert 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 searchKnowledgeBase werden nun bei Bedarf geladen, was die 43-Tool-Oberfläche bei jedem tools/list um 9,1 % reduziert
  • Runtime / Hosting: Der CloudRun-Function-Modus darf PORT nicht binden (das erledigt das Function-Framework) und erhält ein Credential-Entscheidungsgate, das CLOUDBASE_APIKEY benennt; 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 demselben config/source/**-Korpus wie der inländische erstellt – Remote-streamableHttp mit 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:

BausteinRolle
PluginInstalliert MCP Server, Agent Skills und Hooks gemeinsam – weniger Verdrahtung pro IDE
Agent SkillsSzenario-Skills (Web / Mini Program / Datenbank / Auth / Funktionen usw.) hin zu funktionierender CloudBase-Praxis
MCPAnmelden, 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:

RepositoryInhalteTypischer Einstieg
CloudBase-AI-Toolkit (dieses Repo)MCP-Server-Quellcode; Marketplace-Quelle für Claude Code / Codexnpx @cloudbase/cloudbase-mcp@latest
dsh-pluginDeepSeek Harness Plugin (@cloudbase/dsh-plugin): MCP-Bridge + DB/Storage/Auth-Paneldsh plugin add @cloudbase/dsh-plugin
cloudbase-pluginOpen Plugin Spec Publish-Repo (CI-synchronisiert): MCP + Skills + Hooksnpx plugins add TencentCloudBase/cloudbase-plugin · CNB-Fallback: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git
cloudbase-sites-pluginSites-Plugin: Vite Web erstellen & deployennpx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git
cloudbase-skillsAgent-Skills-Sammlungnpx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git
skillsInstallationskatalog pro Skill (auch auf skills.sh)npx skills add tencentcloudbase/skills --skill <name>
awesome-cloudbase-examplesCloudBase-Beispiele und FallstudienBeispiele durchsuchen / klonen
OpenVibeCodingVibecoding-Vorlage auf CloudBaseAls 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 ToolEmpfohlener Pfad
Claude Code / Codex (nativer Marketplace)Füge dieses Repo als Marketplace hinzu und installiere dann das cloudbase-Plugin (Plugin-Dokumentation)
Open-Plugin-Spec-Toolsnpx plugins add TencentCloudBase/cloudbase-plugin
Eine CLI für viele Tools bevorzugtCloudBase 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 IDEsNur 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

Supported AI IDEs
ToolPlattformAnleitung
CloudBase AI CLICLIAnleitung
OpenClawCLIAnleitung
WorkBuddyEigenständige IDEAnleitung
DoubaoDesktop & Web (Plugin-Marketplace)Anleitung
MiniMax CodeDesktop-App & Terminal-CLI (Plugin-Marketplace)Anleitung
DeepSeek HarnessDesktop-App (Plugin)Anleitung
ZCodeEigenständige IDE (≥ 3.4.1 integriert)Anleitung
Kimi CodeCLI (Plugin-Marketplace)Anleitung
Kimi WorkDesktop-App (Plugin-Panel)Anleitung
Codex AppAppAnleitung
CursorEigenständige IDEAnleitung
WindSurfIDE / PluginsAnleitung
CodeBuddyEigenständige IDE (integriert)Anleitung
CLINEVS Code PluginAnleitung
GitHub CopilotVS Code PluginAnleitung
TraeEigenständige IDEAnleitung
Tongyi LingmaIDE / PluginsAnleitung
RooCodeVS Code PluginAnleitung
Baidu ComatePluginsAnleitung
Augment CodePluginsAnleitung
Claude CodeCLIAnleitung
Gemini CLICLIAnleitung
Codex CLICLIAnleitung
OpenCodeCLIAnleitung
Qwen CodeCLIAnleitung

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

  1. Plugin (wenn das Tool es unterstützt)
    npx plugins add TencentCloudBase/cloudbase-plugin
  2. CloudBase AI CLI
    npm i -g @cloudbase/cli && tcb ai
  3. 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.

StandortMCP-Endpunkt
China (Inland)https://tcb-api.cloud.tencent.com/mcp/v1
Internationalhttps://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.

SzenarioEmpfehlung
Persönlich / schnellster StartRemote-URL (OAuth)
Lokale Dateifunktionen benötigtLokales npx
CI / AutomatisierungRemote + statische Anmeldedaten
Selbst gehostetes MCPCloud-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

Docsdocs.cloudbase.net
IssuesGitHub Issues
ReleasesChangelog

Aktivität

Repository activity: 52-week commit trend, monthly npm downloads, and project health

Mitwirkende

Contributors


MIT · TencentCloudBase