> 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 mon agent

> Une adresse à coller, un code à 6 chiffres, une mission. Dans Claude ou ChatGPT, vous ouvrez votre espace vous-même. Un agent comme Claude Code s'inscrit lui-même, par le MCP.

**Pour un agent** : MCP en Streamable HTTP sur `https://api.subagent.fr/mcp`. Sans clé, un seul outil : `sign_up`. Déjà une clé ? Ne vous réinscrivez pas : en-tête `Authorization: Bearer sak_…`. Le parcours complet : [Pour les agents](https://subagent.fr/docs/agents.md).

## Choisissez votre assistant.

Deux adresses, un même serveur. Claude et ChatGPT se branchent par le connecteur, à l'adresse `https://api.subagent.fr/connect` : vous y ouvrez votre espace, ou vous retrouvez celui que votre agent a ouvert, et c'est là que vous lisez, corrigez et validez. Claude Code, Cursor et tout agent se branchent au MCP, à l'adresse `https://api.subagent.fr/mcp`, et s'inscrivent eux-mêmes.

| Assistant | Adresse | Ce que vous faites | Guide |
|---|---|---|---|
| Claude | `https://api.subagent.fr/connect` | Vous ajoutez un connecteur personnalisé, vous donnez votre e-mail, vous recevez un code à 6 chiffres, valable 10 minutes. Sans espace, vous choisissez le nom de votre première boîte ; sinon, vous choisissez votre espace. Vous autorisez. | [Brancher Claude](https://subagent.fr/brancher/claude.md) |
| ChatGPT | `https://api.subagent.fr/connect` | Vous ajoutez un connecteur à partir de l'adresse d'un serveur MCP, vous donnez votre e-mail, vous recevez un code à 6 chiffres, valable 10 minutes. Sans espace, vous choisissez le nom de votre première boîte ; sinon, vous choisissez votre espace. Vous autorisez. | [Brancher ChatGPT](https://subagent.fr/brancher/chatgpt.md) |
| Claude Code | `https://api.subagent.fr/mcp` | Une commande, sans clé. Votre agent s'inscrit avec `sign_up` et reçoit sa clé, qui ne s'affiche qu'une fois. Vous relancez la commande avec la clé, puis il passe à `verify` le code à 6 chiffres reçu par e-mail, valable 24 heures. | [Brancher Claude Code](https://subagent.fr/brancher/claude-code.md) |
| Cursor | `https://api.subagent.fr/mcp` | Un fichier `.cursor/mcp.json`, sans clé. Votre agent s'inscrit avec `sign_up` et reçoit sa clé, qui ne s'affiche qu'une fois. Vous ajoutez l'en-tête avec la clé, puis il passe à `verify` le code à 6 chiffres reçu par e-mail, valable 24 heures. | [Brancher Cursor](https://subagent.fr/brancher/cursor.md) |
| HTTP | `https://api.subagent.fr/v1/{opération}` | Un `POST` par outil, sans client MCP. | [Brancher par HTTP](https://subagent.fr/brancher/http.md) |

Dans Claude et ChatGPT, il n'y a pas de clé à copier, et il ne faut pas d'agent pour s'inscrire : sans espace, vous ouvrez le vôtre sur la page de connexion.

Claude Code, sans clé, puis avec la clé :

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

```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"
```

Cursor (`.cursor/mcp.json`), sans clé, puis avec la clé :

```json
{
  "mcpServers": {
    "subagent": {
      "url": "https://api.subagent.fr/mcp"
    }
  }
}
```

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

HTTP, `sign_up` sans clé, puis `verify` avec la clé :

```sh
curl -X POST https://api.subagent.fr/v1/sign_up \
  -H "Content-Type: application/json" \
  -d '{"username": "atelier-exemple", "human_email": "marie@exemple.fr"}'
```

```sh
curl -X POST https://api.subagent.fr/v1/verify \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"otp_code": "482913"}'
```

Un autre client MCP (VS Code, Codex, Gemini CLI…) ? Il lui faut l'adresse et, après l'inscription, l'en-tête `Authorization` : voir [Serveur MCP](https://subagent.fr/docs/mcp.md).

Ce que répond `sign_up` à un agent qui s'inscrit (« Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. ») :

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

Rangez la clé dans une variable d'environnement, puis rebranchez le serveur avec elle. Sans cela, votre agent ne voit toujours que `sign_up`.

## Un paiement, un domaine, une mission.

Les mêmes gestes dans tous les assistants : vous les demandez à Claude, à ChatGPT ou à votre agent.

1. **Payez par un lien.** « Demande le lien de paiement. » Votre assistant, ou votre agent, demande le lien et vous le remet. Vous choisissez votre forfait et vous payez. Un agent ne paie jamais. Avant le paiement, la boîte reçoit, prépare des brouillons et n'écrit qu'à vous. Les forfaits : [Tarifs](https://subagent.fr/tarifs.md).
2. **Enregistrez votre domaine.** « Enregistre le domaine agents.exemple.fr et donne-moi les enregistrements DNS à publier. » La boîte du domaine commun reçoit et répond. Pour écrire le premier, il faut votre domaine. `add_domain` rend les enregistrements DNS à publier, `verify_domain` les contrôle. Les publier chez l'hébergeur DNS de votre domaine est le seul geste qui se fait hors de l'assistant. Un sous-domaine suffit.
3. **Donnez-lui une mission.** « Écris au cabinet Morel pour déplacer le rendez-vous de jeudi. Laisse le message en brouillon : je le relis. » Un message ne part pas tout de suite : il entre en file, et la réponse du serveur donne l'heure de départ au plus tôt.

Ce que répond `subscribe` :

```text
Lien de paiement prêt, valable 72 heures :
https://api.subagent.fr/pay/…
Donnez-le tel quel à votre humain (m•••@exemple.fr). Sur la page, votre humain (m•••@exemple.fr) choisit son 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), donne ses coordonnées de facturation, puis paie chez Mollie avec la confirmation de sa banque. Ensuite le même montant est prélevé chaque mois, jusqu’à résiliation.
Vous ne payez rien et ne validez rien à sa place. Ensuite, billing_status dit si le forfait est en cours ; dès qu’il l’est, reprenez ce qui attendait.
```

## Le domaine commun reçoit et répond. Pour écrire le premier, il faut votre domaine.

La première boîte s'ouvre sur le domaine commun : `nom@subagentmail.fr`. Vous choisissez son nom sur la page de connexion, ou votre agent le choisit avec `sign_up`.

- **Avant le paiement** : la boîte reçoit, prépare des brouillons et n'écrit qu'à vous.
- **Une fois payé** : elle répond à qui lui a écrit.
- **Pour écrire le premier** : il faut votre domaine. Le premier message à un inconnu part d'une boîte de votre domaine, pas du domaine commun.

## Votre agent rend les enregistrements DNS à publier.

Vos boîtes portent votre nom. La montée progressive s'applique à chaque boîte.

- `add_domain` enregistre votre domaine et rend les enregistrements DNS à publier : preuve de propriété, DKIM, SPF, MX. DMARC est conseillé.
- `verify_domain` contrôle que ces enregistrements sont publiés, un par un.
- `create_inbox` crée une boîte sur votre domaine. Ses envois montent par paliers : 5, 10, 15, puis 20 e-mails par jour.

Détail : [Domaines](https://subagent.fr/docs/domaines.md).

## Vous validez dans votre assistant. Un brouillon ne part qu'après votre validation.

Demandez à votre agent de laisser ses messages en brouillon. Vous les relisez et les validez depuis Claude ou ChatGPT, branché par le connecteur.

- **Votre agent** : sa clé, rendue par `sign_up`, porte `send`, `read` et `manage_inboxes`. Elle ne porte pas `approve`.
- **Vous** : l'accès que vous autorisez par le connecteur porte `approve`.
- **Le geste** : « Montre-moi les brouillons », puis « valide le premier » : `list_drafts`, `approve_message`.

Détail : [Valider les envois d'un agent](https://subagent.fr/docs/guide-validation.md).