AWS Security ChangesHomeSearch

AWS cloudshell: Add AWS MCP Server setup for Kiro CLI in CloudShell

Service: cloudshell · 2026-10-20 · Documentation medium

File: cloudshell/latest/userguide/q-cli-features-in-cloudshell.md · Type: credentials

Summary

Adds a section describing how to configure the aws-mcp server for Kiro CLI in CloudShell via a downloaded script, noting the server signs requests with CloudShell session credentials and acts with the user's console permissions; also hardens the existing curl command with -fsS and removes the --classic instructions.

Security assessment

The new content documents a tool that operates with the user's CloudShell session credentials and full console permissions, which is security-relevant guidance about credential scope and privilege. The curl change to -fsS also makes the download fail on HTTP errors, a minor hardening of the install path.

Evidence

+You can configure the AWS MCP Server (`aws-mcp`) for Kiro CLI in CloudShell so that Kiro can use AWS tools through the Model Context Protocol (MCP). The server signs its requests with your CloudShell session credentials, so its tools act with the same permissions that you have in the console.

Diff

diff --git a/cloudshell/latest/userguide/q-cli-features-in-cloudshell.md b/cloudshell/latest/userguide/q-cli-features-in-cloudshell.md
index c0ab65c..3b6717c 100644
--- a//cloudshell/latest/userguide/q-cli-features-in-cloudshell.md
+++ b//cloudshell/latest/userguide/q-cli-features-in-cloudshell.md
@@ -7 +7 @@
-Kiro chatSigning in to Kiro CLICLI command completionKiro inline suggestionsLatest Kiro CLI
+Kiro chatSigning in to Kiro CLICLI command completionKiro inline suggestionsConfigure AWS MCPLatest Kiro CLI
@@ -96,0 +97,28 @@ Kiro inline suggestions are supported only in Z shell.
+## Configuring the AWS MCP Server for Kiro CLI in CloudShell
+
+You can configure the AWS MCP Server (`aws-mcp`) for Kiro CLI in CloudShell so that Kiro can use AWS tools through the Model Context Protocol (MCP). The server signs its requests with your CloudShell session credentials, so its tools act with the same permissions that you have in the console.
+
+For more information about the AWS MCP Server, see [AWS MCP Server](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/mcp-server.html) in the _Agent Toolkit for AWS_ documentation.
+
+To configure the server, run the following commands in CloudShell.
+    
+    
+    curl -fsS "https://docs.aws.amazon.com/cloudshell/latest/userguide/samples/kiro-cloudshell-aws-mcp.zip" -o "kiro-cloudshell-aws-mcp.zip"
+    unzip -q -o kiro-cloudshell-aws-mcp.zip
+    chmod +x kiro-cloudshell-aws-mcp.sh
+    ./kiro-cloudshell-aws-mcp.sh
+
+You can also download [kiro-cloudshell-aws-mcp.zip](samples/kiro-cloudshell-aws-mcp.zip) directly.
+
+The script configures only the `aws-mcp` server for Kiro CLI. It doesn't install, update, or launch Kiro CLI, and it works with the pre-installed version. You don't need to sign in to Kiro CLI before you run the script. To verify the configuration, run `kiro-cli`, and then enter `/mcp` to confirm that `aws-mcp` is running.
+
+You can run the script again at any time. It updates only the `aws-mcp` entry in your configuration and leaves any other MCP servers in place. CloudShell keeps a separate home directory in each AWS Region, so run the script one time in each AWS Region where you use Kiro CLI.
+
+###### Note
+
+The script installs `uv` in a virtual environment in your home directory and writes the `aws-mcp` configuration to `~/.kiro/settings/mcp.json`. It keeps the larger `uv` cache and downloaded files in temporary storage to conserve space in your home directory.
+
+When you restart your CloudShell environment, the configuration and virtual environment persist, and the temporary files download again the next time the server starts. When you delete your CloudShell environment, run the script again.
+
+For more information about the script, see `kiro-cloudshell-aws-mcp-README.md` in the zip file.
+
@@ -102 +130 @@ CloudShell includes a pre-installed version of Kiro CLI, which might not be the
-    curl -s "https://docs.aws.amazon.com/cloudshell/latest/userguide/samples/kiro-cloudshell-latest.zip" -o "kiro-cloudshell-latest.zip"
+    curl -fsS "https://docs.aws.amazon.com/cloudshell/latest/userguide/samples/kiro-cloudshell-latest.zip" -o "kiro-cloudshell-latest.zip"
@@ -116,5 +143,0 @@ Update Kiro CLI and then launch it with a list of previous chats to resume.
-Update Kiro CLI and then launch it with the classic interface.
-    
-    
-    ./kiro-cloudshell-latest.sh --classic
-