> Pour un agent : la carte de la documentation d'Escouade Mail est sur https://escouade.io/mail/docs/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# Brancher Claude

> Claude se branche à Escouade Mail par le connecteur, sans clé à copier. 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 compte Escouade.** Il se crée sur `compte.escouade.io`, avec votre adresse e-mail. Si un espace est déjà rattaché à cette adresse, 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 Claude qui accepte un connecteur personnalisé**, c'est-à-dire l'adresse d'un serveur MCP distant.

## 1. Ajoutez le connecteur

Dans les réglages de Claude, ajoutez un connecteur personnalisé et donnez-lui cette adresse.

Adresse du connecteur :

```text
https://mail.escouade.io/mcp
```

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

Claude ouvre une page d'Escouade Mail, sur `mail.escouade.io`.

- **Votre navigateur est reconnu** : vous y avez prouvé votre adresse dans les trente derniers jours. La page s'ouvre directement à l'autorisation, sans rien vous redemander.
- **Sinon**, choisissez « Continuer avec Escouade » : votre compte Escouade prouve votre adresse. C'est la seule connexion d'Escouade, la même pour toutes ses applications.
- **En secours**, si le compte ne répond pas par exemple, la page propose aussi votre e-mail : un message lui est envoyé, il vaut 10 minutes. Ouvrez-le dans le même navigateur et choisissez « Continuer la connexion », ou recopiez son code à 6 chiffres sur la page.

## 3. Autorisez

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

- La page propose un nom pour votre première boîte, tiré de votre adresse : `nom@subagentmail.fr`. Vous pouvez le changer. 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é : votre adresse vient d'être prouvée. La boîte reçoit dès son ouverture. Pour écrire à d'autres que vous, il faut un forfait : Claude 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 Claude pour y mettre fin.

## Ce que vous y faites

| Vous dites | Claude 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 Claude prend en charge les vues MCP Apps. Sinon, le même résultat se lit en texte. Voir [Vues](https://escouade.io/mail/docs/vues.md).

## Avec un agent

Un espace ouvert sur la page de connexion n'a pas de clé d'agent : c'est Claude 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://escouade.io/mail/docs/brancher/claude-code.md), [Cursor](https://escouade.io/mail/docs/brancher/cursor.md) ou [HTTP](https://escouade.io/mail/docs/brancher/http.md).

## Si la connexion n'aboutit pas

| Ce qui se passe | Ce qu'il faut regarder |
|---|---|
| Le compte Escouade ne répond pas. | La page le dit. Réessayez dans quelques minutes, ou passez par votre e-mail et son code, proposés sur la même page. |
| 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 Claude. |

## Ensuite

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