import IDESelector from '../components/IDESelector';
import RelatedResources from '../components/RelatedResources';

# Kiro 配置指南

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

**例如：**

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

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

## 前置条件

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

<details>
<summary><strong>已准备好Node.js 环境和云开发环境</strong></summary>

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

```bash
node --version
```

如果未安装，请从 [Node.js 官网](https://nodejs.org/en/download) 下载安装。

**云开发环境：** 请参考文档 [开通云开发环境](../../quick-start/create-env)。新用户可以免费开通体验。

</details>

---

<IDESelector defaultIDE="kiro" showInstallButton={false} />

## 配置说明

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 文档](https://kiro.dev/docs/steering/)。

## 常见问题

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

**Q: 工具数量显示为 0？**
A: 请参考[常见问题](../faq#mcp-显示工具数量为-0-怎么办)。

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

更多问题请查看：[完整 FAQ](../faq)

<RelatedResources ideName="Kiro" ideDocUrl="https://kiro.dev/docs/mcp/configuration/" />

