> 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 Cursor

> Un fichier, sans clé. Votre agent s'inscrit lui-même, puis vous ajoutez au fichier l'en-tête avec la clé qu'il a reçue.

## 1. Déclarez le serveur, sans clé

Le fichier est `.cursor/mcp.json` dans le projet, ou `~/.cursor/mcp.json` pour tous vos projets.

.cursor/mcp.json :

```json
{
  "mcpServers": {
    "subagent": {
      "url": "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. Ajoutez la clé au fichier

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 ajoutez l'en-tête. Le fichier ne contient que le nom de la variable.

```sh
export SUBAGENT_KEY="sak_…"
```

.cursor/mcp.json :

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

Rechargez ensuite le serveur dans Cursor : 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 guide complet : [Démarrer](https://subagent.fr/docs/demarrer.md). Les autres assistants : [Brancher mon agent](https://subagent.fr/brancher.md).