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

> ChatGPT se branche à Subagent Mail par le connecteur. Il n'accepte pas de clé : vous vous connectez avec votre e-mail et un code à 6 chiffres. Sans espace, vous ouvrez le vôtre sur la page de connexion. Vous y écrivez, vous lisez les fils, vous corrigez et vous validez les brouillons.

## Ce qu'il vous faut

- **Votre adresse e-mail.** Elle reçoit le code de connexion. Si un espace lui est déjà rattaché, celui que votre agent a ouvert par exemple, vous le retrouvez. Sinon, vous ouvrez le vôtre : il ne faut pas d'agent pour s'inscrire.
- **Un ChatGPT qui accepte d'ajouter un connecteur** à partir de l'adresse d'un serveur MCP distant.

## 1. Ajoutez le connecteur

Dans les réglages de ChatGPT, ajoutez un connecteur à partir de l'adresse d'un serveur MCP, et donnez-lui cette adresse.

Adresse du connecteur :

```text
https://api.subagent.fr/connect
```

C'est l'adresse des assistants. L'autre adresse, `https://api.subagent.fr/mcp`, est celle des agents : sans clé, elle ne montre que `sign_up`.

## 2. Connectez-vous

ChatGPT ouvre une page de Subagent, sur `api.subagent.fr`.

1. Donnez votre e-mail.
2. Un code à 6 chiffres lui est envoyé. Il vaut 10 minutes.
3. Saisissez le code.

La page répond la même chose à toute adresse.

## 3. Autorisez

**Sans espace**, la page vous propose d'ouvrir le vôtre.

- Vous choisissez le nom de votre première boîte : `nom@subagentmail.fr`. Le nom fait 3 à 32 caractères : minuscules, chiffres, point, tiret ou souligné.
- Vous lisez ce que l'application pourra faire, puis vous choisissez « Ouvrir mon espace et autoriser ».
- L'espace s'ouvre, déjà vérifié : le code vient de prouver votre adresse. La boîte reçoit dès son ouverture. Pour écrire à d'autres que vous, il faut un forfait : ChatGPT vous en donne le lien.

**Avec un espace**, la page montre l'espace, ce que l'application pourra y faire, et l'adresse où elle vous renvoie. Si vous avez plusieurs espaces, vous en choisissez un.

| Ce que l'application pourra faire | Permission |
|---|---|
| Lire vos boîtes, vos fils et vos messages. | `read` |
| Écrire et répondre depuis vos boîtes, dans les règles d'envoi de l'espace. | `send` |
| Valider ou annuler les brouillons en attente : ce que vous validez dans l'assistant part. | `approve` |
| Créer et supprimer des boîtes. | `manage_inboxes` |

Vous autorisez, ou vous refusez. L'accès dure tant que vous ne le retirez pas : déconnectez le connecteur dans ChatGPT pour y mettre fin.

## Ce que vous y faites

| Vous dites | ChatGPT appelle |
|---|---|
| « Donne-moi le lien de paiement. » | `subscribe` |
| « Montre-moi les brouillons. » | `list_drafts` |
| « Valide le premier. » | `approve_message` |
| « Remplace vendredi par lundi dans le deuxième. » | `update_draft` |
| « Où en est le rendez-vous avec Madame Morel ? » | `get_thread` |
| « Où en est mon forfait ? » | `billing_status` |
| « Résilie mon forfait. » | `cancel_subscription` |

Certains outils s'accompagnent d'une vue, affichée dans la conversation si votre ChatGPT prend en charge les vues MCP Apps. Sinon, le même résultat se lit en texte. Voir [Vues](https://subagent.fr/docs/vues.md).

## Avec un agent

Un espace ouvert sur la page de connexion n'a pas de clé d'agent : c'est ChatGPT qui y lit et y écrit. Un agent qui travaille dans un terminal ou un éditeur ouvre, lui, son propre espace, à l'adresse `https://api.subagent.fr/mcp`, et reçoit sa clé. Si vous voulez les deux, laissez l'agent s'inscrire d'abord avec votre e-mail : vous retrouverez son espace ici, à la connexion. Voir [Claude Code](https://subagent.fr/brancher/claude-code.md), [Cursor](https://subagent.fr/brancher/cursor.md) ou [HTTP](https://subagent.fr/brancher/http.md).

## Si la connexion n'aboutit pas

| Ce qui se passe | Ce qu'il faut regarder |
|---|---|
| Aucun code n'arrive. | L'adresse donnée est-elle la bonne ? Le code est-il rangé dans les indésirables ? Les codes envoyés à une adresse sans espace sont limités, comme les inscriptions : réessayez plus tard. |
| Le code est refusé. | Un code vaut 10 minutes et cinq essais. La page propose de le renvoyer. |
| Le nom de la boîte est refusé. | Il est déjà pris, réservé, ou hors format. La page dit pourquoi. |
| La demande a expiré. | Une demande de connexion vaut 15 minutes. Relancez-la depuis ChatGPT. |

## Ensuite

- [Valider les envois d'un agent](https://subagent.fr/docs/guide-validation.md) : relire, corriger, valider.
- [Connecteur](https://subagent.fr/docs/connecteur.md) : ce que fait le connecteur, pour qui écrit un client.
- [Brancher mon agent](https://subagent.fr/brancher.md) : les autres assistants.