> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stratta.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage

> Solutions aux problèmes de configuration et d'exécution les plus courants de Stratta.

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.

## Échec d'authentification / clé API invalide

<Steps>
  <Step title="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é.
  </Step>

  <Step title="Vérifiez qu'elle n'est pas révoquée">
    Ouvrez [stratta.ch/api-keys](https://stratta.ch/api-keys) et confirmez que la clé est toujours
    active. En cas de doute, créez-en une nouvelle.
  </Step>

  <Step title="Vérifiez que la clé atteint le processus">
    Si vous utilisez la variable d'environnement, confirmez qu'elle est définie :

    ```bash theme={null}
    echo $STRATTA_API_KEY          # macOS / Linux
    echo $env:STRATTA_API_KEY      # Windows PowerShell
    ```
  </Step>

  <Step title="Réenregistrez la clé">
    Exécutez à nouveau `npx -y @stratta/mcp login` et collez une nouvelle clé.
  </Step>
</Steps>

## `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

<Steps>
  <Step title="Redémarrez le client">
    Quittez et rouvrez Claude Desktop, ou redémarrez votre session Claude Code, après avoir modifié
    une configuration.
  </Step>

  <Step title="Consultez les journaux du serveur">
    * **Claude Code :** `claude mcp logs stratta`
    * **Claude Desktop (macOS) :** `~/Library/Logs/Claude/mcp-server-stratta.log`
  </Step>

  <Step title="Vérifiez votre version de Node.js">
    Le serveur requiert Node **20 ou plus récent** :

    ```bash theme={null}
    node --version
    ```
  </Step>
</Steps>

## 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
[stratta.ch/api-keys](https://stratta.ch/api-keys). Voir
[Gérer les clés API](/fr/guides/manage-api-keys).

## 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é/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](mailto:hello@stratta.ch) en indiquant la commande qui échoue et toute
sortie de journal (masquez votre clé API).