CloudBase AI ToolKit

CloudBase AI Toolkit

AIがコードを書き、CloudBaseがバックエンドを動かします。

AIコーディングツール向けのCloudBase統合レイヤーです。Pluginがスタックをインストールし、Skillsがコードの書き方を導き、MCPがチャットからデータベース、関数、ストレージを操作してデプロイします。

English · 简体中文 · ドキュメント · 変更履歴 · 問題報告

最近の更新

v2.37.x (2026-11)

• 診断: 不透明なバックエンドエラーを次の手順の案内に変換。関数のCLS失敗にはRequestIdと2つの並行セルフチェック手順を付与。コード更新ではStatusがまだ実行中であることを通知
• 安全性 / CloudRun: クライアントが確認できない一括削除は失敗扱いにする。CloudRunのターゲットパスはプロジェクト内に限定し、ホストの認証情報ディレクトリを指定できない
• PostgreSQL: migrationVersionには実在するカレンダー日時が必要。migrationDetailにはバージョンのみが必要。誤検知を起こすパスおよびSQLのガードを複数緩和
• エコシステム: Agent Plugins形式のCodexプラグイン版、Qianwenスキルマーケット向けパッケージ、中国サイト向けWorkBuddyコネクタパッケージ

v2.36.x (2026-10)

• MCP Apps: 環境、環境の使用状況、デプロイ結果の3つのパネルがデフォルトで有効。非表示にするにはCLOUDBASE_MCP_UI=offを設定
• 安全性: 削除、破壊的なSQL、および対応するcallCloudApi削除アクションは、対象を明示した確認があるまで一時停止。認証情報のような引数には差分チェックを1回実施（長さとsha256フィンガープリントのみ。値そのものは取得しない）
• 環境: 使用状況パネルに、人が読みやすい名称付きのメトリクス表示（QPS、呼び出し数、エラー、タイムアウト、MySQL、CloudRunの負荷）を追加。MySQLのプロビジョニングはツールの対象から廃止
• オンボーディング: すべてのinitialize応答に、最初に実行する読み取り専用呼び出しを示すinstructionsを付与。リモートセットアップのドキュメントではOAuthを先頭に案内

リリース · スターを付ける · ウォッチ → リリース

概要

Cursor、Claude Code、Codex、CodeBuddyなどのAI IDEは、コード生成に優れています。通常、作業を妨げるのはバックエンドです。スキーマ、権限、関数、ストレージ、環境、リリースなどの設定が必要になります。

CloudBaseは、Tencent CloudのAIネイティブなオールインワンバックエンドです（データベース、ストレージ、認証、クラウド関数、Cloud Runなど）。このリポジトリは、そのバックエンドをAIツールに接続するToolkitです。

このリポジトリでは、npmパッケージ@cloudbase/cloudbase-mcp、Skills、AIプラグインを提供しています。

CloudBase環境は別途必要です。また、AIが提案する重要な操作は確認してください。Toolkitが提供するのは機能と手段であり、判断ではありません。

関連リポジトリ

公開と同期を担うリポジトリはTencentCloudBase配下にあります。このToolkitに直接関連するものは次のとおりです。

フルスタックを使う場合はPluginを、知識面の制約だけが必要な場合はSkills単体を推奨します。マーケットプレイス対応IDEではこのリポジトリを使い、同じツールでnpx plugins addも実行しないでください。

クイックスタート

最速で始める方法

このAIプロンプトをAI IDEにコピーしてください。エージェントがskill.mdを読み取り、セットアップを完了します。

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": ["-y", "@cloudbase/npm-launcher@1.0.0", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

最初のプロンプト

Login to CloudBase

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

Skillsは構成と実践方法を導き、MCPは環境とリソースを扱います。ローカルのソースファイルを得るだけでなく、自分の環境でデータとAPIを検証できるようになります。

対応AI IDE

セットアップ全般については、IDEガイドを参照してください。

機能

セットアップ後、AIは環境内で一般的なバックエンド作業を実行できます（重要な手順は確認してください）。

• データベース: PostgreSQLとドキュメントDB、データモデル、CRUD、権限とセキュリティルール
• コンピューティング: クラウド関数 / Cloud Runの作成、デプロイ、呼び出し、デバッグ
• 認証とストレージ: ログイン方法、オブジェクトストレージ、データとの権限連携
• リリースと運用: 静的ホスティング / Mini Programの公開、ログの確認と再デプロイ

