> Ouverture en cours : l'inscription et le paiement ne sont pas encore ouverts à tous. L'état du jour : https://subagent.fr/docs/etat.md
>
> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# Brancher Claude Code

> Une commande, sans clé. Votre agent s'inscrit lui-même, puis vous relancez la commande avec la clé qu'il a reçue.

## 1. Ajoutez le serveur, sans clé

```sh
claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp
```

Sans clé, le serveur ne montre qu'un outil : `sign_up`.

## 2. Demandez à votre agent de s'inscrire

> « Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. »

Il appelle `sign_up` avec le nom de sa boîte et votre e-mail. Le serveur rend une clé, de la forme `sak_…`, et une boîte `nom@subagentmail.fr`. **La clé ne s'affiche qu'une fois.** Vous recevez par e-mail un code à 6 chiffres, valable 24 heures.

```text
Espace ouvert. Votre boîte : atelier-exemple@subagentmail.fr (inb_3f9c2a7e5b1d4c8e9a0f6b2d7c4e1a95). Elle reçoit dès maintenant ; elle n’enverra qu’une fois l’espace vérifié.

Votre clé (affichée une seule fois, gardez-la en lieu sûr) : sak_…
Pour l’utiliser : en-tête « Authorization: Bearer <clé> » sur https://api.subagent.fr/mcp, ou sur POST https://api.subagent.fr/v1/{opération}.

Un code à 6 chiffres vient de partir à m•••@exemple.fr (valable 24 heures). Demandez-le à votre humain, puis appelez verify avec votre clé.

Une fois l’espace vérifié, la boîte prépare des brouillons et écrit à votre humain (test: true). Pour écrire à des tiers, l’espace doit avoir un forfait : 9 € par mois : 2 boîtes, 800 e-mails par mois ; 19 € par mois : 5 boîtes, 2 000 e-mails par mois ; 49 € par mois : 15 boîtes, 6 000 e-mails par mois. billing_status dit où il en est.
```

## 3. Relancez la commande avec la clé

Le serveur lit la clé à chaque requête, dans un en-tête. La connexion ouverte sans clé ne montre toujours que `sign_up` : rangez la clé dans une variable d'environnement, puis rebranchez le serveur.

```sh
export SUBAGENT_KEY="sak_…"
claude mcp remove subagent
claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp \
  --header "Authorization: Bearer $SUBAGENT_KEY"
```

Ou par un fichier `.mcp.json`, à la racine du projet. Il ne contient que le nom de la variable :

.mcp.json :

```json
{
  "mcpServers": {
    "subagent": {
      "type": "http",
      "url": "https://api.subagent.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${SUBAGENT_KEY}"
      }
    }
  }
}
```

Ouvrez ensuite une nouvelle session : votre agent voit les outils que sa clé ouvre.

## 4. Donnez-lui le code

> « Le code est 482913. »

Il appelle `verify`. Avant ce code, la boîte reçoit et n'envoie pas.

```text
Espace vérifié. La boîte reçoit, prépare des brouillons et écrit à votre humain (send_email avec test: true). Pour écrire à des tiers, l’espace doit avoir un forfait : 9 € par mois : 2 boîtes, 800 e-mails par mois ; 19 € par mois : 5 boîtes, 2 000 e-mails par mois ; 49 € par mois : 15 boîtes, 6 000 e-mails par mois. billing_status dit où il en est.
```

## 5. Vérifiez le branchement

> « Où en est ma boîte ? »

Il appelle `inbox_status`, le point de départ de toute session : l'espace, les permissions de la clé, les heures d'envoi, le forfait, et pour chaque boîte son quota du jour.

## Ensuite

- **Payer** : « Demande le lien de paiement. » Votre agent appelle `subscribe` et vous remet le lien. Voir [Tarifs](https://subagent.fr/tarifs.md).
- **Valider ses envois** : vous branchez [Claude](https://subagent.fr/brancher/claude.md) ou [ChatGPT](https://subagent.fr/brancher/chatgpt.md) par le connecteur. La clé de votre agent ne porte pas `approve`.
- **Le plugin Claude Code** réunit le serveur, la clé et des recettes : voir [Open source](https://subagent.fr/open-source.md).
- Le guide complet : [Démarrer](https://subagent.fr/docs/demarrer.md). Les autres assistants : [Brancher mon agent](https://subagent.fr/brancher.md).