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.appsur 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 :
- Ouvrez l'invite de commandes en tant qu'administrateur
- Exécutez la commande suivante (remplacez par le chemin d'installation réel de Kiro) :
C:\path\to\app.exe --enable-logging - Vérifiez les journaux pour repérer les erreurs
- 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 :
- Ouvrez Kiro
- Allez dans Help → Toggle Developer Tools
- Accédez à l'onglet Console
- Observez les erreurs signalées pendant le processus de connexion
- 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
ioregmanquante - Vérifiez que
ioregest inclus dans votre variable PATH :bashecho $PATH which ioreg - Si
ioregest manquant, il se trouve généralement à/usr/sbin/ioreg
- Un problème fréquent est la commande
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.
- Mettre à jour Kiro : Palette de commandes (
Cmd + Shift + P/Ctrl + Shift + P) →Kiro: Check for Updates - Activer l'intégration : Palette de commandes (
Cmd + Shift + P/Ctrl + Shift + P) →Kiro: Enable Shell Integration - 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)" }
Kiro reste bloqué au statut « Working... » sur les commandes du terminal ou Kiro ne voit pas la sortie du terminal
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 :
- Faire un clic droit sur l'icône de Kiro
- Sélectionner
Show more options - Sélectionner
Properties - Accéder à l'onglet
Compatibility - Décocher la case
Run this program as an administrator - Sélectionner
Apply, puisOKpour 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 :
- Lancez l'invite de commandes en tant qu'administrateur
- Créez un lien symbolique :
mklink /J "C:\Users\<username>\Desktop" "C:\Users\<username>\OneDrive\Desktop" - Redémarrez votre IDE
Si vous avez de la difficulté à vous connecter à des serveurs MCP :
-
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
-
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
-
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
-
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
-
É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 -
É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
-
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
-
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 :
- Consultez notre FAQ pour les questions courantes
- Rejoignez notre Discord communautaire pour obtenir de l'aide
- 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)
Dépannage