Amazon Q Developer 的 Busabase 接入

把 Amazon Q Developer 接上 Busabase

AWS 的生成式 AI 助手,用于构建与运维 AWS 应用;提供终端 CLI,以及 VS Code、JetBrains、Visual Studio、Eclipse 的插件。

粘贴到 Amazon Q Developer 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。

阅读 Amazon Q Developer 官方文档
Busabase
Agent Skill
Busabase 审核收件箱,显示等待批准的变更提案

把这一句话交给你的 agent

你拿到的比一个连接器多:busabase skill 里带着完整的审批优先工作流、CLI 和全部 API——以后每个会话都在,不用再粘一遍。

先问你

Busabase Cloud 还是本地桌面版——动手之前先由你决定。

完成连接

帮你登录并自己保管凭证,不用手工复制 API Key。

建好第一个 Base

创建并填充数据,工作区打开时不会是一片空白。

装上常驻 skill

busabase 与 busabase-app-creator 长期驻留,此后每次会话都能直接用。

这个 agent 的注意事项

走 Skill 路径请用 CLI(`q chat`),它具备安装文档所需的 shell 权限。IDE 插件偏对话式,更适合走下面的连接器路径。

更想要连接器?

如果你不打算让 agent 自己装 skill,而是想把 Busabase 作为 MCP 工具接入,用下面这个服务器地址。

接入概览

厂商
AWS
接入方式
插件 / Skill · MCP + OAuth
传输方式
Streamable HTTP
认证方式
OAuth(动态注册)
配置文件
~/.aws/amazonq/cli-agents (IDE: ~/.aws/amazonq/agents/default.json)
执行这段命令
qchat mcp add --name busabase --url https://busabase.com/api/mcp

Amazon Q Developer 有终端 CLI(q chat / qchat),因此适用 Skill 路径——把上面那句提示词交给它即可。

更想要连接器?

AWS 文档原文:CLI 「同时支持本地 MCP 服务器(以进程运行)和远程 MCP 服务器(通过 HTTP 通信)。远程服务器可使用 OAuth 认证,也可以完全开放、无需认证。」

CLI —— 远程服务器在 agent 配置文件里用 typeurl 两个字段配置:

{
  "mcpServers": {
    "busabase": {
      "type": "http",
      "url": "https://busabase.com/api/mcp"
    }
  }
}

全局 CLI agent 配置在 ~/.aws/amazonq/cli-agents。用 qchat mcp add | remove | list | import | status 管理。

OAuth 流程按 AWS 文档:用包含该服务器的 agent 启动会话(此时显示 "not yet loaded"),执行 /mcp 开始认证,保持 Q CLI 会话开着、在浏览器打开它给出的 URL,完成后回到 CLI——认证成功后该服务器的工具即可用。

IDE —— 全局配置在 ~/.aws/amazonq/agents/default.json。界面里传输协议选 http,在 URL 字段填服务器地址,可选地在 Headers 下填键值对。若端点需要授权,Amazon Q 会自动打开浏览器页面让你授权。

Amazon Q Developer 的 MCP 用法 · CLI MCP 配置 · IDE MCP 配置

已知的坑

CLI 与 IDE 读的是不同配置文件(`~/.aws/amazonq/cli-agents` 对 `~/.aws/amazonq/agents/default.json`),配好一个不等于另一个也配好了。远程服务器必须在 `url` 之外写 `"type": "http"`,漏掉 `type` 会被当成本地 stdio 条目。OAuth 期间要**保持 Q CLI 会话开着**再去浏览器完成流程,否则握手不会完成。

这份说明来自官方文档未记录核对日期

依据该 Agent 自己的官方文档整理,我们尚未在真机上逐步复跑。若命令有变动,请以下方链接的官方文档为准。

让你的 agent 自己完成接入

一句话、一次授权,此后它做的每一个改动都以提案的形式交给你审批。

浏览全部 Agent

粘贴到 Amazon Q Developer 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。