MCPAgents

Utilisez votre propre agent.

Connectez Claude, ChatGPT, Gemini CLI, GitHub Copilot, Cursor ou votre propre code à une boîte mail, avec les mêmes contrôles que notre agent.

01

Avant de commencer

  • Une équipe MySendbox avec Agents activé, et au moins une boîte mail.
  • Un propriétaire de l'équipe pour valider la connexion.
  • Pour que l'agent réponde, et pas seulement lise : ouvrez les paramètres de la boîte mail dans le tableau de bord et réglez Who answers sur « Your connected agent » ou « Either ».

Pas encore de compte ? Ajoutez quand même le serveur et choisissez « Créer un espace de travail pour votre agent » quand on vous demande de vous connecter. Il lit tout de suite ; les réponses commencent avec le forfait.

02

Ajoutez le serveur à votre application

Le serveur utilise Streamable HTTP et se connecte via OAuth : la plupart des applications n'ont besoin que de l'URL.

URL du serveurClaude, ChatGPT
https://mcp.mysendbox.com/mcp
  • Claude (web et application de bureau) : ajoutez MySendbox depuis l'annuaire des connecteurs de Claude, ou allez dans Paramètres → Connecteurs → Ajouter un connecteur personnalisé et collez l'URL.
  • ChatGPT : ajoutez-le comme connecteur personnalisé (serveur MCP) avec la même URL.
Claude Code
claude mcp add --transport http mysendbox https://mcp.mysendbox.com/mcp
Gemini CLI
gemini mcp add --scope user --transport http mysendbox https://mcp.mysendbox.com/mcp
Ou dans les paramètres de Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "mysendbox": { "httpUrl": "https://mcp.mysendbox.com/mcp" }
  }
}

Lancez ensuite /mcp auth mysendbox dans Gemini CLI pour vous connecter et valider la connexion dans votre navigateur.

GitHub Copilot dans VS Code.vscode/mcp.json
{
  "servers": {
    "mysendbox": { "type": "http", "url": "https://mcp.mysendbox.com/mcp" }
  }
}

Cliquez sur Start au-dessus du serveur dans le fichier, connectez-vous quand VS Code le demande, puis utilisez-le depuis Copilot Chat en mode agent.

Cursor et autres clientsmcp.json
{
  "mcpServers": {
    "mysendbox": { "url": "https://mcp.mysendbox.com/mcp" }
  }
}
03

Validez la connexion

La première fois que l'agent se connecte, votre application ouvre une page sur app.mysendbox.com. Connectez-vous en tant que propriétaire, choisissez les boîtes mail que l'agent peut utiliser, puis son niveau d'accès :

  • Read : lire et rechercher des messages.
  • Draft : lire, ranger et rédiger des brouillons qu'une personne de votre équipe enverra.
  • Reply : lire, ranger et répondre. Les réponses sont vérifiées et, si elles sont risquées, attendent l'examen d'une personne.
04

Outils

Outilspar accès
read    list_mailboxes  list_messages  search_messages
        get_message  get_thread  get_attachment  get_reply
        account_status   → what it may do in each mailbox, credits
        wait_for         → the reply it's waiting for, as it arrives
        wait_for_code    → the code or link from a sign-up email
        list_threads     → where each conversation stands
draft   + mark_read  move_messages  draft_reply  draft_email
        + set_thread     → a note or a follow-up date on a conversation
reply   + send_reply   → sent, or waits for review
        + send_email   → a new email: waits for a person to approve it,
                         unless the mailbox sends on its own

Une inscription ou une connexion quelque part avec l'adresse de la boîte mail ? Envoyez le formulaire, puis appelez wait_for_code : il attend l'e-mail jusqu'à 30 secondes et renvoie son code à usage unique ou son lien de vérification.

Pour les messages qui attendent une réponse, filtrez par category: "personal". Les autres catégories sont updates, newsletters et promotions.

Une fois la connexion établie, demandez simplement :

read · search_messagesQu'est-ce qui est arrivé aujourd'hui sur support@ et attend encore une réponse ?
draft · draft_replyRédigez des réponses aux questions sur les commandes restées sans réponse, pour que je les vérifie.
read · wait_for_codeInscris-toi chez Acme avec bookings@ et termine la vérification par e-mail.
draft · move_messagesDéplacez les newsletters de cette semaine de la boîte de réception vers Archive.
reply · send_email · wait_forDemande un devis pour 40 chaises à trois fournisseurs, et dis-moi lequel est le moins cher quand ils répondent.

Vous attendez une réponse ? Juste après send_email ou send_reply, appelez wait_for avec le thread_id de la conversation : il renvoie la réponse dès qu'elle arrive, jusqu'à 30 secondes par appel, pour que votre agent ne relise pas la boîte de réception en boucle.

Chaque message arrive avec ses faits : dates, montants, numéros de suivi, invitation, et si quelqu'un pose une question. Souvent, cela suffit pour agir sans lire tout l'e-mail.

Les agents qui tournent sur un serveur peuvent plutôt être réveillés par un webhook message.received ; il contient les mêmes faits.

05

Des agents sans personne pour se connecter

Les serveurs et les scripts peuvent se passer d'OAuth et envoyer une clé API comme jeton bearer. Créez-en une dans le tableau de bord, sous API keys, avec les scopes dont l'agent a besoin, ou laissez l'agent s'inscrire lui-même et obtenir une clé avec sa propre boîte mail :

En-tête
Authorization: Bearer msb_live_…
  • messages:read pour lire, drafts:write pour rédiger des brouillons, replies:send pour répondre.
  • messages:write pour ranger : marquer comme lu et déplacer des messages.
06

Ce qui reste protégé

  • Des réponses, et de nouveaux e-mails approuvés par une personne. Une réponse va à la personne qui a écrit, dans le même fil, une par message. Un nouvel e-mail part de votre propre domaine vers 10 personnes au plus, et attend qu'une personne l'approuve, sauf si la boîte est réglée pour envoyer seule.
  • Mêmes contrôles, mêmes validations. Chaque réponse est contrôlée pour détecter les fuites et les instructions cachées dans l'e-mail. Les réponses risquées attendent une personne, quel que soit l'agent qui les a rédigées.
  • Le courrier extérieur reste à l'extérieur. Les messages parviennent à l'agent marqués comme non fiables, avec les résultats de leur contrôle. Les messages en quarantaine ne sont jamais affichés.
  • Chaque appel est enregistré. Chaque appel d'outil est journalisé avec l'agent, la boîte mail et le résultat. Les connexions sont limitées à 120 requêtes par minute, en plus des limites quotidiennes de chaque boîte mail.

Pour en savoir plus sur la façon dont nous gardons l'e-mail désiré : Sécurité.

07

Déconnecter

Les propriétaires voient chaque agent connecté sous Connect agent et peuvent le déconnecter immédiatement.