kiro-agent-team 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/.kiro/README.md +228 -0
  2. package/.kiro/agents/backend-engineer.json +6 -0
  3. package/.kiro/agents/backend-engineer.md +643 -0
  4. package/.kiro/agents/database-specialist.json +6 -0
  5. package/.kiro/agents/database-specialist.md +390 -0
  6. package/.kiro/agents/development-logger.json +6 -0
  7. package/.kiro/agents/development-logger.md +265 -0
  8. package/.kiro/agents/devops-engineer.json +6 -0
  9. package/.kiro/agents/devops-engineer.md +287 -0
  10. package/.kiro/agents/frontend-architect.json +6 -0
  11. package/.kiro/agents/frontend-architect.md +1032 -0
  12. package/.kiro/agents/hooks/backend-engineer-hooks.yaml +540 -0
  13. package/.kiro/agents/hooks/database-specialist-hooks.yaml +488 -0
  14. package/.kiro/agents/hooks/development-logger-hooks.yaml +361 -0
  15. package/.kiro/agents/hooks/devops-engineer-hooks.yaml +345 -0
  16. package/.kiro/agents/hooks/frontend-architect-hooks.yaml +521 -0
  17. package/.kiro/agents/hooks/project-manager-hooks.yaml +513 -0
  18. package/.kiro/agents/hooks/security-specialist-hooks.yaml +358 -0
  19. package/.kiro/agents/hooks/test-orchestrator-hooks.yaml +380 -0
  20. package/.kiro/agents/hooks/ui-ux-designer-hooks.yaml +353 -0
  21. package/.kiro/agents/project-manager.json +6 -0
  22. package/.kiro/agents/project-manager.md +344 -0
  23. package/.kiro/agents/prompts/backend-engineer-system.md +815 -0
  24. package/.kiro/agents/prompts/database-specialist-system.md +332 -0
  25. package/.kiro/agents/prompts/development-logger-system.md +232 -0
  26. package/.kiro/agents/prompts/devops-engineer-system.md +260 -0
  27. package/.kiro/agents/prompts/frontend-architect-system.md +305 -0
  28. package/.kiro/agents/prompts/project-manager-system.md +285 -0
  29. package/.kiro/agents/prompts/security-specialist-system.md +231 -0
  30. package/.kiro/agents/prompts/test-orchestrator-system.md +214 -0
  31. package/.kiro/agents/prompts/ui-ux-designer-system.md +270 -0
  32. package/.kiro/agents/security-specialist.json +6 -0
  33. package/.kiro/agents/security-specialist.md +277 -0
  34. package/.kiro/agents/test-orchestrator.json +6 -0
  35. package/.kiro/agents/test-orchestrator.md +266 -0
  36. package/.kiro/agents/ui-ux-designer.json +6 -0
  37. package/.kiro/agents/ui-ux-designer.md +284 -0
  38. package/.kiro/devlog/00-START-HERE.md +444 -0
  39. package/.kiro/devlog/COMPLETE-WORKFLOW.md +553 -0
  40. package/.kiro/devlog/DEVLOG-INTEGRATION.md +413 -0
  41. package/.kiro/devlog/DEVLOG-PROCESS-FLOWS.md +484 -0
  42. package/.kiro/devlog/DEVLOG-QUICK-REF.md +299 -0
  43. package/.kiro/devlog/DEVLOG.md +22 -0
  44. package/.kiro/devlog/IMPLEMENTATION-COMPLETE.txt +434 -0
  45. package/.kiro/devlog/IMPLEMENTATION-SUMMARY.md +358 -0
  46. package/.kiro/devlog/README.md +363 -0
  47. package/.kiro/devlog/devlog-update.bat +136 -0
  48. package/.kiro/devlog/devlog-update.sh +275 -0
  49. package/.kiro/devlog/feature-completion-hook.bat +78 -0
  50. package/.kiro/devlog/feature-completion-hook.sh +84 -0
  51. package/.kiro/documentation/cli.md +31 -0
  52. package/.kiro/documentation/docs_cli.md +41 -0
  53. package/.kiro/documentation/docs_cli_authentication.md +43 -0
  54. package/.kiro/documentation/docs_cli_autocomplete.md +132 -0
  55. package/.kiro/documentation/docs_cli_billing.md +31 -0
  56. package/.kiro/documentation/docs_cli_billing_contact-support.md +43 -0
  57. package/.kiro/documentation/docs_cli_billing_managing-taxes.md +67 -0
  58. package/.kiro/documentation/docs_cli_billing_related-questions.md +49 -0
  59. package/.kiro/documentation/docs_cli_billing_subscription-portal.md +31 -0
  60. package/.kiro/documentation/docs_cli_chat.md +84 -0
  61. package/.kiro/documentation/docs_cli_chat_configuration.md +40 -0
  62. package/.kiro/documentation/docs_cli_chat_context.md +258 -0
  63. package/.kiro/documentation/docs_cli_chat_git-aware-selection.md +41 -0
  64. package/.kiro/documentation/docs_cli_chat_images.md +53 -0
  65. package/.kiro/documentation/docs_cli_chat_manage-prompts.md +216 -0
  66. package/.kiro/documentation/docs_cli_chat_model-selection.md +153 -0
  67. package/.kiro/documentation/docs_cli_chat_permissions.md +68 -0
  68. package/.kiro/documentation/docs_cli_chat_planning-agent.md +230 -0
  69. package/.kiro/documentation/docs_cli_chat_responding.md +123 -0
  70. package/.kiro/documentation/docs_cli_chat_security.md +87 -0
  71. package/.kiro/documentation/docs_cli_chat_subagents.md +77 -0
  72. package/.kiro/documentation/docs_cli_code-intelligence.md +251 -0
  73. package/.kiro/documentation/docs_cli_custom-agents.md +37 -0
  74. package/.kiro/documentation/docs_cli_custom-agents_configuration-reference.md +941 -0
  75. package/.kiro/documentation/docs_cli_custom-agents_creating.md +93 -0
  76. package/.kiro/documentation/docs_cli_custom-agents_examples.md +360 -0
  77. package/.kiro/documentation/docs_cli_custom-agents_troubleshooting.md +180 -0
  78. package/.kiro/documentation/docs_cli_enterprise_billing.md +33 -0
  79. package/.kiro/documentation/docs_cli_enterprise_concepts.md +34 -0
  80. package/.kiro/documentation/docs_cli_enterprise_getting-started.md +19 -0
  81. package/.kiro/documentation/docs_cli_enterprise_iam.md +251 -0
  82. package/.kiro/documentation/docs_cli_enterprise_monitor-and-track.md +15 -0
  83. package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_dashboard.md +62 -0
  84. package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_prompt-logging.md +165 -0
  85. package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_user-activity.md +123 -0
  86. package/.kiro/documentation/docs_cli_enterprise_settings.md +15 -0
  87. package/.kiro/documentation/docs_cli_enterprise_subscribe.md +36 -0
  88. package/.kiro/documentation/docs_cli_enterprise_subscription-management.md +55 -0
  89. package/.kiro/documentation/docs_cli_enterprise_supported-regions.md +39 -0
  90. package/.kiro/documentation/docs_cli_experimental.md +282 -0
  91. package/.kiro/documentation/docs_cli_experimental_checkpointing.md +439 -0
  92. package/.kiro/documentation/docs_cli_experimental_delegate.md +422 -0
  93. package/.kiro/documentation/docs_cli_experimental_knowledge-management.md +449 -0
  94. package/.kiro/documentation/docs_cli_experimental_tangent-mode.md +357 -0
  95. package/.kiro/documentation/docs_cli_experimental_thinking.md +331 -0
  96. package/.kiro/documentation/docs_cli_experimental_todo-lists.md +385 -0
  97. package/.kiro/documentation/docs_cli_hooks.md +207 -0
  98. package/.kiro/documentation/docs_cli_installation.md +235 -0
  99. package/.kiro/documentation/docs_cli_mcp.md +106 -0
  100. package/.kiro/documentation/docs_cli_mcp_configuration.md +294 -0
  101. package/.kiro/documentation/docs_cli_mcp_examples.md +273 -0
  102. package/.kiro/documentation/docs_cli_mcp_governance.md +436 -0
  103. package/.kiro/documentation/docs_cli_mcp_security.md +77 -0
  104. package/.kiro/documentation/docs_cli_migrating-from-q.md +129 -0
  105. package/.kiro/documentation/docs_cli_privacy-and-security.md +83 -0
  106. package/.kiro/documentation/docs_cli_privacy-and-security_compliance-validation.md +17 -0
  107. package/.kiro/documentation/docs_cli_privacy-and-security_data-protection.md +104 -0
  108. package/.kiro/documentation/docs_cli_privacy-and-security_firewalls.md +26 -0
  109. package/.kiro/documentation/docs_cli_privacy-and-security_infrastructure-security.md +10 -0
  110. package/.kiro/documentation/docs_cli_privacy-and-security_vpc-endpoints.md +41 -0
  111. package/.kiro/documentation/docs_cli_reference_built-in-tools.md +624 -0
  112. package/.kiro/documentation/docs_cli_reference_cli-commands.md +689 -0
  113. package/.kiro/documentation/docs_cli_reference_settings.md +294 -0
  114. package/.kiro/documentation/docs_cli_reference_slash-commands.md +559 -0
  115. package/.kiro/documentation/docs_cli_steering.md +84 -0
  116. package/.kiro/guides/AGENT_WORKFLOW_GUIDE.md +294 -0
  117. package/.kiro/guides/DEVLOG.md +882 -0
  118. package/.kiro/guides/IMPLEMENTATION_EXAMPLES.md +611 -0
  119. package/.kiro/guides/PIV Loop.md +122 -0
  120. package/.kiro/guides/PIV Loop.png +0 -0
  121. package/.kiro/guides/PIVLoop.png +0 -0
  122. package/.kiro/guides/QUICK_REFERENCE.md +202 -0
  123. package/.kiro/guides/README.md +149 -0
  124. package/.kiro/guides/advanced-patterns.md +514 -0
  125. package/.kiro/guides/agent-coordination.md +434 -0
  126. package/.kiro/guides/core-workflows.md +409 -0
  127. package/.kiro/guides/emergency-procedures.md +414 -0
  128. package/.kiro/guides/project-evaluation.md +534 -0
  129. package/.kiro/guides/quality-assurance.md +431 -0
  130. package/.kiro/guides/quick-start.md +235 -0
  131. package/.kiro/guides/troubleshooting.md +575 -0
  132. package/.kiro/guides/walkthroughs.md +711 -0
  133. package/.kiro/prompts/add-to-devlog.md +263 -0
  134. package/.kiro/prompts/code-review-fix.md +18 -0
  135. package/.kiro/prompts/code-review-hackathon.md +167 -0
  136. package/.kiro/prompts/code-review-security.md +454 -0
  137. package/.kiro/prompts/code-review.md +113 -0
  138. package/.kiro/prompts/create-prd.md +151 -0
  139. package/.kiro/prompts/execute-backend.md +257 -0
  140. package/.kiro/prompts/execute-frontend.md +438 -0
  141. package/.kiro/prompts/execute-logging.md +491 -0
  142. package/.kiro/prompts/execute-security.md +482 -0
  143. package/.kiro/prompts/execute-testing.md +528 -0
  144. package/.kiro/prompts/execute.md +101 -0
  145. package/.kiro/prompts/execution-report.md +72 -0
  146. package/.kiro/prompts/implement-fix.md +228 -0
  147. package/.kiro/prompts/plan-feature.md +433 -0
  148. package/.kiro/prompts/prime.md +73 -0
  149. package/.kiro/prompts/quality-metrics.md +622 -0
  150. package/.kiro/prompts/quickstart.md +318 -0
  151. package/.kiro/prompts/rca.md +220 -0
  152. package/.kiro/prompts/system-review.md +189 -0
  153. package/README.md +32 -0
  154. package/bin/cli.js +97 -0
  155. package/package.json +33 -0
