跳到主要内容

Qoder 配置指南

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

例如:

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

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

前置条件

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

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

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

node --version

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

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


Client

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

步骤 1:安装

将以下配置添加到 Qoder 设置 > MCP:

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

步骤 2:验证连接

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

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

配置步骤

方法一:手动配置 MCP 服务

  1. 在 Qoder IDE 的右上角,点击用户图标,或使用键盘快捷键( ,(macOS)或 Ctrl Shift ,(Windows)),然后选择 Qoder Settings

  2. 在左侧导航窗格中,点击 MCP

  3. My Servers 选项卡中,点击右上角的 + Add

  4. 在弹出的 JSON 文件中,添加以下配置:

{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"INTEGRATION_IDE": "Qoder"
}
}
}
}
  1. 关闭文件,并在提示时点击 Save

保存后,新服务会出现在你的列表中。链接图标表示连接成功。展开该条目以查看可用工具。

注意: 如果服务因缺少依赖而启动失败,点击 Quick Fix。若问题仍然存在,请手动安装依赖。有关故障排查,请参阅 MCP 常见问题

方法二:使用 MCP Square(可选)

你也可以通过 MCP Square 安装预配置的 MCP 服务:

  1. MCP 页面,点击 MCP Square 选项卡。
  2. 浏览可用服务列表,找到 CloudBase MCP 服务并点击 Install
  3. 前往 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

相关资源