Qoder 配置指南
配置后,你可以在 Qoder 的 AI 对话中直接操作 CloudBase 服务。
例如:
- "创建用户表" - AI 自动创建数据库集合
- "部署这个函数" - AI 自动上传并配置云函数
- "部署前端到 CDN" - AI 自动上传文件并配置托管
无需切换到云控制台,所有操作都可以在 Qoder 中用自然语言完成。
前置条件
在开始配置之前,请确保满足以下条件:
已准备好Node.js 环境和云开发环境
Node.js 环境: 确保已安装 Node.js v18.15.0 或更高版本:
node --version
如果未安装,请从 Node.js 官网 下载安装。
云开发环境: 请参考文档 开通云开发环境。新用户可以免费开通体验。
配置你的 MCP 客户端以连接 CloudBase 环境
步骤 1:安装
将以下配置添加到 Qoder 设置 > MCP:
1{2 "mcpServers": {3 "cloudbase": {4 "command": "npx",5 "args": ["@cloudbase/cloudbase-mcp@latest"],6 "env": {7 "INTEGRATION_IDE": "Qoder"8 }9 }10 }11}步骤 2:验证连接
配置完成后,在 AI 对话中输入以下内容验证:
检查 CloudBase 工具是否可用, 下载 CloudBase AI 开发规则到当前项目配置步骤
方法一:手动配置 MCP 服务
在 Qoder IDE 的右上角,点击用户图标,或使用键盘快捷键(
⌘⇧,(macOS)或CtrlShift,(Windows)),然后选择 Qoder Settings。在左侧导航窗格中,点击 MCP。
在 My Servers 选项卡中,点击右上角的 + Add。
在弹出的 JSON 文件中,添加以下配置:
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"INTEGRATION_IDE": "Qoder"
}
}
}
}
- 关闭文件,并在提示时点击 Save。
保存后,新服务会出现在你的列表中。链接图标表示连接成功。展开该条目以查看可用工具。
注意: 如果服务因缺少依赖而启动失败,点击 Quick Fix。若问题仍然存在,请手动安装依赖。有关故障排查,请参阅 MCP 常见问题。
方法二:使用 MCP Square(可选)
你也可以通过 MCP Square 安装预配置的 MCP 服务:
- 在 MCP 页面,点击 MCP Square 选项卡。
- 浏览可用服务列表,找到 CloudBase MCP 服务并点击 Install。
- 前往 My Servers 选项卡确认安装,展开详情以查看工具列表。
验证连接
配置完成后,在 Qoder 的智能体模式中输入:
检查 CloudBase 工具是否可用
重要提示: MCP 服务仅在 Agent 模式(智能体模式)下受支持。在 AI Chat 面板中,请确保已切换到 Agent 模式。
常见问题
Q: MCP 连接失败? A: 检查配置文件格式是否正确,重启 Qoder,确认网络连接正常。如果服务因缺少依赖而启动失败,点击一键修复。若问题仍然存在,请手动安装依赖。
Q: 工具数量显示为 0? A: 请参考常见问题。
Q: MCP 服务在哪里使用? A: MCP(Model Context Protocol)服务仅在 Agent 模式(智能体模式)下受支持。在 AI Chat 面板中,切换到 Agent 模式即可使用。最多可同时使用 10 个 MCP 服务。
Q: 如何调用 MCP 工具?
A: Qoder 会根据你的输入提示和工具名称自动选择合适的 MCP 工具。在调用工具前,Qoder 会先请求确认。按 ⌘ ⏎(macOS)或 Ctrl Enter(Windows)执行。若要自动运行后续的所有 MCP 服务,请勾选确认选项。
更多问题请查看:完整 FAQ
相关资源
- 开发指南 - 深入了解开发最佳实践
- 使用案例 - 查看实际应用案例
- MCP 工具 - 了解所有可用工具
- 常见问题 - 查看常见问题解答
- Qoder 官方文档 - Qoder MCP 官方文档