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

# Installer dans Claude Code

> Ajoutez le serveur MCP Stratta à Claude Code — la configuration recommandée.

[Claude Code](https://claude.com/claude-code) est la façon recommandée d'utiliser Stratta. L'installation
est une seule commande, et vous fournissez votre clé API lors de la première utilisation.

## Prérequis

* Claude Code installé.
* [Node.js](https://nodejs.org) **20 ou plus récent** (`node --version` pour vérifier).
* Une [clé API](/fr/guides/get-api-key) Stratta.

## Installation

Ajoutez le serveur — aucune clé n'est nécessaire au préalable :

```bash theme={null}
claude mcp add stratta -- npx -y @stratta/mcp
```

Au premier appel d'outil, Claude Code vous invite à coller votre clé API. Elle est validée et enregistrée
dans `~/.stratta/config.json` (accessible au propriétaire uniquement, mode `0600`), vous ne le faites donc
qu'une seule fois.

<Tip>
  `npx -y @stratta/mcp` récupère toujours la dernière version publiée. Aucune mise à jour manuelle nécessaire.
</Tip>

## Alternative : fournir la clé à l'avance

Vous préférez définir la clé avant le premier appel ? Vous avez deux options.

<Tabs>
  <Tab title="Se connecter via la CLI">
    Exécutez la commande de connexion et collez votre clé lorsque cela vous est demandé. Elle est enregistrée dans `~/.stratta/config.json`.

    ```bash theme={null}
    npx -y @stratta/mcp login
    ```
  </Tab>

  <Tab title="Variable d'environnement">
    Passez la clé comme variable d'environnement. Elle a priorité sur la clé enregistrée.

    ```bash theme={null}
    claude mcp add stratta --scope user --env STRATTA_API_KEY=sk_strt_xxx -- npx -y @stratta/mcp
    ```

    <Warning>
      Utilisez `--scope user` (pas une config restreinte à un projet) pour que la clé ne soit pas committée dans un dépôt.
    </Warning>
  </Tab>
</Tabs>

## Vérifier que ça fonctionne

Démarrez une conversation et demandez à Claude de lister les normes disponibles, par exemple :

```text theme={null}
List the engineering norms available in Stratta.
```

Claude devrait appeler `list_norms` et renvoyer les normes de votre espace de travail. Si les outils
n'apparaissent pas, consultez [Dépannage](/fr/resources/troubleshooting).

<Tip>
  Consultez les logs du serveur à tout moment avec `claude mcp logs stratta`.
</Tip>

## Comment la clé est résolue

Le serveur recherche votre clé dans cet ordre :

1. La variable d'environnement `STRATTA_API_KEY`.
2. `~/.stratta/config.json` (écrit par `login` ou l'invite de première utilisation).
3. Une invite interactive lors de la première utilisation (clients qui le supportent).

Tous les détails dans [Référence MCP → Vue d'ensemble](/fr/mcp/overview).

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Posez votre première question" icon="comments" href="/fr/guides/ask-your-first-question">
    Des modèles de requêtes qui fonctionnent bien.
  </Card>

  <Card title="Référence MCP" icon="terminal" href="/fr/mcp/overview">
    Chaque outil et commande.
  </Card>
</CardGroup>