Brancher

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.

AgentLa version texte de cette page est sur /demarrer.md. Le guide détaillé, outil par outil : /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é.

Demander une invitation

Écrivez à l’adresse ci-dessous, depuis l’e-mail que vous donnerez à votre agent : c’est lui qui recevra le code.

contact@subagent.fr

En trois étapes

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 ]

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

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

Cursor · .cursor/mcp.json

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

Autre client · .mcp.json

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

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

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

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

Autre client · .mcp.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.

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

Le même parcours, outil par outil, dans la documentation

La boîte d’essai

Une boîte sur le domaine commun, pour essayer.

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.

Les limites d’essai, dans le détail

Avant le code: La boîte reçoit. Elle n’envoie pas.
1^re heure: 3 destinataires distincts, au plus.
1^er jour: 5 destinataires distincts, au plus.
1^re semaine: 10 destinataires distincts, au plus. Ensuite, 10 par semaine.
Le compte: Chaque destinataire distinct compte une fois, un correspondant qui vous a écrit compris. Lui réécrire ne prend pas de place.
En plus: Les règles d’envoi : 5 e-mails par jour la première semaine, heures ouvrées, désinscription.

Votre domaine

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.

Domaines, dans la documentation

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.

Validation humaine

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.

Brouillons et validation

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.