Brancher Cursor

1. Déclarez le serveur, sans clé

Le fichier est .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json pour tous vos projets.

{
  "mcpServers": {
    "subagent": {
      "url": "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. Ajoutez la clé au fichier

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 ajoutez l’en-tête. Le fichier ne contient que le nom de la variable.

export SUBAGENT_KEY="sak_…"

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

Rechargez ensuite le serveur dans Cursor : 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 guide complet : Démarrer. Les autres assistants : Brancher mon agent.