Dépannage

Cette page couvre les problèmes d'installation, la connectivité réseau, l'authentification, l'intégration au shell et les problèmes de serveur MCP. Pour les étapes de migration post-mise à niveau (sessions, hooks, permissions), consultez Quoi de neuf dans IDE 1.0.

Sur macOS, vous pourriez rencontrer cette erreur en essayant d'ouvrir Kiro :

Kiro is damaged and can't be opened. You should move it to the Trash.

Cette fenêtre contextuelle est due à un faux positif dans les fonctionnalités de sécurité de macOS.

Pour résoudre cette erreur :

• Allez dans System Settings → Privacy & Security et cliquez sur Allow ou Open anyway pour Kiro.
• Faites glisser Kiro.app sur votre bureau, puis faites-le glisser de votre bureau vers le dossier Applications.
• Redémarrez votre ordinateur.
• Ouvrez votre terminal et exécutez :
  sudo xattr -d com.apple.quarantine /Applications/Kiro.app
  

Si Kiro fonctionne pour certains utilisateurs de votre organisation, mais pas pour d'autres, le problème est probablement lié à des configurations réseau propres aux utilisateurs touchés. Une cause fréquente est l'inspection TLS — les pare-feu d'entreprise effectuant une inspection TLS peuvent bloquer ou perturber les connexions aux points de terminaison de Kiro.

