AWS Logo

Guía de Implementación Kiro IDE, CLI y MCP Servers

3
Secciones
11
Pasos MCP
Windows
Sistema Operativo
WSL
Entorno Linux

Sección 1: Kiro IDE

  1. Descargar Kiro IDE dependiendo del sistema operativo en https://kiro.dev/downloads/#latest-ide
  2. Una vez descargado y finalizada la instalación en el sistema, en la primera apertura se debe dar click a 'Skip All' en la ventana inicial.
  3. En el proceso de autenticación de la herramienta, se debe utilizar la opción 'Internal' para hacer el acceso a través de SSO de AWS y después es necesario dar click en el siguiente mensaje que dice habilitar acceso o allow access.

Sección 2: Kiro CLI

  1. Siendo usuario de Windows, es necesario habilitar los permisos de administrador en ACME en el menú de Utilities.
  2. Después de esto, es necesario correr la terminal del sistema, preferiblemente abrir con PowerShell.
  3. El código de instalación es:
    curl -fsSL https://cli.kiro.dev/install | bash
  4. Después de realizada la instalación en Windows mediante la terminal, es necesario cerrar la ventana y volver a abrir una nueva y después escribir kiro-cli. En el momento que ya cargue kiro-cli, va a preguntar si desea hacer login y ahí se selecciona que sí. Después va a abrir una ventana en el navegador web en donde hay que seleccionar la opción de autenticación 'Internal' para hacer el acceso a través de SSO de AWS.

Sección 3: MCP Servers (AWS Sentral y AWS Outlook)

Prerrequisitos: Toolbox, MCP-Registry, NodeJS y los MCP correspondientes.

Paso 1

Instalar WSL

En Windows será necesario instalar WSL mediante el siguiente comando en la terminal:

wsl --install

IMPORTANTE: Después de completarse la primera instalación es necesario reiniciar el computador antes de continuar con el siguiente paso.

Paso 2

Instalar Ubuntu en WSL

Una vez reiniciado el computador, se vuelve a abrir la terminal y hay que instalar la distribución de Ubuntu en Windows con el comando:

wsl.exe --install

Al finalizar la instalación, es necesario cerrar y abrir la terminal nuevamente.

Paso 3

Acceder a WSL

Para acceder a WSL solo es necesario escribir WSL en una terminal:

wsl
Paso 4

Configurar Symlink de Midway

En la terminal de WSL ya abierta, ingresar el siguiente comando:

IMPORTANTE: Es obligatorio reemplazar <mi_usuario_windows> por tu usuario real de Windows. Si no se realiza este cambio, el comando no funcionará y las credenciales de Midway no se sincronizarán con WSL.

Esto permitirá que toda credencial SSH de Midway ingresada en Windows pueda replicarse en la distribución de Ubuntu con WSL.

Paso 5

Ejecutar mwinit

Correr el siguiente comando en la terminal de PowerShell fuera de WSL e ingresar las credenciales correspondientes a Midway:

mwinit -f
Paso 6

Instalar NodeJS

Debe instalarse tanto en Windows como en la distribución de Ubuntu.

PowerShell (Windows)
winget install OpenJS.NodeJS.LTS
Ubuntu (WSL)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash
sudo apt-get install -y nodejs

Verificar en ambos entornos con:

node -v
Paso 7

Instalar Toolbox en WSL

Ejecutar el siguiente comando dentro de WSL:

curl -d '{"os":"ubuntu"}' -H "Authorization: $(curl -b ~/.midway/cookie -c ~/.midway/cookie \"https://midway-auth.amazon.com/SSO?client_id=https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev&response_type=id_token&nonce=$RANDOM&redirect_uri=https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev\")" https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev/v1/bootstrap | bash

Después ejecutar:

source ~/.$(basename "$SHELL")rc
toolbox list
Paso 8

Instalar MCP Registry

toolbox install mcp-registry
Paso 9

Instalar MCP Servers

Salesforce (AWS Sentral)
mcp-registry install aws-sentral-mcp
Outlook
mcp-registry install aws-outlook-mcp
Paso 10

Configurar MCP en Kiro

Después de instalar los dos MCP servers, abrir kiro-cli en PowerShell y dar la siguiente instrucción:

Tengo instalado WSL en el sistema y logré instalar herramientas de Toolbox y MCP Registry para poder instalar dos MCP aws-outlook-mcp y aws-sentral-mcp. Ten presente que los MCP servers corren en WSL pero las credenciales de Midway se generan en Windows con mwinit -f. Para que WSL pueda acceder a esas credenciales, se necesita un symlink que ya está configurado en WSL. Necesito que ambos MCP puedan funcionar en Kiro IDE y Kiro CLI. Ten presente que los MCP utilizan credenciales de Midway que se ejecuta con mwinit -f pero solamente funciona en PowerShell, no en WSL. Ya incluí en WSL el script ln -sf /mnt/c/Users/<mi_usuario_windows>/.midway ~/.midway en donde se reemplazó <mi_usuario_windows> por el usuario real en Windows/Ubuntu para que siempre se sincronicen las credenciales SSH de Midway en WSL.
Paso 11

