핵심 요약
- 한 프로젝트용이면 .kiro/settings/mcp.json에, 모든 프로젝트용이면 다음 위치에 저장합니다: ~/.kiro/settings/mcp.json. 아래 빌더는 두 파일 중 하나나 사용자 지정 에이전트를 작성합니다.
- Kiro는 Claude Code와 같은 "mcpServers" 형태, 즉 "command"와 "args"를 사용합니다. 두 파일이 모두 있으면 Kiro가 병합하고 워크스페이스가 우선합니다.
- 입력하거나 클릭하는 작업은 승인을 켜 두세요. 원한다면 autoApprove(mcp.json 안) 또는 allowedTools(에이전트 안)로 Kiro가 묻지 않고 페이지를 읽게 할 수 있습니다.
- CAPTCHA나 2FA 단계에서는 Kiro를 멈추게 하고, 같은 탭에서 직접 확인을 마친 뒤 대화를 이어 갑니다. CLI에서는 kiro-cli chat --resume을 사용합니다.
- Kiro는 MCP 명령을 포함해 모든 작업에 로그인이 필요합니다. 저희는 로그인 전에 무엇이 작동하는지, 그리고 빌더의 모든 파일이 브라우저 서버를 시작하는지 확인했습니다.
LaunchRepo는 워크스페이스의 파일을 읽고 쓸 수 있고 브라우저를 제어할 수 있는 코딩 에이전트라면 어떤 것과도 작동합니다. Kiro는 둘 다 할 수 있습니다. 이 페이지는 설정과 저희의 확인 내용을 기록한 것이며, 인증이나 파트너십이 아닙니다.
mcp.json 만들기
세 가지 선택, 하나의 파일. 모든 것이 브라우저 안에서 실행되며 어디에도 전송되지 않습니다.
파일이 이미 있다면 파일을 교체하지 말고 그 "mcpServers" 객체 안에 chrome-devtools 항목만 추가하세요. 저장하면 Kiro가 변경 사항을 반영합니다.
- IDE: 명령 팔레트를 열고 “Kiro: Open workspace MCP config (JSON)” 또는 “Kiro: Open user MCP config (JSON)”을 실행한 뒤 항목을 붙여 넣습니다. 설정에서 MCP 지원이 켜져 있어야 합니다.
- CLI: 위 경로에 파일을 저장합니다. 에이전트는 .kiro/agents/에 두고 kiro-cli chat --agent launchrepo로 시작합니다.
- Kiro에게 https://example.com을 열고 페이지 제목을 읽어 달라고 요청합니다. 제목이 맞으면 브라우저가 연결된 것입니다.
Kiro가 MCP 서버를 찾는 위치
세 계층이 있으며 위에 있을수록 우선합니다. 이름이 다른 서버는 합쳐지고, 같은 이름은 가장 높은 계층에서만 가져옵니다.
- 에이전트 설정
사용자 지정 에이전트의 mcpServers 필드. 위치는 .kiro/agents/ 또는 ~/.kiro/agents/입니다.
- 워크스페이스
프로젝트의 .kiro/settings/mcp.json.
- 사용자
홈 폴더의 ~/.kiro/settings/mcp.json.
- 에이전트는 서버를 "disabled": true로 정의해, 워크스페이스 파일이 그 서버를 시작하더라도 자신에게서는 끌 수 있습니다.
- "includeMcpJson": true를 지정하면 에이전트는 두 mcp.json 파일의 모든 서버도 함께 받습니다.
- KIRO_HOME은 ~/.kiro 폴더 전체를 옮깁니다. 같은 컴퓨터에서 출시용 프로필을 따로 둘 때 유용합니다.
어떤 Kiro가 무엇을 읽는가
| Kiro | 읽는 MCP 설정 |
|---|---|
| IDE와 CLI | 사용자, 워크스페이스, 에이전트 파일 |
| Web | 복제한 저장소의 프로젝트 .kiro/settings/mcp.json만 |
| 모바일 | 저장소의 MCP 서버를 읽지 않음 |
브라우저 작업은 누가 승인하는가
Kiro는 여러 제어 장치를 겹겹이 둡니다. 출시 작업의 원칙은 간단합니다. 읽기는 자동이어도 되고, 입력과 클릭은 여러분을 기다려야 합니다.
| 제어 | 설정 위치 | 하는 일 |
|---|---|---|
| autoApprove / disabledTools | mcp.json의 서버 항목 | 나열한 도구를 확인 없이 실행하거나, 에이전트에게서 도구를 숨김 |
| allowedTools | 사용자 지정 에이전트 | 에이전트가 확인 없이 쓸 수 있는 도구, 예: @chrome-devtools/take_snapshot |
| 권한 규칙 | ~/.kiro/settings/permissions.yaml, 저장소 밖의 워크스페이스별 설정, 또는 에이전트 안 | 기능별로 deny, ask, allow 지정(mcp 포함). deny가 항상 우선 |
| Autopilot 또는 Supervised | IDE 채팅 전환 스위치 | Supervised는 파일 편집이 있는 턴마다 제어권을 넘김 |
| --trust-tools / --trust-all-tools | CLI 플래그 | 한 번의 실행에 대해 도구 그룹 또는 전체를 사전 승인 |
- Kiro가 로그인된 Chrome에 연결되어 있을 때는 --trust-all-tools를 항상 꺼 두세요.
- 워크스페이스 권한 규칙은 저장소가 아니라 홈 폴더에 있으므로, 복제한 프로젝트가 여러분 대신 도구를 승인할 수 없습니다.
- 설정 레퍼런스는 autoApprove에 접두사 없는 도구 이름을 보여 주며, 빌더도 이를 사용합니다. 그래도 Kiro가 읽기 전용 도구에 대해 확인을 요청하면, 승인 프롬프트에 표시되는 정확한 이름을 사용하세요.
CAPTCHA, 2FA와 재개
양식이 CAPTCHA, 2FA 입력 창, 패스키에 이르면 Kiro는 멈추고 여러분이 할 한 가지 단계를 설명해야 합니다. 승인이 켜져 있으면 어차피 확인 단계를 클릭해서 넘어갈 수 없습니다.
같은 Chrome 탭에서 확인을 완료합니다. 내 Chrome(--autoConnect)이라면 채팅이 끝나도 탭이 열려 있습니다. 임시 Chrome(--isolated)은 3회 확인 모두에서 브라우저 서버와 함께 닫혔으므로, 작업을 마칠 때까지 그 채팅을 열어 두세요.
그런 다음 같은 대화를 이어 갑니다. IDE에서는 열려 있는 채팅입니다. CLI에서는 Kiro가 폴더별로 세션을 저장하므로, 가장 최근 세션을 재개하거나 ID로 고릅니다.
헤드리스 실행(kiro-cli chat --no-interactive)에는 유료 요금제의 Kiro API 키가 필요합니다. 인계가 있는 출시 작업에는 대화형 세션이 자연스럽습니다.
- 이 폴더의 최근 세션 재개
kiro-cli chat --resume- 특정 세션 재개
kiro-cli chat --resume-id <SESSION_ID>- 저장된 세션 목록 보기
kiro-cli chat --list-sessions
계정 없이 확인한 내용
Kiro는 채팅을 실행하기 전에 GitHub, Google, AWS Builder ID 또는 조직 계정으로 로그인하도록 요구합니다. 저희는 계정을 만들지 않았습니다. 대신 Kiro CLI 2.26.1 버전을 계정 없이 가능한 데까지 새 홈 폴더에서 3회 확인했고, 빌더의 모든 파일을 작성된 그대로 시작했습니다.
| 확인 항목 | 결과 |
|---|---|
명령줄에서 서버 추가kiro-cli mcp add --name chrome-devtools --scope workspace … | 로그인 전 거부 (3/3) |
설정된 서버 목록 보기kiro-cli mcp list | 로그인 전 거부 (3/3) |
서버 상태 보기kiro-cli mcp status --name chrome-devtools | 로그인 전 거부 (3/3) |
JSON 파일에서 서버 가져오기kiro-cli mcp import --file import.json workspace | 로그인 전 거부 (3/3) |
에이전트 목록 보기kiro-cli agent list | 로그인 전 거부 (3/3) |
| Kiro 공식 다운로드의 설치 프로그램, 체크섬이 매니페스트와 일치 | kiro-cli 2.26.1 |
| kiro-cli whoami | “Not logged in” (3/3) |
| 거부된 명령이 작성한 mcp.json | 없음 (3/3) |
| kiro-cli chat --help에 있는 플래그 | --resume, --resume-id, --list-sessions, --require-mcp-startup, --trust-tools 모두 있음 (3/3) |
| 빌더의 모든 파일이 Chrome DevTools MCP 1.10.1 서버를 작성된 그대로 시작 | 파일 12개 중 12개, 각각 도구 30개 (3/3) |
| 브라우저 서버가 멈춘 뒤의 임시 Chrome(--isolated) | 함께 닫힘 (3/3) |
| 로그인 없이 kiro-cli chat --no-interactive | 실패하는 대신 브라우저 로그인을 엶(한 번 확인 후 제외) |
같은 서버, 세 가지 설정 방언
다른 에이전트에서 넘어오셨나요? Chrome DevTools MCP 항목은 Kiro와 Claude Code 사이에서 거의 그대로 옮겨집니다. OpenCode는 다른 형태가 필요합니다.
| 항목 | Kiro | OpenCode | Claude Code |
|---|---|---|---|
| 파일 | .kiro/settings/mcp.json | opencode.json | .mcp.json |
| 키 | mcpServers | mcp | mcpServers |
| 명령 | "command" + "args" | 하나의 "command" 배열 | "command" + "args" |
| 묻지 않고 읽기 | autoApprove 또는 allowedTools | 권한 규칙 "allow" | allow 규칙 mcp__chrome-devtools__… |
| 주제 | 원문 | 출시 작업에서의 의미 |
|---|---|---|
| 두 개의 mcp.json 파일 | If both files exist, configurations are merged with workspace settings taking precedence. | 프로젝트 항목이 같은 이름의 개인 항목을 덮어씁니다. |
| 최우선 순위 | Agent Config - mcpServers field in agent JSON | LaunchRepo 에이전트는 자체 브라우저 항목을 가질 수 있습니다. |
| 변경 사항 적용 | Changes to MCP configuration apply automatically when you save the file. | 재시작 불필요. 파일을 저장하면 서버가 다시 연결됩니다. |
| autoApprove | Tool names to auto-approve without prompting (use "*" to auto-approve all tools) | 로그인된 Chrome에서는 "*"를 절대 쓰지 말고, 읽기 전용 도구만 나열하세요. |
| 에이전트의 allowedTools | The allowedTools field specifies which tools can be used without prompting the user for permission. | autoApprove의 에이전트 버전으로, @chrome-devtools/<tool> 형식으로 씁니다. |
| 워크스페이스 권한 규칙 | A cloned repo cannot inject permission rules - trust is something you configure on your own machine. | 공유 저장소에서도 승인은 여러분의 컴퓨터에 남습니다. |
| deny가 allow를 이김 | A deny rule in any scope blocks the action regardless of allow rules elsewhere. | deny 규칙 하나로 위험한 도구에 확실하게 제동을 걸 수 있습니다. |
| 서드파티 서버 | Kiro does not vet, sandbox, or restrict the behavior of third-party MCP servers. | 버전을 고정하고(저희는 1.10.1 사용) 공식 패키지에서만 설치하세요. |
| Supervised 모드 | Kiro yields for your approval after each turn that contains file edits. | 파일 편집이 대상입니다. 브라우저 작업은 위의 승인 설정으로 제어됩니다. |
| CLI 세션 | To resume a specific session by ID: | 확인을 마친 뒤 대화로 돌아가는 방법입니다. |
| 헤드리스 모드 | Headless mode requires an API key set as the KIRO_API_KEY environment variable. | 무인 실행에는 API 키가 필요하고, 대화형 세션에는 필요 없습니다. |
| API 키 | API key authentication is only available for Kiro Pro, Pro+, Pro Max, and Power subscribers. | 헤드리스에는 유료 요금제가 필요하지만, 이 페이지의 설정에는 필요 없습니다. |
| 무료 등급 | New users can start with the perpetual Kiro Free tier, which includes 50 credits. | 설정을 대화형으로 시험하기에 충분합니다. 크레딧과 한도는 Kiro의 기준을 따릅니다. |
| Chrome DevTools MCP: Kiro 섹션 | In **Kiro Settings**, go to `Configure MCP` > `Open Workspace or User MCP Config` > Use the configuration snippet provided above. | 빌더가 작성하는 것과 같은 두 설정 파일입니다. |
Kiro에서 LaunchRepo 시작하기
LaunchRepo 프라이빗 워크스페이스를 Kiro에서 열거나 그곳에서 kiro-cli chat을 시작한 뒤 시작 프롬프트를 붙여 넣습니다. 그러면 키트가 온보딩을 안내하고, Example Domain에서 Chrome 연결을 테스트하고, 실행을 구성합니다.
- 시작 프롬프트는 최상의 결과를 위해 Claude Code 또는 Codex CLI를 권장합니다. Kiro도 같은 키트로 작동합니다. 키트에 필요한 두 가지, 즉 워크스페이스 파일 접근과 MCP를 통한 브라우저를 갖추고 있기 때문입니다.
- 빌더의 에이전트 옵션은 키트의 AGENTS.md를 Kiro의 프롬프트로 지정하므로, 규칙이 에이전트와 함께 따라갑니다.
- CAPTCHA와 2FA 단계는 인계로 여러분에게 돌아옵니다. 위에서 본 것처럼 세션을 재개합니다.
LaunchRepo 시작 프롬프트
Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.
Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.확인 범위 밖의 내용
- 로그인된 Kiro IDE나 CLI 안에서의 파일 로드, 승인 프롬프트, 인계 자체. 이 단계들은 Kiro 문서를 따르며, 저희는 Kiro 계정을 만들지 않았습니다.
- MCP 도구에 대해 Kiro가 autoApprove에서 어떤 표기를 기대하는지. 문서에는 접두사 없는 이름과 접두사가 붙은 이름이 모두 나옵니다.
- 실제 AI 모델, 평소 쓰는 Chrome 프로필에 대한 --autoConnect, Windows와 Linux, Kiro Web, 유료 요금제.
출처
위의 모든 인용은 2026년 10월 1일에 읽은 아래 페이지에서 한 글자도 바꾸지 않고 옮긴 것입니다. 검증된 동작은 이 페이지에서 설명하는 저희의 직접 실행에서 나온 결과입니다.
자주 묻는 질문
- Kiro MCP 설정 파일은 어디에 있나요?
- 워크스페이스 서버는 프로젝트 안의 .kiro/settings/mcp.json에, 어디서나 쓰려는 서버는 ~/.kiro/settings/mcp.json에 있습니다. 사용자 지정 에이전트도 서버를 정의할 수 있으며, 위치는 .kiro/agents/ 또는 ~/.kiro/agents/입니다.
- Chrome DevTools MCP용 Kiro mcp.json은 어떤 모습인가요?
- chrome-devtools 항목이 있는 "mcpServers" 객체로, "command": "npx"와 "args": ["-y", "chrome-devtools-mcp@1.10.1", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]를 지정합니다. 이 페이지의 빌더가 대신 작성해 줍니다.
- Kiro에서 워크스페이스 설정과 사용자 설정 중 어느 쪽이 우선하나요?
- Kiro는 둘을 병합합니다. 같은 이름의 서버는 워크스페이스 파일이 우선하며, 에이전트 자체의 mcpServers 항목은 둘 다보다 우선합니다.
- Kiro가 매번 묻지 않고 브라우저를 쓰게 할 수 있나요?
- 네, mcp.json의 autoApprove나 에이전트의 allowedTools에 도구를 나열하면 됩니다. 출시 작업에서는 take_snapshot 같은 읽기 전용 도구로 한정하고, 입력과 클릭은 확인을 거치게 하세요.
- CAPTCHA 후 Kiro 세션은 어떻게 이어 가나요?
- 같은 Chrome 탭에서 확인을 마친 뒤 IDE의 열린 채팅으로 돌아가거나, 같은 폴더에서 kiro-cli chat --resume(또는 --resume-id <SESSION_ID>)을 실행하고, 제출하기 전에 양식을 다시 읽도록 Kiro에게 요청하세요.
- LaunchRepo는 Kiro를 공식 지원하나요?
- LaunchRepo는 파일과 브라우저에 접근할 수 있는 코딩 에이전트를 지원하며, Kiro는 둘 다 갖추고 있습니다. 이 페이지는 설정과 계정 없이 진행한 저희의 확인을 기록한 것입니다. 인증이나 파트너십이 아니며, 시작 프롬프트는 여전히 최상의 결과를 위해 Claude Code 또는 Codex CLI를 권장합니다.
Kiro에 출시 계획을 맡기세요
LaunchRepo는 에이전트에게 플랫폼 목록, 런북, 그리고 에이전트가 계속 최신으로 유지하는 트래커를 제공합니다. Kiro가 여러분의 브라우저에서 작업하고, 최종 결정은 여러분이 내립니다.
가격 보기