Connect Amazon Q Developer to Busabase
Renamed: the Amazon Q Developer CLI is now the Kiro CLI. What remains is AWS's Amazon Q extension for VS Code, JetBrains, Visual Studio and Eclipse, supported until April 30, 2027, with new features shipping only in Kiro.
Busabase MCP server
https://busabase.com/api/mcp

Set it up
Hosted chat has no shell and no file system, so a connector is the way in.
Add the server
Point your chat client at the Busabase MCP endpoint.
Sign in
Complete OAuth in the browser — no client id or secret to create.
Pick the smallest permission
changeRequest lets the agent propose but never merge.
Verify
Ask the agent to call auth_verify before it does any work.
Step by step
This host has no shell, so a connector is the only way in.
At a glance
- Vendor
- AWS
- How it connects
- MCP + OAuth
- Transport
- Streamable HTTP
- Authentication
- Unknown
- Config file
- ~/.aws/amazonq/default.json (project: .amazonq/default.json)
Using the command line? The Amazon Q Developer CLI has become the Kiro CLI. Follow Connect Kiro to Busabase instead.
In the Amazon Q extension for your IDE:
- Open the Q Developer panel, open Chat, and choose the tools icon.
- Choose +, then pick a scope: global (saved to
~/.aws/amazonq/default.json) or local (.amazonq/default.jsonin this project). - Enter
busabaseas the Name, selecthttpas the transport, and enterhttps://busabase.com/api/mcpas the URL. - Choose Save, then review the tool permissions that appear.
- When Busabase asks for authorization, Amazon Q opens a browser page. Sign in and approve, then ask Amazon Q to call
auth_verify.
MCP configuration for Q Developer in the IDE
Known gotchas
AWS will discontinue support for the Amazon Q Developer IDE plugins on April 30, 2027, and new features ship only in Kiro. The Amazon Q CLI (`q`, `qchat`) has become the Kiro CLI, so older guides using `qchat mcp add` no longer apply. The IDE extension has no Agent Skills, so it connects over MCP only. AWS doesn't say whether the extension registers its OAuth client dynamically, which Busabase requires; not yet tested by us. AWS's older MCP overview page still describes the CLI and gives a different IDE path (`~/.aws/amazonq/agents/default.json`); this page follows the current IDE guide.
How it compares
Connection capabilities side by side with other agents already in this directory.
| Capability | |||
|---|---|---|---|
| Type | IDE plugins | Terminal agents | AI editors |
| Recommended path | MCP connector | Agent Skill | Agent Skill |
| How it connects | MCP + OAuth | MCP + OAuth · Plugin / Skill | MCP + OAuth · Plugin / Skill |
| Transport | Streamable HTTP | Streamable HTTP | Streamable HTTP |
| Authentication | Unknown | OAuth (dynamic registration) | OAuth (dynamic registration) |
Written from this agent's own documentation. We have not re-run every step on a real machine, so check the linked docs if a command has changed.
Let your agent do the setup
One instruction, one authorization, and every change it makes afterwards carries a message and a diff you can check or revert.
Browse every agentBusabase MCP server
https://busabase.com/api/mcp