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

# CLI & commandes

> Toutes les commandes pour installer, authentifier et exécuter le serveur MCP Stratta.

Le package `@stratta/mcp` est à la fois le serveur MCP et un petit CLI de configuration. Vous
l'exécutez rarement directement — c'est votre client Claude qui le lance — mais ces commandes
couvrent l'installation et l'authentification.

## Ajouter à Claude Code

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

Ajoute le serveur sans clé d'emblée ; elle vous est demandée au premier usage. Pour définir la clé
explicitement :

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

<Warning>
  Utilisez `--scope user`, jamais une configuration au niveau du projet, afin que votre clé ne soit
  pas commitée dans un dépôt.
</Warning>

## Se connecter (enregistrer votre clé)

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

Vous invite à coller votre clé API (saisie masquée), la valide auprès du backend et l'enregistre
dans `~/.stratta/config.json` (accessible au propriétaire uniquement, mode `0600`). Relancez-la à
tout moment pour remplacer la clé.

## Ajouter à Claude Desktop

Après `login`, ajoutez le serveur à `claude_desktop_config.json` (Settings → Developer → Edit
Config) :

```json theme={null}
{
  "mcpServers": {
    "stratta": {
      "command": "npx",
      "args": ["-y", "@stratta/mcp"]
    }
  }
}
```

Voir [Installer dans Claude Desktop](/fr/guides/install-claude-desktop) pour la procédure
complète, y compris la conservation de la clé dans la configuration via un bloc `env`.

## Installation globale (optionnelle)

```bash theme={null}
npm install -g @stratta/mcp
```

Référencez ensuite le binaire directement au lieu de `npx` :

```json theme={null}
{
  "mcpServers": {
    "stratta": {
      "command": "stratta-mcp"
    }
  }
}
```

## Exécuter le serveur directement

Pour des tests locaux uniquement — votre client Claude le fait normalement :

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

Il se connecte via stdio et journalise sur stderr (stdout est réservé au protocole MCP).
Inspectez-le avec l'inspecteur MCP officiel :

```bash theme={null}
npx @modelcontextprotocol/inspector npx -y @stratta/mcp
```

## Récapitulatif des commandes

| Commande                                        | Objectif                                                 |
| ----------------------------------------------- | -------------------------------------------------------- |
| `claude mcp add stratta -- npx -y @stratta/mcp` | Ajouter à Claude Code (clé au premier usage).            |
| `npx -y @stratta/mcp login`                     | Enregistrer votre clé API dans `~/.stratta/config.json`. |
| `npm install -g @stratta/mcp`                   | Installer le binaire `stratta-mcp` globalement.          |
| `npx -y @stratta/mcp`                           | Exécuter le serveur via stdio (test).                    |

## Liens connexes

<CardGroup cols={2}>
  <Card title="Vue d'ensemble" icon="book" href="/fr/mcp/overview">
    Authentification et résolution de la clé.
  </Card>

  <Card title="Outils de lecture" icon="book-open" href="/fr/mcp/read-tools">
    Ce que le serveur expose une fois en cours d'exécution.
  </Card>
</CardGroup>