Kiro를 Busabase에 연결하기
AWS's agentic coding tool: the Kiro IDE turns prompts into specs and working code, and the Kiro CLI, formerly the Amazon Q Developer CLI, brings the same agent to the terminal.
Kiro에 이 내용을 붙여넣으세요
https://busabase.com/SETUP_SKILL.md을 읽고 저를 위해 Busabase를 설정해줘. 끝까지 따라간 다음 연결이 되는지 확인해줘.

에이전트에게 이 지시 한 줄만 주세요
커넥터 그 이상을 얻게 됩니다: busabase 스킬에는 변경 요청 워크플로우 전체와 CLI, 전체 API가 담겨 있어서, 이후 세션에서는 다시 붙여넣을 필요 없이 바로 쓸 수 있습니다.
먼저 물어봄
Busabase Cloud로 할지, 개인용 데스크톱으로 할지 — 시작하기 전에 여러분에게 먼저 묻습니다.
연결
로그인을 진행하고 인증 정보를 알아서 저장합니다. API 키를 직접 복사할 필요가 없습니다.
베이스 생성
첫 번째 베이스를 만들고 데이터를 채워, 워크스페이스가 빈 화면으로 남지 않게 합니다.
스킬 설치
busabase와 busabase-app-creator가 상시 설치되어, 이후 모든 세션에서 바로 쓸 수 있습니다.
이 에이전트 관련 참고 사항
Kiro is spec-driven: it may want to write a spec before executing, so let it read the setup document first, then approve the commands it proposes. The skills installer targets Kiro as `kiro-cli` and writes to `~/.kiro/skills`, which both the Kiro IDE and the Kiro CLI read. Custom agents only load skills listed in their `resources` with `skill://`.
커넥터 방식을 선호하시나요?
에이전트가 스킬을 설치하게 하는 대신 Busabase를 MCP 도구로 직접 연결하고 싶다면, 아래 서버 URL을 사용하세요.
한눈에 보기
- 제공사
- AWS
- 연결 방식
- 플러그인 / 스킬 · MCP + OAuth
- 전송 방식
- Streamable HTTP
- 인증 방식
- OAuth (동적 등록)
- 설정 파일
- .kiro/settings/mcp.json (user: ~/.kiro/settings/mcp.json)
curl -fsSL https://cli.kiro.dev/install | bash # Kiro CLI, macOS/Linux
irm 'https://cli.kiro.dev/install.ps1' | iex # Kiro CLI, Windows 11
# Kiro IDE: download from https://kiro.devKiro — the IDE or the Kiro CLI — can fetch a URL and run commands, so the Skill path applies: paste the prompt above.
Prefer a connector?
Add Busabase to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace, which wins when both define the same server):
{
"mcpServers": {
"busabase": {
"url": "https://busabase.com/api/mcp",
"oauth": {
"oauthScopes": ["mcp"]
}
}
}
}
Kiro registers its own OAuth client (dynamic client registration) and opens the sign-in page in your browser. Keep the entry's oauth.oauthScopes set to ["mcp"]: Busabase grants MCP clients exactly one scope, mcp, and a request naming a different Busabase scope without it is rejected.
Kiro CLI: kiro-cli mcp add only takes a --command for local servers, so edit the JSON file above or use kiro-cli mcp import --file <file>. In a kiro-cli chat session, open /mcp and press Enter on busabase to start sign-in; /mcp auth busabase retries it.
Coming from the Amazon Q Developer CLI? Installing Kiro CLI copies ~/.aws/amazonq/mcp.json to ~/.kiro/settings/mcp.json once, so an existing busabase entry carries over. Anything added to the old file afterwards is not picked up.
알려진 주의사항
`kiro-cli mcp add` has no URL option, so remote servers go in the JSON file. Workspace `.kiro/settings/mcp.json` overrides the user file, so check both if a stale server keeps loading. The remote `url` shape and the `auth` / `oauth` fields are documented on the Configuration page, and Kiro's MCP overview now also shows a remote-server example (an earlier version of this note said the main page demonstrated stdio only). Current docs add an `auth` object (`issuer_url`, `storage`, `grant_types`, `scopes`) and an `oauth` block on each server entry, and tokens are stored per workspace in `.kiro/.mcp-auth/`. If you hit OAuth scope errors, the docs' workaround is an empty scope array (`"oauthScopes": []`); with no scopes configured Kiro requests a default set (openid, email, profile, offline_access), which Busabase answers with its single `mcp` scope.
다른 에이전트와 비교
이 디렉터리에 등록된 다른 에이전트들과 연결 기능을 나란히 비교해 보세요.
| 기능 | |||
|---|---|---|---|
| 유형 | AI 에디터 | 터미널 에이전트 | AI 에디터 |
| 추천 방법 | Agent Skill | Agent Skill | Agent Skill |
| 연결 방식 | 플러그인 / 스킬 · MCP + OAuth | MCP + OAuth · 플러그인 / 스킬 | MCP + OAuth · 플러그인 / 스킬 |
| 전송 방식 | Streamable HTTP | Streamable HTTP | Streamable HTTP |
| 인증 방식 | OAuth (동적 등록) | OAuth (동적 등록) | OAuth (동적 등록) |
Kiro에 이 내용을 붙여넣으세요
https://busabase.com/SETUP_SKILL.md을 읽고 저를 위해 Busabase를 설정해줘. 끝까지 따라간 다음 연결이 되는지 확인해줘.