Habilitar Escritura en Outlook MCP

Es importante aclarar que el MCP de Outlook por defecto no incluye los permisos de escritura para crear borradores de correos o enviar correos. Sin embargo, esto puede habilitarse solicitándoselo a Kiro para que haga la configuración necesaria con solo dar la siguiente instrucción:

Habilita la escritura en el mcp de aws-outlook-mcp para poder tener la posibilidad de crear borradores en outlook y enviar correos
3
Secciones
6
Pasos MCP
macOS
Sistema Operativo
Terminal
Entorno

Sección 1: Kiro IDE

  1. Descargar Kiro IDE dependiendo del sistema operativo en https://kiro.dev/downloads/#latest-ide
  2. Una vez descargado y finalizada la instalación en el sistema, en la primera apertura se debe dar click a 'Skip All' en la ventana inicial.
  3. En el proceso de autenticación de la herramienta, se debe utilizar la opción 'Internal' para hacer el acceso a través de SSO de AWS y después es necesario dar click en el siguiente mensaje que dice habilitar acceso o allow access.

Sección 2: Kiro CLI

  1. Abrir la terminal del sistema.
  2. El código de instalación es:
    curl -fsSL https://cli.kiro.dev/install | bash
  3. Después de realizada la instalación, es necesario cerrar y volver a abrir la ventana del terminal y después escribir kiro-cli. En el momento que ya cargue kiro-cli, va a preguntar si desea hacer login y ahí se selecciona que sí. Después va a abrir una ventana en el navegador web en donde hay que seleccionar la opción de autenticación 'Internal' para hacer el acceso a través de SSO de AWS y después es necesario dar click en el siguiente mensaje que dice habilitar acceso o allow access.

Sección 3: MCP Servers (AWS Sentral y AWS Outlook)

Prerrequisitos: Toolbox, MCP-Registry, NodeJS y los MCP correspondientes.

Paso 1

Ejecutar mwinit

En la terminal será necesario correr el siguiente comando para ingresar las credenciales correspondientes a Midway:

mwinit -f

Es importante tener en cuenta que solicitará ingresar la contraseña y no mostrará lo que se está escribiendo, pero sí estarás escribiendo. Después de darle enter, te va a solicitar que toques la YubiKey que tienes en el computador.

Paso 2

Instalar NodeJS

Ejecutar los siguientes comandos en la terminal:

Descargar e instalar nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

Cargar nvm sin reiniciar la terminal:

\. "$HOME/.nvm/nvm.sh"

Descargar e instalar Node.js:

nvm install 24

Verificar la versión de Node.js:

node -v
Paso 3

Instalar Toolbox

Ejecutar los siguientes comandos en la terminal:

# Download the Builder Toolbox install script: curl -X POST \ --data '{"os":"osx"}' \ -H "Authorization: $(curl -L \ --cookie $HOME/.midway/cookie \ --cookie-jar $HOME/.midway/cookie \ "https://midway-auth.amazon.com/SSO?client_id=https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev&response_type=id_token&nonce=$RANDOM&redirect_uri=https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev:443")" \ https://us-east-1.prod.release-service.toolbox.builder-tools.aws.dev/v1/bootstrap \ > ~/toolbox-bootstrap.sh

Ejecutar el script de instalación:

bash ~/toolbox-bootstrap.sh

Eliminar el script de instalación:

rm ~/toolbox-bootstrap.sh

Agregar toolbox al PATH:

source ~/.$(basename "$SHELL")rc
Paso 4

Instalar MCP Registry

toolbox install mcp-registry
Paso 5

Instalar MCP Servers

Salesforce (AWS Sentral)
mcp-registry install aws-sentral-mcp
Outlook
mcp-registry install aws-outlook-mcp
Paso 6

Configurar y Validar MCP en Kiro

Después de instalar los dos MCP servers, abrir kiro-cli en la terminal y solicitar al agente que pueda realizar las pruebas necesarias de ambos MCP servers instalados y que, si es necesario, haga cualquier modificación que se requiera para su funcionamiento.

Es importante aclarar que el MCP de Outlook por defecto no incluye los permisos de escritura para crear borradores de correos o enviar correos. Sin embargo, esto puede habilitarse solicitándoselo a Kiro con la siguiente instrucción:

Habilita la escritura en el mcp de aws-outlook-mcp para poder tener la posibilidad de crear borradores en outlook y enviar correos