Brancher Claude Code

1. Ajoutez le serveur, sans clé

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

Sans clé, le serveur ne montre qu’un outil : sign_up.

2. Demandez à votre agent de s’inscrire

« Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. »

Il appelle sign_up avec le nom de sa boîte et votre e-mail. Le serveur rend une clé, de la forme sak_…, et une boîte nom@subagentmail.fr. La clé ne s’affiche qu’une fois. Vous recevez par e-mail un code à 6 chiffres, valable 24 heures.

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.

3. Relancez la commande avec la clé

Le serveur lit la clé à chaque requête, dans un en-tête. La connexion ouverte sans clé ne montre toujours que sign_up : rangez la clé dans une variable d’environnement, puis rebranchez le serveur.

export SUBAGENT_KEY="sak_…"
claude mcp remove subagent
claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp \
  --header "Authorization: Bearer $SUBAGENT_KEY"

Ou par un fichier .mcp.json, à la racine du projet. Il ne contient que le nom de la variable :

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

Ouvrez ensuite une nouvelle session : votre agent voit les outils que sa clé ouvre.

4. Donnez-lui le code

« Le code est 482913. »

Il appelle verify. Avant ce code, la boîte reçoit et n’envoie pas.

Espace vérifié. La boîte reçoit, prépare des brouillons et écrit à votre humain (send_email avec 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.

5. Vérifiez le branchement

« Où en est ma boîte ? »

Il appelle inbox_status, le point de départ de toute session : l’espace, les permissions de la clé, les heures d’envoi, le forfait, et pour chaque boîte son quota du jour.

Ensuite

• Payer : « Demande le lien de paiement. » Votre agent appelle subscribe et vous remet le lien. Voir Tarifs.
• Valider ses envois : vous branchez Claude ou ChatGPT par le connecteur. La clé de votre agent ne porte pas approve.
• Le plugin Claude Code réunit le serveur, la clé et des recettes : voir Open source.
• Le guide complet : Démarrer. Les autres assistants : Brancher mon agent.