Dépannage

La plupart des problèmes se résument à la clé API, au réseau ou au client Claude qui ne se recharge pas. Parcourez la section pertinente ci-dessous.

Commencez par doctor#

npx -y @stratta/mcp doctor

Une clé révoquée, une variable STRATTA_API_KEY oubliée dans votre shell, un serveur injoignable et un espace de travail vide produisent tous le même symptôme vu depuis l'agent : « cette norme n'est pas disponible ». doctor les distingue et indique, pour chaque point en échec, la commande qui le corrige.

Échec d'authentification / clé API invalide#

1. Vérifiez le format de la clé

   Une clé valide commence par sk_strt_. Assurez-vous qu'aucun espace en début ou en fin n'a été copié.

2. Vérifiez qu'elle n'est pas révoquée

   Ouvrez Paramètres › Clés API et confirmez que la clé est toujours active. En cas de doute, créez-en une nouvelle.

3. Vérifiez que la clé atteint le processus

   Si vous utilisez la variable d'environnement, confirmez qu'elle est définie :

   echo $STRATTA_API_KEY          # macOS / Linux
   echo $env:STRATTA_API_KEY      # Windows PowerShell

4. Réenregistrez la clé

   Exécutez à nouveau npx -y @stratta/mcp login et collez une nouvelle clé.

ECONNREFUSED ou erreurs réseau#

• Confirmez que le HTTPS sortant vers *.convex.cloud est autorisé par votre pare-feu ou votre VPN.
• Testez la connectivité générale : curl -I https://stratta.ch.

Les outils n'apparaissent pas dans Claude#

1. Redémarrez le client

   Quittez et rouvrez Claude Desktop, ou redémarrez votre session Claude Code, après avoir modifié une configuration.

2. Consultez les journaux du serveur

   • Claude Code : claude mcp logs stratta
   • Claude Desktop (macOS) : ~/Library/Logs/Claude/mcp-server-stratta.log

3. Vérifiez votre version de Node.js

   Le serveur requiert Node 20 ou plus récent :

   node --version

Limite de débit atteinte#

Chaque utilisateur peut détenir jusqu'à 50 clés actives et créer 20 nouvelles clés par tranche de 24 heures. Si vous atteignez une limite, révoquez les clés inutilisées sur Paramètres › Clés API. Voir Gérer les clés API.

Les figures ne s'affichent pas en ligne#

Lorsque vous posez une question sur une figure, Stratta renvoie l'image accompagnée d'un lien pour la voir en taille réelle. Certains clients ne peuvent pas afficher les images distantes en ligne :

• Claude Desktop affiche un espace réservé ou lien cliquable plutôt que l'image dans le corps du message. Il s'agit d'une limitation actuelle du client desktop, pas de Stratta.
• L'image native (base64) est disponible dans le panneau de résultat de l'outil.

Vous pouvez toujours ouvrir l'URL fournie pour voir la figure en taille réelle.

Toujours bloqué ?#

Écrivez à hello@stratta.ch en indiquant la commande qui échoue et toute sortie de journal (masquez votre clé API).