# Brancher mon agent

> Une adresse à coller, un code à 6 chiffres, une mission. Votre agent s'inscrit lui-même, par le MCP. Vous confirmez avec un code reçu par e-mail.

Le guide détaillé, outil par outil : [Démarrer](https://subagent.fr/docs/demarrer.md).

## Bêta privée : les inscriptions sont sur invitation

Seul un e-mail invité reçoit le code de vérification. Sans invitation, votre agent peut déjà ouvrir une boîte qui reçoit, avec `sign_up` sans `human_email` ; elle n'enverra qu'une fois votre e-mail invité et le code donné.

Pour demander une invitation, écrivez à `contact@subagent.fr`, depuis l'e-mail que vous donnerez à votre agent : c'est lui qui recevra le code.

## Une adresse. Un code. Une mission.

Il vous faut un client MCP qui parle Streamable HTTP : Claude Code, Cursor, ou le vôtre. Le connecteur pour assistants en ligne est [à venir].

### 1. Collez l'adresse du MCP

Une seule adresse, sans clé : `https://api.subagent.fr/mcp`. Sans clé, le serveur ne montre à votre agent qu'un outil, `sign_up`.

Claude Code :

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

Cursor (`.cursor/mcp.json`) :

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

Autre client (`.mcp.json`) :

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

### 2. Donnez-lui le code

Demandez à votre agent de s'inscrire, avec votre adresse : « Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. »

Il appelle `sign_up` : il choisit le nom de sa boîte et reçoit sa clé, de la forme `sak_…`. **La clé ne s'affiche qu'une fois.** Rangez-la dans une variable d'environnement, puis rebranchez le serveur avec elle.

Claude Code :

```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`) :

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

Autre client (`.mcp.json`) :

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

Vous recevez un e-mail avec un code à 6 chiffres, valable 24 heures. Donnez-le à votre agent : il le passe à `verify`, et l'envoi s'ouvre. Si le code s'est perdu, `attach_human` en renvoie un.

### 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. »
- « Regarde les réponses reçues depuis hier et propose-moi une réponse pour chacune. »

Votre agent commence par `inbox_status` : l'état de sa boîte, son quota du jour, les heures d'envoi. 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.

## La boîte d'essai

`sign_up` ouvre une boîte `nom@subagentmail.fr`. Elle est limitée : le domaine commun est partagé par tous les espaces à l'essai, et ne sert qu'à l'essai.

| Moment | Limite |
|---|---|
| Avant le code | La boîte reçoit. Elle n'envoie pas. |
| La première heure | 3 destinataires distincts, au plus. |
| Le premier jour | 5 destinataires distincts, au plus. |
| La première semaine | 10 destinataires distincts, au plus. Ensuite, 10 par semaine. |

Chaque destinataire distinct compte une fois, un correspondant qui vous a écrit compris ; lui réécrire ne prend pas de place. Les [règles d'envoi](https://subagent.fr/docs/regles-envoi.md) s'appliquent en plus : 5 e-mails par jour la première semaine, heures ouvrées, désinscription.

## Pour aller plus loin, enregistrez votre domaine

Vos boîtes portent alors votre nom, et sortent des limites d'essai. La montée progressive continue de s'appliquer à chaque boîte.

- `add_domain` enregistre votre domaine et rend les enregistrements DNS à publier : preuve de propriété, DKIM, SPF, MX.
- `verify_domain` contrôle que ces enregistrements sont publiés.
- Ensuite, `create_inbox` crée des boîtes sur votre domaine.

Voir [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, les corrigez et les validez depuis votre propre assistant, branché au même serveur.

- **Votre agent** : sa clé, rendue par `sign_up`, porte `send`, `read` et `manage_inboxes`. Elle ne porte pas `approve`.
- **Vous** : une clé qui porte `approve`, dans votre assistant. Pendant la bêta, demandez-la à `contact@subagent.fr`.
- **Le geste** : « Montre-moi les brouillons », puis « valide le premier » : `list_drafts`, `approve_message`.

Voir [Brouillons et validation](https://subagent.fr/docs/brouillons.md).