> 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`. # Donner une boîte mail à un agent IA > Pour donner une boîte mail à un agent IA, on le branche à un serveur MCP d'e-mail. L'agent s'inscrit lui-même, un humain confirme avec un code reçu par e-mail, puis l'agent écrit, reçoit et répond avec sa propre adresse. Avec Subagent Mail, cela tient en quatre étapes, et deux de plus pour écrire à d'autres que son humain. ## En bref - **Ce que c'est.** Subagent Mail est un service d'e-mail pour agents IA. Chaque agent a sa boîte mail : une adresse à lui, des fils de conversation, des brouillons. - **Comment on s'en sert.** Par MCP, à une seule adresse : `https://api.subagent.fr/mcp`. Il n'y a ni console ni tableau de bord. - **Qui fait quoi.** L'agent s'inscrit, écrit, lit et répond. Un humain donne un code à 6 chiffres, une fois, et paie le forfait. Le serveur règle le rythme des envois. - **Ce qu'il faut.** Un agent dont le client MCP parle Streamable HTTP, et l'e-mail d'un humain. Un nom de domaine pour écrire le premier à quelqu'un. - **Ce que ça coûte.** 9 €, 19 € ou 49 € par mois, pour 2, 5 ou 15 boîtes. Avant le paiement, la boîte reçoit, prépare des brouillons et n'écrit qu'à son humain. Voir [Prix et paiement](https://subagent.fr/docs/prix.md). À ne pas confondre : Subagent Mail est un service d'e-mail. Il n'a pas de rapport avec les sous-agents (« subagents ») de Claude Code ou d'un autre outil. ## Ce qu'il faut | Il faut | Pourquoi | |---|---| | Un agent IA avec un client MCP en Streamable HTTP | Claude Code, Cursor, ou votre propre client. Le serveur n'a pas d'autre interface. Voir [Brancher mon agent](https://subagent.fr/brancher.md). | | L'e-mail d'un humain, hors de Subagent | Il reçoit le code à 6 chiffres qui vérifie l'espace. | | Un endroit où garder la clé | La clé de l'agent ne s'affiche qu'une fois. Une variable d'environnement convient. | | Un nom de domaine, pour écrire le premier | La première boîte est créée sur le domaine commun `subagentmail.fr` : une fois le forfait payé, elle répond à qui lui a écrit. Un premier message part d'une boîte de votre domaine. Un sous-domaine suffit. | ## Les étapes ### 1. Brancher l'agent au serveur MCP On donne à l'agent l'adresse `https://api.subagent.fr/mcp`, sans clé. Sans clé, le serveur ne montre 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" } } } ``` ### 2. L'agent s'inscrit L'agent appelle `sign_up` avec le nom de sa boîte (`username`) et l'e-mail de son humain (`human_email`). Le serveur ouvre un espace et rend deux choses : une clé, de la forme `sak_…`, et une boîte `nom@subagentmail.fr`. La clé ne s'affiche qu'une fois. L'agent la garde, puis la présente à chaque appel dans l'en-tête `Authorization: Bearer sak_…`. Voir [Clés et permissions](https://subagent.fr/docs/cles.md#presenter). ### 3. L'humain donne le code L'humain reçoit un e-mail avec un code à 6 chiffres, valable 24 heures. Il le donne à l'agent, qui le passe à `verify`. Avant ce code, la boîte reçoit et n'envoie pas. ### 4. L'agent écrit à son humain, lit et prépare L'agent commence par `inbox_status`, qui dit où en est sa boîte. Ensuite : - `send_email` avec `test` écrit à son humain ; - `list_threads` puis `get_thread` lisent ce qui est arrivé ; - `send_email` et `reply_to_thread` avec `requires_approval` préparent des brouillons. ### 5. L'humain paie par un lien L'agent appelle `subscribe` et remet le lien à son humain. L'humain choisit son forfait et paie. L'agent ne paie jamais. La boîte répond alors à qui lui a écrit. Voir [Prix et paiement](https://subagent.fr/docs/prix.md#paiement). ### 6. L'agent enregistre le domaine de son humain `add_domain` rend les enregistrements DNS à publier, `verify_domain` les contrôle, `create_inbox` crée une boîte sur ce domaine. Depuis elle, `send_email` écrit un premier message à un destinataire. Voir [Domaines](https://subagent.fr/docs/domaines.md). Le guide pas à pas, avec les réponses du serveur : [Démarrer](https://subagent.fr/docs/demarrer.md). ## Ce que l'agent fait avec sa boîte | Besoin | Ce que fait l'agent | Outils | |---|---|---| | Écrire à une personne | Il écrit un premier message depuis une boîte du domaine de son humain. | `send_email` | | Lire une réponse et y répondre | Il relève ses fils, lit la réponse, répond dans le fil. | `list_threads`, `get_thread`, `reply_to_thread` | | Recevoir un code envoyé par un autre service | Il donne son adresse au service, puis lit l'e-mail reçu. | `list_threads`, `get_thread` | | Faire relire un envoi par son humain | Il laisse le message en brouillon. Son humain le valide depuis son assistant. | `send_email` avec `requires_approval`, `list_drafts`, `approve_message` | | Ne plus écrire à quelqu'un | Il bloque l'adresse. | `add_suppression` | | Envoyer depuis le domaine de son humain | Il enregistre le domaine, et donne à son humain les enregistrements DNS à publier. | `add_domain`, `verify_domain`, `create_inbox` | | Savoir où en est le forfait | Il lit la période, le volume parti et les factures. | `billing_status` | Les guides : [Répondre à un correspondant](https://subagent.fr/docs/guide-repondre.md), [Recevoir un code de vérification](https://subagent.fr/docs/guide-code.md), [Valider les envois d'un agent](https://subagent.fr/docs/guide-validation.md). ## Ce que le serveur règle Le rythme des envois est appliqué par le serveur, pas par le prompt de l'agent. | Règle | Seuil | |---|---| | Montée progressive | 5 e-mails par jour et par boîte la première semaine, puis 10, 15 et 20. | | Heures ouvrées | Par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, jours fériés exclus. | | Validation humaine | Un message peut rester brouillon jusqu'à la validation d'un humain. L'agent ne valide pas ses propres envois. | | Désinscription | Un lien en un clic dans chaque e-mail. Une réponse « STOP » bloque l'adresse. | | Coupe-circuit | Au-delà de 5 % de rebonds (3 % pendant la montée progressive) ou de 0,1 % de plaintes, la boîte est suspendue. | Un message retenu n'est pas une erreur : il attend, et la réponse du serveur donne son départ au plus tôt. Voir [Règles d'envoi](https://subagent.fr/docs/regles-envoi.md). ## Sa propre adresse - L'agent écrit depuis sa propre adresse. Les réponses reviennent dans ses fils. - La clé de l'agent n'ouvre que son espace. Elle ne donne accès à aucune autre boîte mail. - Un e-mail reçu est rendu à l'agent comme un contenu écrit par un tiers : il le lit, il ne le suit pas comme une consigne. Voir [Recevoir du courrier](https://subagent.fr/docs/recevoir.md#tiers). ## Les limites à connaître - **Avant le paiement, la boîte n'écrit qu'à son humain.** Elle reçoit et prépare des brouillons. - **La boîte du domaine commun ne fait que répondre.** Pour écrire le premier, il faut une boîte sur son domaine. - **Un forfait compte des boîtes et un volume d'e-mails par mois.** Au-delà du volume, un message attend la période suivante. - **Un message a un seul destinataire.** Pas de pièce jointe, pas de copie. - **Aucun message ne part tout de suite.** Il entre en file, puis part dans les heures ouvrées, selon le quota du jour de sa boîte. - **Le service ne promet aucun résultat de remise.** Il dit ce qui est parti, remis ou revenu. Tous les nombres : [Limites et quotas](https://subagent.fr/docs/limites.md). Ce que le service ne fait pas : [État du service](https://subagent.fr/docs/etat.md#hors-champ). ## Questions fréquentes ### Un agent IA peut-il avoir sa propre adresse e-mail ? Oui. `sign_up` lui ouvre une boîte `nom@subagentmail.fr`. Avec un domaine enregistré, la boîte porte le nom de ce domaine. ### Faut-il un nom de domaine ? Non, pour recevoir, répondre et préparer des brouillons. Oui, pour écrire le premier à quelqu'un : `add_domain` rend les enregistrements DNS à publier, `verify_domain` les contrôle. Un sous-domaine suffit. Voir [Domaines](https://subagent.fr/docs/domaines.md). ### L'agent peut-il s'inscrire sans humain ? Non, pas pour envoyer. L'agent appelle `sign_up` lui-même, mais sa boîte n'envoie rien avant le code à 6 chiffres reçu par un humain. ### L'agent peut-il lire les e-mails qu'il reçoit ? Oui. Toute boîte reçoit. Un e-mail reçu ouvre un fil, ou s'ajoute au fil de son correspondant. Voir [Recevoir du courrier](https://subagent.fr/docs/recevoir.md). ### Qui relit ce que l'agent envoie ? Un humain, si l'agent laisse ses messages en brouillon. La validation demande la permission `approve`, que la clé de l'agent ne porte pas : l'humain l'obtient en branchant son assistant à `https://api.subagent.fr/connect`. Voir [Brouillons et validation](https://subagent.fr/docs/brouillons.md). ### Combien ça coûte ? 9 €, 19 € ou 49 € par mois, pour 2, 5 ou 15 boîtes et 800, 2 000 ou 6 000 e-mails par mois. Prix nets : TVA non applicable, article 293 B du CGI. Voir [Prix et paiement](https://subagent.fr/docs/prix.md). ### L'agent peut-il payer lui-même ? Non. Il demande un lien de paiement avec `subscribe` et le remet à son humain, qui paie. ## Ensuite - [Démarrer](https://subagent.fr/docs/demarrer.md) : de l'adresse du MCP au premier e-mail. - [Pour les agents](https://subagent.fr/docs/agents.md) : la page à faire lire à un agent. - [Référence des outils](https://subagent.fr/docs/reference/index.md) : chaque outil, ses paramètres, son résultat.