Connectez votre boîte à VS Code
et au mode agent de Copilot
Ajoutez une vraie boîte à l'éditeur que vous avez déjà ouvert. Lisez, recherchez, envoyez, répondez, transférez, planifiez et organisez vos e-mails depuis le mode agent de Copilot.
Lancez MCP: Add Server depuis la palette de commandes, choisissez HTTP et collez https://mcpemails.com/api/mcp. Démarrez le serveur depuis la vue MCP et autorisez quand on vous le demande. Aucune clé API n'intervient.
Comment VS Code se connecte : OAuth, sans clé API
VS Code exécute le flux OAuth MCP standard auprès de ce serveur. Il s'enregistre lui-même via l'enregistrement dynamique de client RFC 7591, donc aucun client ID à créer, et s'autorise avec un code d'autorisation plus PKCE en S256. Aucun secret client n'est jamais transmis, et le jeton ne porte que les autorisations que vous approuvez sur notre écran de consentement. Le jeton d'accès reçu dure une heure et se renouvelle tout seul ; il apparaît dans Dashboard, API Keys sous la forme OAuth: suivi du nom du client, et c'est là que vous révoquez la connexion.
La seule valeur dont vous avez besoin
Tout ce qui figure sur cette page sert à faire entrer cette URL dans VS Code.
| Champ | Valeur |
|---|---|
| URL du serveur MCP | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Authentification | OAuth 2.1, code d’autorisation avec PKCE. Aucune clé API. |
Comment connecter VS Code à votre boîte
Quatre étapes. Les deux premières sont les mêmes pour tous les clients, les suivantes sont propres à celui-ci.
Créez un compte gratuit et connectez une boîte
Inscrivez-vous sur mcpemails.com, sans carte bancaire, puis allez dans Dashboard, Inboxes, Connect Inbox. Outlook et Microsoft 365 se connectent via la connexion Microsoft ; Gmail, iCloud, Fastmail, Yahoo, Zoho et Yandex demandent un mot de passe d'application ; tout le reste se connecte en IMAP et SMTP standard. Le plan gratuit inclut une boîte, pour toujours.
Lancez MCP: Add Server
Ouvrez la palette de commandes avec Shift Cmd P, ou Shift Ctrl P sous Windows et Linux, et lancez MCP: Add Server.
Choisissez HTTP
Sélectionnez HTTP, collez https://mcpemails.com/api/mcp et donnez-lui un nom. VS Code écrit l'entrée ci-dessous dans .vscode/mcp.json.
Démarrez-le et autorisez
Démarrez le serveur depuis la vue MCP et terminez la connexion quand VS Code vous y invite. Approuvez les autorisations que Copilot doit détenir.
{
"servers": {
"mcpemails": {
"type": "http",
"url": "https://mcpemails.com/api/mcp"
}
}
}Documentation officielle de VS Code sur les serveurs MCP distants : https://code.visualstudio.com/docs/copilot/customization/mcp-servers
Vous préférez un guide complet ? L'e-mail pour les agents IA dans Cursor, Cline et VS Code
Vous ne savez pas quelle boîte connecter en premier ? Voir le tableau de compatibilité des fournisseurs
Ce qui fait trébucher avec VS Code
Le transport est bien HTTP, pas stdio, et une erreur échoue sans bruit
Le flux Add Server propose d'abord un serveur stdio lancé par une commande, ce que sont la plupart des serveurs MCP. Celui-ci est distant et hébergé, il n'a donc aucune commande à lancer. Choisissez HTTP, et notez que la clé de configuration est type avec la valeur http. Une entrée stdio pointée vers une URL produit un serveur qui ne démarre jamais, sans raison apparente.
Les outils n'apparaissent qu'en mode agent
Les outils MCP sont disponibles pour Copilot en mode agent. Si les outils e-mail manquent dans le sélecteur d'outils après une connexion réussie, la cause habituelle est d'être en mode ask ou edit plutôt qu'en mode agent. C'est dans la vue MCP qu'on vérifie que le serveur tourne vraiment.
Un .vscode/mcp.json est une configuration de dépôt, attention à ce que vous committez
L'emplacement par défaut se trouve dans le projet, ce qui veut dire qu'il peut être commité et partagé. L'URL est publique et les jetons OAuth ne sont pas écrits ici, donc la configuration par défaut peut être partagée sans risque. Ce n'est plus le cas dès que quelqu'un y écrit à la place une clé API bearer en clair. Toute clé qui atteint un dépôt doit être révoquée depuis Dashboard, API Keys.
Limites à connaître
- Les requêtes sont limitées à 100 par minute, 1 000 par heure et 10 000 par jour et par clé, en plus du plafond d'actions facturables de votre plan.
- Le serveur fonctionne uniquement en requête-réponse. Il n'y a ni webhooks ni événements déclenchés par le serveur, donc un nouveau message ne réveille jamais votre agent de lui-même. Pour réagir au courrier entrant, interrogez la boîte à intervalles réguliers.
- Le courrier est récupéré en direct chez votre fournisseur à chaque appel et n'est jamais stocké. Seul le jeton OAuth ou le mot de passe d'application chiffré est conservé, donc un jeton révoqué ou un mot de passe de boîte modifié coupe l'accès immédiatement.
VS Code et l’e-mail : vos questions
Comment connecter l'e-mail à VS Code ?
Lancez MCP: Add Server depuis la palette de commandes, choisissez HTTP, collez https://mcpemails.com/api/mcp, puis démarrez le serveur et autorisez quand on vous le demande. Le mode agent de Copilot dispose alors d'outils pour lire, rechercher, envoyer, répondre, transférer, organiser et planifier des e-mails.
Ai-je besoin d'une clé API pour VS Code ?
Non. VS Code exécute le flux OAuth dans le navigateur avec ce serveur, donc aucun jeton n'est écrit dans votre configuration. Une clé API bearer reste disponible pour un usage sans interface graphique ou scripté.
Est-ce que ça marche avec Copilot dans d'autres éditeurs ?
Cette page concerne spécifiquement VS Code, car le flux Add Server et le schéma de mcp.json sont des fonctionnalités de VS Code. JetBrains AI Assistant se configure séparément et utilise une clé API bearer au lieu d'OAuth ; il a sa propre page.
Quelles boîtes VS Code peut-il atteindre ainsi ?
Outlook.com et Microsoft 365 via la connexion Microsoft, où un compte professionnel peut nécessiter qu'un administrateur informatique approuve l'application une fois ; Gmail, iCloud, Fastmail, Yahoo, Zoho et Yandex avec un mot de passe d'application ; et toute autre boîte qui parle IMAP et SMTP sur les ports standard. Le client les voit toutes par la même connexion : votre agent appelle d'abord inbox_list pour découvrir chaque boîte connectée et son identifiant, donc aucun UUID à coller nulle part.
VS Code peut-il envoyer un e-mail sans que je le voie ?
Seulement si vous l'y autorisez. L'envoi dépend de l'autorisation send:email : une clé ou un jeton sans cette autorisation ne peut rien envoyer du tout. En plus, le propriétaire d'une boîte peut exiger une validation humaine dans le tableau de bord, qui retient chaque envoi, réponse, transfert, envoi de brouillon et envoi planifié jusqu'à ce qu'une personne le libère.
Mes e-mails sont-ils stockés sur vos serveurs ?
Non. Chaque message est récupéré en direct chez votre fournisseur pour la requête qui l'a demandé, puis transmis directement à votre client. Seul le jeton OAuth ou le mot de passe d'application chiffré est conservé, pour que les appels suivants puissent s'authentifier. Supprimer la boîte dans le tableau de bord, ou révoquer l'accès chez votre fournisseur, coupe la connexion aussitôt.
Donnez une vraie boîte à VS Code
Une commande, une connexion. Une boîte gratuite pour toujours, sans carte bancaire.