• L'IDE Kiro affiche « No profiles available » après une connexion réussie
• Les journaux client affichent Failed to retrieve profiles {"error":""} (une chaîne d'erreur vide indique une défaillance au niveau du réseau)
• La connexion se termine, mais le clavardage et l'aide au code sont indisponibles

Les utilisateurs touchés peuvent tester la connectivité directement :

curl -v https://runtime.us-east-1.kiro.dev
curl -v https://management.us-east-1.kiro.dev

Une négociation TLS réussie (même avec une réponse d'erreur HTTP) confirme la connectivité réseau. Un délai de connexion expiré ou une erreur TLS indique un problème de pare-feu ou de proxy.

Si ces commandes échouent, consultez la liste blanche du pare-feu et travaillez avec votre équipe réseau pour vous assurer que les points de terminaison requis sont accessibles depuis le chemin réseau des utilisateurs touchés.

Si, lors de l'authentification avec Kiro, vous n'êtes pas redirigé vers le navigateur, essayez ces solutions propres à chaque plateforme :

Exécutez Kiro avec la journalisation activée pour repérer les problèmes potentiels :

1. Ouvrez l'invite de commandes en tant qu'administrateur
2. Exécutez la commande suivante (remplacez par le chemin d'installation réel de Kiro) :
   C:\path\to\app.exe --enable-logging
   

3. Vérifiez les journaux pour repérer les erreurs
4. Si vous voyez des erreurs d'accès refusé, assurez-vous que votre utilisateur dispose des permissions d'administrateur pour exécuter l'application

Utilisez les outils de développement pour diagnostiquer le problème :

1. Ouvrez Kiro
2. Allez dans Help → Toggle Developer Tools
3. Accédez à l'onglet Console
4. Observez les erreurs signalées pendant le processus de connexion
5. Si l'erreur indique une dépendance manquante, assurez-vous qu'elle est accessible dans votre PATH
   • Un problème fréquent est la commande ioreg manquante
   • Vérifiez que ioreg est inclus dans votre variable PATH :
     bash

     echo $PATH
     which ioreg
     

   • Si ioreg est manquant, il se trouve généralement à /usr/sbin/ioreg

Si vous voyez une erreur There was an error signing you in en tentant de vous authentifier avec Identity Center, assurez-vous que votre statut d'abonnement est actif. L'authentification IAM Identity Center nécessite un abonnement actif. Les profils Kiro sont actuellement pris en charge dans les régions US East (Virginie du Nord) et Europe (Francfort).

Les sessions Identity Center ont un délai d'expiration par défaut de 8 heures, ce qui signifie que vous devrez vous authentifier de nouveau périodiquement. Pour prolonger la durée de session, les administrateurs peuvent configurer des délais d'expiration plus longs. Pour des instructions de configuration détaillées, consultez la documentation AWS sur la configuration de la durée de session utilisateur.

L'intégration au shell relie Kiro à votre terminal, permettant l'exécution automatique de commandes et le traitement des résultats. Sans elle, vous devrez copier-coller manuellement les sorties du terminal.

1. Mettre à jour Kiro : Palette de commandes (Cmd + Shift + P / Ctrl + Shift + P) → Kiro: Check for Updates
2. Activer l'intégration : Palette de commandes (Cmd + Shift + P / Ctrl + Shift + P) → Kiro: Enable Shell Integration
3. Redémarrer : Fermez et rouvrez Kiro

Si la configuration automatique échoue, ajoutez ceci à la configuration de votre shell :

Zsh (~/.zshrc) :

[[ "$TERM_PROGRAM" == "kiro" ]] && . "$(kiro --locate-shell-integration-path zsh)"

Bash (~/.bashrc) :

[[ "$TERM_PROGRAM" == "kiro" ]] && . "$(kiro --locate-shell-integration-path bash)"

Fish (~/.config/fish/config.fish) :

string match -q "$TERM_PROGRAM" "kiro"
and . (kiro --locate-shell-integration-path fish)

PowerShell ($Profile) :

if ($env:TERM_PROGRAM -eq "kiro") { . "$(kiro --locate-shell-integration-path pwsh)" }

Si Kiro n'arrive pas à lire la sortie du terminal, reste bloqué au statut Working..., ou si vous voyez des caractères étranges et des problèmes de mise en forme, cela est généralement causé par des personnalisations du shell qui interfèrent avec l'intégration du terminal. Les coupables fréquents comprennent des personnalisations comme bash-it sur bash ou Oh My Posh sur zsh, ainsi que des thèmes comme Powerlevel10k/9k.

Si vous utilisez le thème Powerlevel10k, ajoutez cette ligne à votre fichier .p10k.zsh :

typeset -g POWERLEVEL9K_TERM_SHELL_INTEGRATION=true

Vous pouvez aussi désactiver ces personnalisations lors de l'exécution dans Kiro.

zsh (~/.zshrc) :

if [[ "$TERM_PROGRAM" == "kiro" ]]; then
  # Leave empty
else
  # Your themes or customizations
  ZSH_THEME="powerlevel10k/powerlevel10k"
fi

Si vous utilisez le shell Fish et rencontrez des problèmes de sortie du terminal, vous devrez peut-être ajouter manuellement Kiro au script d'intégration du shell existant. Le fichier d'intégration du shell Fish se trouve à :

/Applications/Kiro.app/Contents/Resources/app/out/vs/workbench/contrib/terminal/common/scripts/shellIntegration.fish

Par défaut, le script d'intégration ne vérifie que « vscode » :

status is-interactive
and string match --quiet "$TERM_PROGRAM" "vscode"
and ! set --query VSCODE_SHELL_INTEGRATION
or exit

Vous devez le mettre à jour pour inclure aussi « kiro » :

status is-interactive
and string match --quiet "$TERM_PROGRAM" "vscode" "kiro"
and ! set --query VSCODE_SHELL_INTEGRATION
or exit

Sous Windows, si vous rencontrez cette erreur :

Updates are disabled because you are running the user-scope installation of Kiro as Administrator. This occurs as Kiro does not support system-level installation, which requires administrator privileges.

Pour retirer l'exécution en tant qu'administrateur, vous pouvez :

1. Faire un clic droit sur l'icône de Kiro
2. Sélectionner Show more options
3. Sélectionner Properties
4. Accéder à l'onglet Compatibility
5. Décocher la case Run this program as an administrator
6. Sélectionner Apply, puis OK pour enregistrer les modifications

Après avoir suivi ces étapes, Kiro devrait pouvoir se mettre à jour normalement.

Dans PowerShell 7+, définissez la politique d'exécution :

Vérifier la politique actuelle :

Get-ExecutionPolicy

Définir la politique d'exécution :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Si vous utilisez OneDrive sous Windows, votre chemin de bureau pourrait causer des problèmes :

1. Lancez l'invite de commandes en tant qu'administrateur
2. Créez un lien symbolique :
   mklink /J "C:\Users\<username>\Desktop" "C:\Users\<username>\OneDrive\Desktop"
   

3. Redémarrez votre IDE

Si vous avez de la difficulté à vous connecter à des serveurs MCP :

1. Vérifiez le statut du serveur :

   • Ouvrez le panneau Kiro et accédez à l'onglet des serveurs MCP
   • Vérifiez l'indicateur de statut de connexion pour votre serveur

2. Vérifiez la configuration :

   • Assurez-vous que votre fichier de configuration MCP a la syntaxe correcte
   • Vérifiez que la commande et les arguments du serveur sont corrects

3. Vérifiez les prérequis :

   • Assurez-vous que toutes les dépendances requises sont installées
   • Pour le serveur AWS Documentation, vérifiez que Python 3.10+ et uv sont installés

4. Consultez les journaux :

   • Ouvrez le panneau Output dans Kiro
   • Sélectionnez « Kiro - MCP Logs » dans la liste déroulante
   • Recherchez les messages d'erreur précis

1. Échecs de connexion :

   bash

   # Verify uv installation
   uv --version
   
   # Verify Python version
   python --version
   
   # Test server directly
   uvx awslabs.aws-documentation-mcp-server@latest --help
   

2. Échecs de recherche ou de lecture :

   • Vérifiez votre connexion Internet
   • Vérifiez le format de l'URL des pages de documentation
   • Essayez avec une requête de recherche plus simple

1. Erreurs d'authentification :

   • Vérifiez que votre jeton d'accès personnel est valide
   • Assurez-vous que le jeton dispose des portées requises (repo, user)
   • Générez un nouveau jeton si nécessaire

2. Problèmes de limitation du débit :

   • L'API GitHub a des limites d'utilisation
   • Vérifiez le statut de la limite de débit dans les journaux MCP
   • Envisagez d'utiliser un jeton avec des limites de débit plus élevées

Si vous avez essayé les étapes de dépannage ci-dessus et avez encore besoin d'aide :

1. Consultez notre FAQ pour les questions courantes
2. Rejoignez notre Discord communautaire pour obtenir de l'aide
3. Soumettez un problème sur GitHub en incluant :
   • Les détails de votre système d'exploitation
   • La version de Kiro
   • Les étapes que vous avez déjà essayées
   • Les messages d'erreur (le cas échéant)