Web、WeChat Mini Programs、バックエンドサービスに対応しています。プラットフォームの概要については、CloudBaseドキュメントを参照してください。

評価

管理された条件下で、同じTodoアプリの要件とフロントエンドのひな形を使い、2つのバックエンド方式を比較しました。1つは従来型のクラウドVM（ランタイム、プロセス、ネットワーク公開を自己管理）、もう1つはCloudBase（マネージドデータベース、匿名認証、関連バックエンドサービス）です。AIエージェントが開発と検証をエンドツーエンドで実施しました。使用したモデルとタスク設定では、CloudBase方式のほうが完了までの時間、トークン使用量、ツール呼び出し回数の点で有利でした。これらの結果はモデル、エージェントフレームワーク、タスク定義に依存するため、その範囲を超えて一般化すべきではありません。

手法、データ、制約については、同一タスク評価: クラウドVMとCloudBaseの比較を参照してください。

インストールと接続

前提条件

• Node.js v18.15.0+
• CloudBase環境
• Plugin / Skills / MCPに対応したAIツール

セットアップ方法

1. Plugin（ツールが対応している場合）
   npx plugins add TencentCloudBase/cloudbase-plugin
2. MCPを手動で設定（IDEの設定ファイルを編集）

CloudBase CLIをすでに使用していますか？tcb aiでMCPとSkillsもセットアップできます（ドキュメント）。

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

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

その他については、IDEセットアップガイドを参照してください。

MCP接続モード

リモート（推奨）: IDEはHTTP経由でTencent Cloud MCPに接続します。ローカルのNodeは不要で、対話型クライアントではブラウザーで認証を完了します。

環境が存在するサイトに対応するエンドポイントを選択してください。2つのサイトではアカウント、コンソール、認証情報が別々です。

OAuth（対話型、推奨）: URLだけで設定できます。IDEがログインと同意のためにブラウザーを開き、そこで環境を選択します。設定ファイルにキーを記載する必要がなく、ローテーションも不要です。

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

静的認証情報（OAuth非対応クライアントおよびCI/CD向け）: env_idと、エンドポイントと同じサイトで作成したキーペアを追加します。

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

静的キーペアはローテーションまたは削除するまで有効です。OAuthセッションはログアウトすると終了します。ブラウザーフローを利用できない場合に限り静的方式を使い、リポジトリには含めないでください。

ローカル: マシン上でnpx -y @cloudbase/npm-launcher@1.0.0 @cloudbase/cloudbase-mcp@latestを実行します。ローカルファイルシステムからのアップロードやテンプレートのダウンロードなど、すべての機能を利用できます。

リモート接続の制約: ローカルファイルシステムを使う機能（アップロード、テンプレートのダウンロード）は利用できません。また、国際サイトではNoSQLツールはまだ提供されていません。

リモートURLではsiteも指定できます（domestic / intl。中国サイトの環境でap-singaporeを使い、リージョンが曖昧な場合にのみ必要）。また、ツールを絞り込むにはenable_plugins / disable_pluginsを指定します。正式な名称はmcp/src/server.tsに記載されています。 Remote MCP E2E（公式 SDK クライアント）: npm run test:hosted-mcp:e2e — apikey/OAuth モード、TLS 検証を無効にしたステージング環境、環境変数については tests/hosted-mcp-e2e/README.md を参照してください。認証情報がない場合はスキップされます（終了コード 0）。

セルフホスト Cloud Mode: CLOUDBASE_MCP_CLOUD_MODE=true（または MCP_CLOUD_MODE=true）を設定すると、リモート呼び出し元に対してローカルファイルツールとプロセスツールが無効になります。

例

オンライン五目並べ: 必要なものを説明すると、Web + クラウドデータベース / リアルタイム機能を利用してデプロイできます。
デモ: 五目並べ · その他: チュートリアル

ドキュメント

• MCP ツール（tools.json）
• はじめに
• IDE のセットアップ
• AI プラグイン
• テンプレート
• FAQ

FAQ

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

コミュニティ

アクティビティ

コントリビューター

MIT · TencentCloudBase