@@ -0,0 +1,235 @@
1
+ # Installation
2
+ ## macOS[](https://kiro.dev/docs/cli/installation/#macos)
3
+ You can natively install Kiro CLI for macOS at the command line.
4
+ `curl -fsSL https://cli.kiro.dev/install | bash`
5
+ Kiro will direct you to open your web browser, where you will follow the steps under [Authentication](https://kiro.dev/docs/cli/authentication).
6
+ ## Linux AppImage[](https://kiro.dev/docs/cli/installation/#linux-appimage)
7
+ You can install Kiro CLI for Linux using the AppImage format, which is a portable format that works on most Linux distributions without requiring installation.
8
+ To install Kiro CLI for Linux using AppImage, complete the following procedure.
9
+ 1. Download Kiro CLI for Linux AppImage:
10
+
11
+
12
+ `https://desktop-release.q.us-east-1.amazonaws.com/latest/kiro-cli.appimage`
13
+ 1. Make the AppImage executable:
14
+ bash
15
+ ```
16
+
17
+ chmod +x kiro-cli.appimage
18
+
19
+
20
+ ```
21
+
22
+ 2. Run the AppImage:
23
+ bash
24
+ ```
25
+
26
+ ./kiro-cli.appimage
27
+
28
+
29
+ ```
30
+
31
+ 3. Kiro will direct you to open your web browser, where you will follow the steps under [Authentication](https://kiro.dev/docs/cli/authentication).
32
+
33
+
34
+ ## With a zip file[](https://kiro.dev/docs/cli/installation/#with-a-zip-file)
35
+ The setup for Linux integration with the Kiro CLI requires installing the appropriate file for your system, verifying the file, and installing the program.
36
+ ### Install and update requirements[](https://kiro.dev/docs/cli/installation/#install-and-update-requirements)
37
+ * You must be able to extract or "unzip" the downloaded package. If your operating system doesn't have the built-in unzip command, use an equivalent.
38
+ * Kiro for command line requires glibc 2.34 or newer, which is included by default in most major Linux distributions released since 2021.
39
+ * For older distributions with glibc versions earlier than 2.34, use the special musl-based version (indicated by `-musl.zip` in the filename).
40
+ * Kiro for command line is supported on 64-bit x86_64 and ARM aarch64 versions of recent distributions of Fedora, Ubuntu, and Amazon Linux 2023.
41
+
42
+
43
+ ### Checking your glibc version[](https://kiro.dev/docs/cli/installation/#checking-your-glibc-version)
44
+ To determine which version you need, check your glibc version:
45
+ ```
46
+
47
+ ldd --version
48
+
49
+
50
+ ```
51
+
52
+ If the version is 2.34 or newer, use the standard version. If it's older, use the musl version.
53
+ ### To download the installation file[](https://kiro.dev/docs/cli/installation/#to-download-the-installation-file)
54
+ Choose the appropriate download command based on your system architecture and glibc version:
55
+ #### Standard version (glibc 2.34+)[](https://kiro.dev/docs/cli/installation/#standard-version-glibc-234)
56
+ ##### Linux x86-64[](https://kiro.dev/docs/cli/installation/#linux-x86-64)
57
+ `curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-x86_64-linux.zip' -o 'kirocli.zip'`
58
+ ##### Linux ARM (aarch64)[](https://kiro.dev/docs/cli/installation/#linux-arm-aarch64)
59
+ `curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-aarch64-linux.zip' -o 'kirocli.zip'`
60
+ #### Musl version (for glibc < 2.34)[](https://kiro.dev/docs/cli/installation/#musl-version-for-glibc--234)
61
+ ##### Linux x86-64 with musl[](https://kiro.dev/docs/cli/installation/#linux-x86-64-with-musl)
62
+ `curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-x86_64-linux-musl.zip' -o 'kirocli.zip'`
63
+ ##### Linux ARM (aarch64) with musl[](https://kiro.dev/docs/cli/installation/#linux-arm-aarch64-with-musl)
64
+ `curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-aarch64-linux-musl.zip' -o 'kirocli.zip'`
65
+ ### To install Kiro CLI[](https://kiro.dev/docs/cli/installation/#to-install-kiro-cli)
66
+ 1. Unzip the installer:
67
+ ```
68
+
69
+ unzip kirocli.zip
70
+
71
+
72
+ ```
73
+
74
+ 2. Run the install program:
75
+ ```
76
+
77
+ ./kirocli/install.sh
78
+
79
+
80
+ ```
81
+
82
+ By default, the files are installed to `~/.local/bin`.
83
+
84
+
85
+ ## Ubuntu[](https://kiro.dev/docs/cli/installation/#ubuntu)
86
+ You can install Kiro CLI for Ubuntu using the .deb package.
87
+ To install Kiro CLI for Ubuntu, complete the following procedure.
88
+ 1. Download Kiro CLI for Ubuntu.
89
+
90
+
91
+ `wget https://desktop-release.q.us-east-1.amazonaws.com/latest/kiro-cli.deb`
92
+ 1. Install the package:
93
+ bash
94
+ ```
95
+
96
+ sudo dpkg -i kiro-cli.deb
97
+ sudo apt-get install -f
98
+
99
+
100
+ ```
101
+
102
+ 2. Launch Kiro CLI:
103
+ bash
104
+ ```
105
+
106
+ kiro-cli
107
+
108
+
109
+ ```
110
+
111
+ 3. Kiro will direct you to open your web browser, where you will follow the steps under [Authentication](https://kiro.dev/docs/cli/authentication).
112
+
113
+
114
+ ## Proxy configuration[](https://kiro.dev/docs/cli/installation/#proxy-configuration)
115
+ Kiro CLI (v1.8.0 and later) supports proxy servers commonly used in enterprise environments. The CLI automatically respects standard proxy environment variables.
116
+ ### Setting proxy environment variables[](https://kiro.dev/docs/cli/installation/#setting-proxy-environment-variables)
117
+ Configure proxy settings by setting these environment variables in your shell:
118
+ bash
119
+ ```
120
+
121
+ # HTTP proxy for non-SSL traffic
122
+ export HTTP_PROXY=http://proxy.company.com:8080
123
+
124
+ # HTTPS proxy for SSL traffic
125
+ export HTTPS_PROXY=http://proxy.company.com:8080
126
+
127
+ # Bypass proxy for specific domains
128
+ export NO_PROXY=localhost,127.0.0.1,.company.com
129
+
130
+
131
+ ```
132
+
133
+ ### Proxy with authentication[](https://kiro.dev/docs/cli/installation/#proxy-with-authentication)
134
+ For proxies requiring authentication:
135
+ bash
136
+ ```
137
+
138
+ export HTTP_PROXY=http://username:password@proxy.company.com:8080
139
+ export HTTPS_PROXY=http://username:password@proxy.company.com:8080
140
+
141
+
142
+ ```
143
+
144
+ ### Troubleshooting proxy issues[](https://kiro.dev/docs/cli/installation/#troubleshooting-proxy-issues)
145
+ If you encounter proxy-related connection issues:
146
+ * Verify proxy server accessibility and credentials
147
+ * Ensure your corporate firewall allows connections to AWS endpoints
148
+ * Contact your IT administrator if SSL certificate validation fails
149
+ * Check that the proxy server supports the required protocols
150
+
151
+
152
+ ## Uninstalling Kiro CLI[](https://kiro.dev/docs/cli/installation/#uninstalling-kiro-cli)
153
+ You can uninstall Kiro CLI if you no longer need it.
154
+ To uninstall Kiro CLI on macOS, run:
155
+ bash
156
+ ```
157
+
158
+ kiro-cli uninstall
159
+
160
+
161
+ ```
162
+
163
+ To uninstall Kiro CLI on Ubuntu, complete the following procedure.
164
+ 1. Use the apt package manager to remove the package:
165
+ bash
166
+ ```
167
+
168
+ sudo apt-get remove kiro-cli
169
+
170
+
171
+ ```
172
+
173
+ 2. Remove any remaining configuration files:
174
+ bash
175
+ ```
176
+
177
+ sudo apt-get purge kiro-cli
178
+
179
+
180
+ ```
181
+
182
+
183
+
184
+ ## Debugging Kiro CLI[](https://kiro.dev/docs/cli/installation/#debugging-kiro-cli)
185
+ If you're having a problem with Kiro CLI, run `kiro-cli doctor` to identify and fix common issues.
186
+ ### Expected output[](https://kiro.dev/docs/cli/installation/#expected-output)
187
+ bash
188
+ ```
189
+
190
+ $ kiro-cli doctor
191
+
192
+ ✔ Everything looks good!
193
+
194
+ Kiro CLI still not working? Run kiro-cli issue to let us know!
195
+
196
+
197
+ ```
198
+
199
+ If your output doesn't look like the expected output, follow the prompts to resolve your issue. If it's still not working, use `kiro-cli issue` to report the bug.
200
+ ### Common issues[](https://kiro.dev/docs/cli/installation/#common-issues)
201
+ Here are some common issues you might encounter when using Kiro CLI:
202
+ Authentication failures : If you're having trouble authenticating, try running `kiro-cli login` to re-authenticate.
203
+ Autocomplete not working : Ensure your shell integration is properly installed by running `kiro-cli doctor`.
204
+ SSH integration issues : Verify that your SSH server is properly configured to accept the required environment variables.
205
+ ### Troubleshooting steps[](https://kiro.dev/docs/cli/installation/#troubleshooting-steps)
206
+ Follow these steps to troubleshoot issues with Kiro CLI:
207
+ 1. Run `kiro-cli doctor` to identify and fix common issues.
208
+ 2. Check your internet connection.
209
+ 3. Verify that you're using a supported environment. For more information, see [Supported command line environments](https://kiro.dev/docs/cli/reference/supported-environments).
210
+ 4. Try reinstalling Kiro CLI.
211
+ 5. If the issue persists, report it using `kiro-cli issue`.
212
+
213
+
214
+ Page updated: November 18, 2025
215
+ [Authentication](https://kiro.dev/docs/cli/authentication/)
216
+ On this page
217
+ * [macOS](https://kiro.dev/docs/cli/installation/#macos)
218
+ * [Linux AppImage](https://kiro.dev/docs/cli/installation/#linux-appimage)
219
+ * [With a zip file](https://kiro.dev/docs/cli/installation/#with-a-zip-file)
220
+ * [Install and update requirements](https://kiro.dev/docs/cli/installation/#install-and-update-requirements)
221
+ * [Checking your glibc version](https://kiro.dev/docs/cli/installation/#checking-your-glibc-version)
222
+ * [To download the installation file](https://kiro.dev/docs/cli/installation/#to-download-the-installation-file)
223
+ * [Standard version (glibc 2.34+)](https://kiro.dev/docs/cli/installation/#standard-version-glibc-234)
224
+ * [Musl version (for glibc < 2.34)](https://kiro.dev/docs/cli/installation/#musl-version-for-glibc--234)
225
+ * [To install Kiro CLI](https://kiro.dev/docs/cli/installation/#to-install-kiro-cli)
226
+ * [Ubuntu](https://kiro.dev/docs/cli/installation/#ubuntu)
227
+ * [Proxy configuration](https://kiro.dev/docs/cli/installation/#proxy-configuration)
228
+ * [Setting proxy environment variables](https://kiro.dev/docs/cli/installation/#setting-proxy-environment-variables)
229
+ * [Proxy with authentication](https://kiro.dev/docs/cli/installation/#proxy-with-authentication)
230
+ * [Troubleshooting proxy issues](https://kiro.dev/docs/cli/installation/#troubleshooting-proxy-issues)
231
+ * [Uninstalling Kiro CLI](https://kiro.dev/docs/cli/installation/#uninstalling-kiro-cli)
232
+ * [Debugging Kiro CLI](https://kiro.dev/docs/cli/installation/#debugging-kiro-cli)
233
+ * [Expected output](https://kiro.dev/docs/cli/installation/#expected-output)
234
+ * [Common issues](https://kiro.dev/docs/cli/installation/#common-issues)
235
+ * [Troubleshooting steps](https://kiro.dev/docs/cli/installation/#troubleshooting-steps)
@@ -0,0 +1,106 @@
1
+ # Model Context Protocol (MCP)
2
+ Model Context Protocol (MCP) extends Kiro's capabilities by connecting to specialized servers that provide additional tools and context. This guide helps you set up, configure, and use MCP servers with Kiro CLI.
3
+ **Tip**
4
+ Within an interactive chat session, you can use the `/mcp` slash command to see which MCP servers are currently loaded. See [Slash Commands](https://kiro.dev/docs/cli/reference/slash-commands) for more details.
5
+ ## What is MCP?[](https://kiro.dev/docs/cli/mcp/#what-is-mcp)
6
+ MCP is a protocol that allows Kiro to communicate with external servers to access specialized tools and information. For example, the AWS Documentation MCP server provides tools to search, read, and get recommendations from AWS documentation directly within Kiro.
7
+ With MCP, you can:
8
+ * Access specialized knowledge bases and documentation
9
+ * Integrate with external services and APIs
10
+ * Extend Kiro's capabilities with domain-specific tools
11
+ * Create custom tools for your specific workflows
12
+
13
+
14
+ ## Setting up MCP[](https://kiro.dev/docs/cli/mcp/#setting-up-mcp)
15
+ Before using MCP, make sure you have any specific prerequisites for the MCP servers you want to use (listed in each server's documentation)
16
+ There are two ways of configuring MCP servers in Kiro CLI:
17
+ ### Command line[](https://kiro.dev/docs/cli/mcp/#command-line)
18
+ bash
19
+ ```
20
+
21
+ # Add new MCP server
22
+ kiro-cli mcp add \
23
+ --name "awslabs.aws-documentation-mcp-server" \
24
+ --scope global \
25
+ --command "uvx" \
26
+ --args "awslabs.aws-documentation-mcp-server@latest" \
27
+ --env "FASTMCP_LOG_LEVEL=ERROR" \
28
+ --env "AWS_DOCUMENTATION_PARTITION=aws"
29
+
30
+
31
+ ```
32
+
33
+ ### mcp.json file[](https://kiro.dev/docs/cli/mcp/#mcpjson-file)
34
+ MCP servers can be loaded from the MCP configuration file in your workspace (`<project-root>/.kiro/settings/mcp.json`) or from user level settings (`~/.kiro/settings/mcp.json`)
35
+ json
36
+ ```
37
+
38
+ {
39
+ "mcpServers": {
40
+ "local-server-name": {
41
+ "command": "command-to-run-server",
42
+ "args": ["arg1", "arg2"],
43
+ "env": {
44
+ "ENV_VAR1": "value1",
45
+ "ENV_VAR2": "value2"
46
+ },
47
+ "disabled": false
48
+ }
49
+ }
50
+ }
51
+
52
+
53
+ ```
54
+
55
+ ### Agent configuration[](https://kiro.dev/docs/cli/mcp/#agent-configuration)
56
+ The `mcpServers` field specifies which MCP servers the agent has access to. Each server is defined with a command and optional arguments.
57
+ json
58
+ ```
59
+
60
+ {
61
+ "name": "myagent",
62
+ "description": "My special agent",
63
+ "mcpServers": {
64
+ "fetch": {
65
+ "command": "fetch3.1",
66
+ "args": []
67
+ }
68
+ },
69
+ "includeMcpJson": false
70
+ }
71
+
72
+
73
+ ```
74
+
75
+ The `includeMcpJson` field determines whether to include MCP servers defined in the workspace and user level MCP configuration files. When set to `true`, the agent will have access to all MCP servers defined in the user and workspace level configurations in addition to those defined in the agent's `mcpServers` field.
76
+ ## Troubleshooting[](https://kiro.dev/docs/cli/mcp/#troubleshooting)
77
+ ### Common issues and solutions[](https://kiro.dev/docs/cli/mcp/#common-issues-and-solutions)
78
+ Issue | Solution
79
+ ---|---
80
+ Connection failures | Verify prerequisites are installed correctly
81
+ Permission errors | Check that tokens and API keys are valid
82
+ Tool not responding | Review MCP logs for specific error messages
83
+ Configuration not loading | Validate JSON syntax and save the config file
84
+ ## Additional resources[](https://kiro.dev/docs/cli/mcp/#additional-resources)
85
+ * [Official MCP Documentation](https://modelcontextprotocol.io/introduction)
86
+
87
+
88
+ ## Next steps[](https://kiro.dev/docs/cli/mcp/#next-steps)
89
+ Now that you understand MCP basics, explore these resources:
90
+ * **[Examples](https://kiro.dev/docs/cli/mcp/examples/)** - Practical examples of using MCP servers with Kiro CLI
91
+ * **[Security Best Practices](https://kiro.dev/docs/cli/mcp/security/)** - Best practices for secure MCP usage
92
+
93
+
94
+ Page updated: December 9, 2025
95
+ [Troubleshooting](https://kiro.dev/docs/cli/custom-agents/troubleshooting/)
96
+ [Configuration](https://kiro.dev/docs/cli/mcp/configuration/)
97
+ On this page
98
+ * [What is MCP?](https://kiro.dev/docs/cli/mcp/#what-is-mcp)
99
+ * [Setting up MCP](https://kiro.dev/docs/cli/mcp/#setting-up-mcp)
100
+ * [Command line](https://kiro.dev/docs/cli/mcp/#command-line)
101
+ * [mcp.json file](https://kiro.dev/docs/cli/mcp/#mcpjson-file)
102
+ * [Agent configuration](https://kiro.dev/docs/cli/mcp/#agent-configuration)
103
+ * [Troubleshooting](https://kiro.dev/docs/cli/mcp/#troubleshooting)
104
+ * [Common issues and solutions](https://kiro.dev/docs/cli/mcp/#common-issues-and-solutions)
105
+ * [Additional resources](https://kiro.dev/docs/cli/mcp/#additional-resources)
106
+ * [Next steps](https://kiro.dev/docs/cli/mcp/#next-steps)
@@ -0,0 +1,294 @@
1
+ # Configuration
2
+ This guide provides detailed information on configuring Model Context Protocol (MCP) servers with Kiro CLI, including configuration file structure, server setup, and management.
3
+ ## Configuration file structure[](https://kiro.dev/docs/cli/mcp/configuration/#configuration-file-structure)
4
+ MCP configuration files use JSON format with the following structure:
5
+ json
6
+ ```
7
+
8
+ {
9
+ "mcpServers": {
10
+ "local-server-name": {
11
+ "command": "command-to-run-server",
12
+ "args": ["arg1", "arg2"],
13
+ "env": {
14
+ "ENV_VAR1": "hard-coded-variable",
15
+ "ENV_VAR2": "${EXPANDED_VARIABLE}"
16
+ },
17
+ "disabled": false,
18
+ "disabledTools": ["tool_name3"]
19
+ },
20
+ "remote-server-name": {
21
+ "url": "https://endpoint.to.connect.to",
22
+ "headers": {
23
+ "HEADER1": "value1",
24
+ "HEADER2": "value2"
25
+ },
26
+ "disabled": false,
27
+ "disabledTools": ["tool_name3"]
28
+ }
29
+ }
30
+ }
31
+
32
+
33
+ ```
34
+
35
+ ### Configuration properties[](https://kiro.dev/docs/cli/mcp/configuration/#configuration-properties)
36
+ #### Local server[](https://kiro.dev/docs/cli/mcp/configuration/#local-server)
37
+ Property | Type | Required | Description
38
+ ---|---|---|---
39
+ `command` | String | Yes | The command to run the MCP server
40
+ `args` | Array | Yes | Arguments to pass to the command
41
+ `env` | Object | No | Environment variables for the server process
42
+ `disabled` | Boolean | No | Whether the server is disabled (default: false)
43
+ `autoApprove` | Array | No | Tool names to auto-approve without prompting
44
+ `disabledTools` | Array | No | Tool names to omit when calling the Agent
45
+ #### Remote server[](https://kiro.dev/docs/cli/mcp/configuration/#remote-server)
46
+ Property | Type | Required | Description
47
+ ---|---|---|---
48
+ `url` | String | Yes | HTTPS endpoint for the remote MCP server (or HTTP endpoint for localhost)
49
+ `headers` | Object | No | Headers to pass to the MCP server during connection
50
+ `env` | Object | No | Environment variables for the server process
51
+ `disabled` | Boolean | No | Whether the server is disabled (default: false)
52
+ `autoApprove` | Array | No | Tool names to auto-approve without prompting
53
+ `disabledTools` | Array | No | Tool names to omit when calling the Agent
54
+ ## Example configurations[](https://kiro.dev/docs/cli/mcp/configuration/#example-configurations)
55
+ ### Local server with environment variables[](https://kiro.dev/docs/cli/mcp/configuration/#local-server-with-environment-variables)
56
+ json
57
+ ```
58
+
59
+ {
60
+ "mcpServers": {
61
+ "web-search": {
62
+ "command": "npx",
63
+ "args": [
64
+ "-y",
65
+ "@modelcontextprotocol/server-bravesearch"
66
+ ],
67
+ "env": {
68
+ "BRAVE_API_KEY": "${BRAVE_API_KEY}"
69
+ }
70
+ }
71
+ }
72
+ }
73
+
74
+
75
+ ```
76
+
77
+ ### Remote server with headers[](https://kiro.dev/docs/cli/mcp/configuration/#remote-server-with-headers)
78
+ json
79
+ ```
80
+
81
+ {
82
+ "mcpServers": {
83
+ "api-server": {
84
+ "url": "https://api.example.com/mcp",
85
+ "headers": {
86
+ "Authorization": "Bearer ${API_TOKEN}",
87
+ "X-Custom-Header": "value"
88
+ }
89
+ }
90
+ }
91
+ }
92
+
93
+
94
+ ```
95
+
96
+ ### Multiple servers[](https://kiro.dev/docs/cli/mcp/configuration/#multiple-servers)
97
+ json
98
+ ```
99
+
100
+ {
101
+ "mcpServers": {
102
+ "fetch": {
103
+ "command": "uvx",
104
+ "args": ["mcp-server-fetch"]
105
+ },
106
+ "git": {
107
+ "command": "uvx",
108
+ "args": ["mcp-server-git"],
109
+ "env": {
110
+ "GIT_CONFIG_GLOBAL": "/dev/null"
111
+ }
112
+ },
113
+ "aws-docs": {
114
+ "command": "npx",
115
+ "args": ["-y", "@aws/aws-documentation-mcp-server"]
116
+ }
117
+ }
118
+ }
119
+
120
+
121
+ ```
122
+
123
+ ## MCP server loading priority[](https://kiro.dev/docs/cli/mcp/configuration/#mcp-server-loading-priority)
124
+ When multiple configurations define the same MCP server, they are loaded based on this hierarchy (highest to lowest priority):
125
+ 1. **Agent Config** - `mcpServers` field in agent JSON
126
+ 2. **Workspace MCP JSON** - `.kiro/settings/mcp.json`
127
+ 3. **Global MCP JSON** - `~/.kiro/settings/mcp.json`
128
+
129
+
130
+ ### Example scenarios[](https://kiro.dev/docs/cli/mcp/configuration/#example-scenarios)
131
+ **Complete override:**
132
+ ```
133
+
134
+ Agent config: { "fetch": { command: "fetch-v2" } }
135
+ Workspace config: { "fetch": { command: "fetch-v1" } }
136
+ Global config: { "fetch": { command: "fetch-old" } }
137
+
138
+ Result: Only "fetch-v2" from agent config is used
139
+
140
+
141
+ ```
142
+
143
+ **Additive (different names):**
144
+ ```
145
+
146
+ Agent config: { "fetch": {...} }
147
+ Workspace config: { "git": {...} }
148
+ Global config: { "aws": {...} }
149
+
150
+ Result: All three servers are used (fetch, git, aws)
151
+
152
+
153
+ ```
154
+
155
+ **Disable via override:**
156
+ ```
157
+
158
+ Agent config: { "fetch": { command: "...", disabled: true } }
159
+ Workspace config: { "fetch": { command: "..." } }
160
+
161
+ Result: No fetch server is launched
162
+
163
+
164
+ ```
165
+
166
+ ## Environment variables[](https://kiro.dev/docs/cli/mcp/configuration/#environment-variables)
167
+ Many MCP servers require environment variables for authentication or configuration. Use the `${VARIABLE_NAME}` syntax to reference environment variables:
168
+ json
169
+ ```
170
+
171
+ {
172
+ "mcpServers": {
173
+ "server-name": {
174
+ "env": {
175
+ "API_KEY": "${YOUR_API_KEY}",
176
+ "DEBUG": "true",
177
+ "TIMEOUT": "30000"
178
+ }
179
+ }
180
+ }
181
+ }
182
+
183
+
184
+ ```
185
+
186
+ Make sure to set these environment variables in your shell before running Kiro CLI:
187
+ bash
188
+ ```
189
+
190
+ export YOUR_API_KEY="your-actual-key"
191
+ export DEBUG="true"
192
+
193
+
194
+ ```
195
+
196
+ ## Disabling servers[](https://kiro.dev/docs/cli/mcp/configuration/#disabling-servers)
197
+ To temporarily disable an MCP server without removing its configuration:
198
+ json
199
+ ```
200
+
201
+ {
202
+ "mcpServers": {
203
+ "server-name": {
204
+ "disabled": true
205
+ }
206
+ }
207
+ }
208
+
209
+
210
+ ```
211
+
212
+ ## Disabling specific tools[](https://kiro.dev/docs/cli/mcp/configuration/#disabling-specific-tools)
213
+ To prevent an agent from using specific tools from an MCP server:
214
+ json
215
+ ```
216
+
217
+ {
218
+ "mcpServers": {
219
+ "server-name": {
220
+ "disabledTools": ["delete_file", "execute_command"]
221
+ }
222
+ }
223
+ }
224
+
225
+
226
+ ```
227
+
228
+ ## Viewing loaded servers[](https://kiro.dev/docs/cli/mcp/configuration/#viewing-loaded-servers)
229
+ To see which MCP servers are currently loaded in an interactive chat session:
230
+ bash
231
+ ```
232
+
233
+ /mcp
234
+
235
+
236
+ ```
237
+
238
+ This displays all active MCP servers and their available tools.
239
+ ## Troubleshooting configuration[](https://kiro.dev/docs/cli/mcp/configuration/#troubleshooting-configuration)
240
+ 1. **Validate JSON syntax**
241
+ * Ensure your JSON is valid with no syntax errors:
242
+ * Check for missing commas, quotes, or brackets
243
+ * Use a JSON validator or linter
244
+ 2. **Verify command paths**
245
+ * Make sure the command specified exists in your PATH
246
+ * Try running the command directly in your terminal
247
+ 3. **Check environment variables**
248
+ * Verify that all required environment variables are set
249
+ * Check for typos in environment variable names
250
+ 4. **Review configuration loading**
251
+ * Check which configuration files are being loaded and their priority:
252
+ bash
253
+ ```
254
+
255
+ # Check workspace config
256
+ cat .kiro/settings/mcp.json
257
+
258
+ # Check user config
259
+ cat ~/.kiro/settings/mcp.json
260
+
261
+
262
+ ```
263
+
264
+
265
+
266
+ ## Security considerations[](https://kiro.dev/docs/cli/mcp/configuration/#security-considerations)
267
+ When configuring MCP servers, follow these security best practices:
268
+ * Use environment variable references (e.g., `${API_TOKEN}`) instead of hardcoding sensitive values
269
+ * Never commit configuration files with credentials to version control
270
+ * Only connect to trusted remote servers
271
+ * Use `disabledTools` to restrict access to dangerous operations
272
+
273
+
274
+ For comprehensive security guidance, see the [MCP Security Best Practices](https://kiro.dev/docs/cli/mcp/security) page.
275
+ Page updated: December 9, 2025
276
+ [MCP](https://kiro.dev/docs/cli/mcp/)
277
+ [Examples](https://kiro.dev/docs/cli/mcp/examples/)
278
+ On this page
279
+ * [Configuration file structure](https://kiro.dev/docs/cli/mcp/configuration/#configuration-file-structure)
280
+ * [Configuration properties](https://kiro.dev/docs/cli/mcp/configuration/#configuration-properties)
281
+ * [Local server](https://kiro.dev/docs/cli/mcp/configuration/#local-server)
282
+ * [Remote server](https://kiro.dev/docs/cli/mcp/configuration/#remote-server)
283
+ * [Example configurations](https://kiro.dev/docs/cli/mcp/configuration/#example-configurations)
284
+ * [Local server with environment variables](https://kiro.dev/docs/cli/mcp/configuration/#local-server-with-environment-variables)
285
+ * [Remote server with headers](https://kiro.dev/docs/cli/mcp/configuration/#remote-server-with-headers)
286
+ * [Multiple servers](https://kiro.dev/docs/cli/mcp/configuration/#multiple-servers)
287
+ * [MCP server loading priority](https://kiro.dev/docs/cli/mcp/configuration/#mcp-server-loading-priority)
288
+ * [Example scenarios](https://kiro.dev/docs/cli/mcp/configuration/#example-scenarios)
289
+ * [Environment variables](https://kiro.dev/docs/cli/mcp/configuration/#environment-variables)
290
+ * [Disabling servers](https://kiro.dev/docs/cli/mcp/configuration/#disabling-servers)
291
+ * [Disabling specific tools](https://kiro.dev/docs/cli/mcp/configuration/#disabling-specific-tools)
292
+ * [Viewing loaded servers](https://kiro.dev/docs/cli/mcp/configuration/#viewing-loaded-servers)
293
+ * [Troubleshooting configuration](https://kiro.dev/docs/cli/mcp/configuration/#troubleshooting-configuration)
294
+ * [Security considerations](https://kiro.dev/docs/cli/mcp/configuration/#security-considerations)