Connect Amazon Q Developer to Busabase
AWS's generative-AI assistant for building and operating AWS applications — available as a terminal CLI and as an extension for VS Code, JetBrains, Visual Studio and Eclipse.
Paste this into Amazon Q Developer
Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

Give your agent this one instruction
You end up with more than a connector: the busabase skill carries the whole approval-first workflow, the CLI, and the full API — available in every future session without re-pasting anything.
Asks first
Busabase Cloud or Personal Desktop — your call, before anything happens.
Connects
Signs you in and stores the credential itself. No API key to copy by hand.
Seeds a Base
Creates and fills your first Base, so the workspace is not an empty screen.
Installs the skills
busabase and busabase-app-creator become permanent, for every session after this.
For this agent
Use the CLI (`q chat`) for the Skill path — it has the shell access the setup document needs. The IDE extension is chat-oriented and better suited to the connector route below.
Prefer a connector?
If you would rather wire Busabase in as MCP tools than let the agent install a skill, use the server URL below.
At a glance
- Vendor
- AWS
- How it connects
- Plugin / Skill · MCP + OAuth
- Transport
- Streamable HTTP
- Authentication
- OAuth (dynamic registration)
- Config file
- ~/.aws/amazonq/cli-agents (IDE: ~/.aws/amazonq/agents/default.json)
qchat mcp add --name busabase --url https://busabase.com/api/mcpAmazon Q Developer has a terminal-based CLI (q chat / qchat), so the Skill path applies — hand it the prompt above.
Prefer a connector?
AWS's docs state that the CLI "supports both local MCP servers (that run as processes) and remote MCP servers (that communicate over HTTP). Remote servers can use OAuth authentication or be open (no authentication required)."
CLI — remote servers are configured in your agent configuration file with the type and url fields:
{
"mcpServers": {
"busabase": {
"type": "http",
"url": "https://busabase.com/api/mcp"
}
}
}
Global CLI agent config lives at ~/.aws/amazonq/cli-agents. Manage servers with qchat mcp add | remove | list | import | status.
For OAuth, AWS documents this flow: start the session with an agent that includes the server (it shows as "not yet loaded"), run /mcp to begin authentication, open the URL it prints while keeping the Q CLI session open, finish in the browser, then return — the server's tools become available once authentication completes.
IDE — global config is ~/.aws/amazonq/agents/default.json. In the UI, select http as the transport protocol, put the server URL in the URL field, and optionally add key-value pairs under Headers. If the endpoint requires authorization, Amazon Q automatically opens a browser page for you to authorize it.
Using MCP with Amazon Q Developer · CLI MCP configuration · IDE MCP configuration
Known gotchas
CLI and IDE read different config files (`~/.aws/amazonq/cli-agents` vs `~/.aws/amazonq/agents/default.json`) — configuring one does not configure the other. Remote servers need `"type": "http"` alongside `url`; omitting `type` leaves it treated as a local stdio entry. During OAuth, keep the Q CLI session open while you complete the browser flow, or the handshake will not complete.
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, reviewed access, and every change it makes afterwards arrives as a proposal you approve.
Browse every agentPaste this into Amazon Q Developer
Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.