跳到主要内容

Kiro 配置指南

配置后，你可以在 Kiro 的 AI 对话中直接操作 CloudBase 服务。

例如：

  • "创建用户表" - AI 自动创建数据库集合
  • "部署这个函数" - AI 自动上传并配置云函数
  • "部署前端到 CDN" - AI 自动上传文件并配置托管

无需切换到云控制台，所有操作都可以在 Kiro 中用自然语言完成。

前置条件​

在开始配置之前，请确保满足以下条件：

已准备好Node.js 环境和云开发环境

Node.js 环境： 确保已安装 Node.js v18.15.0 或更高版本：

node --version

如果未安装，请从 Node.js 官网 下载安装。

云开发环境： 请参考文档 开通云开发环境。新用户可以免费开通体验。

Client

配置你的 MCP 客户端以连接 CloudBase 环境

步骤 1：安装

使用项目模板（推荐） - 模板已内置 MCP 配置和 AI 规则查看模板

将以下配置添加到项目目录的 .kiro/settings/mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "command": "npx",
5      "args": ["@cloudbase/cloudbase-mcp@latest"],
6      "env": {
7        "INTEGRATION_IDE": "Kiro"
8      }
9    }
10  }
11}
需要帮助？查看 Kiro 文档

步骤 2：验证连接

配置完成后，在 AI 对话中输入以下内容验证:

prompt
检查 CloudBase MCP 工具是否可用, 下载 CloudBase AI 开发规则到当前项目

配置说明​

Kiro 支持两种级别的配置：

  1. 工作区级别：.kiro/settings/mcp.json - 仅适用于当前工作区
  2. 用户级别：~/.kiro/settings/mcp.json - 适用于所有工作区

如果两个文件都存在，工作区配置会优先于用户配置。

Steering 文件（开发规则）​

Kiro 使用 Steering 文件来提供项目知识。CloudBase AI 开发规则会自动下载到 .kiro/steering/ 目录。

Steering 文件支持：

  • AGENTS.md：放在项目根目录，Kiro 会自动读取，无需配置
  • Markdown 文件：放在 .kiro/steering/ 目录下，支持条件加载和手动引用

更多信息请参考 Kiro Steering 文档。

常见问题​

Q: MCP 连接失败？ A: 检查配置文件格式是否正确，重启 Kiro，确认网络连接正常。

Q: 工具数量显示为 0？ A: 请参考常见问题。

Q: Steering 文件没有生效？ A: 确保文件位于 .kiro/steering/ 目录下，并且文件格式正确。AGENTS.md 文件会自动加载。

更多问题请查看：完整 FAQ

相关资源