Skip to main content

Kiro Setup Guide

After setup, you can operate CloudBase services directly from Kiro’s AI chat.

Examples:

  • "Build a WeChat Mini Program ordering system with CloudBase" — AI scaffolds pages, creates the cloud database, writes cloud functions, and guides preview
  • "Build a reservation management system that lets users place orders and admins update status" — AI models it with CloudBase PostgreSQL, configures permissions, and wires up frontend and backend
  • "Add phone-number login to a Web app" — AI enables the auth method and integrates the CloudBase SDK

No need to switch to the Cloud console — you can do everything in Kiro with natural language.

Prerequisites​

Before you start, make sure you have:

Node.js and a CloudBase environment ready

Node.js: Install Node.js v18.15.0 or later:

node --version

If you don’t have it installed, download it from the Node.js website.

CloudBase environment: See Create a CloudBase environment. New users on the domestic site can start for free.

Client
Connection
Site

Remote needs only a URL — your client walks you through browser authorization, so no keys land in config files.

Configure your AI tool to connect with CloudBase capabilities. Supports local and remote connection. See connection modes.

Step 1: Install / Configure CloudBase

Or add this configuration to .kiro/settings/mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "http",
5      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
6    }
7  }
8}
Need help?View Kiro docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt
Read https://docs.cloudbase.net/skill.md and tell me what it can do
Use CloudBase Skills: 在 Web 应用中使用 CloudBase PostgreSQL 的 JS SDK 实现数据增删改查

Configuration​

Kiro supports two configuration scopes:

  1. Workspace scope: .kiro/settings/mcp.json - only applies to the current workspace
  2. User scope: ~/.kiro/settings/mcp.json - applies to all workspaces

If both exist, workspace config takes precedence.

Steering files (development rules)​

Kiro uses Steering files to provide project knowledge. CloudBase AI development rules are downloaded into .kiro/steering/.

Steering supports:

  • AGENTS.md: placed at the project root; Kiro reads it automatically
  • Markdown files: placed under .kiro/steering/, supports conditional loading and manual referencing

See: Kiro Steering docs

FAQ​

Q: MCP connection failed?

A: Check the config format, restart Kiro, and confirm your network.

Q: Tool count shows 0?

A: See the FAQ.

Q: Steering files don’t take effect?

A: Ensure files are under .kiro/steering/ and formatted correctly. AGENTS.md is loaded automatically.

More: FAQ

相关资源