IA et MCP

translate et compose dépensent chacun une action d'IA sur l'allocation quotidienne de l'espace de travail, et une allocation épuisée s'arrête avec le code de sortie 8. compose et summarize passent par les outils MCP composeEmail et getThreadSummary, c'est pourquoi ils exigent une connexion par navigateur : une clé API ne peut pas atteindre le serveur MCP.

openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

Elle exécute la traduction qu'exécuterait un envoi traduit et affiche le résultat, pour que vous le lisiez avant que rien ne parte. Rien n'est stocké ni envoyé. --to prend un code, un nom anglais ou le nom de la langue dans cette langue. Le corps vient de --text, --html, --body-file ou stdin, et --text et --html lisent aussi un fichier avec @path.

• —Votre texte original est gardé sous la traduction, sauf si vous passez --no-original.
• —La langue source détectée est affichée sur stderr, et --json affiche la traduction complète.
• —Pour traduire à l'envoi, utilisez openemail send --translate de.

openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4

• —compose affiche un corps rédigé dans votre style et n'envoie rien, redirigez-le donc vers openemail send quand il vous convient. Avec --thread, il lit d'abord les derniers messages du fil et rédige une réponse. --tone vaut formal, friendly, casual, concise, direct ou warm.
• —summarize affiche le résumé avec l'objet, l'expéditeur et la date. Les résumés sont rédigés à l'arrivée du courrier, et un fil qui contient un message chiffré n'en a pas, ce qui sort avec le code 5.

Le serveur MCP d'OpenEmail donne à un client IA les outils qu'utilise l'assistant de l'application : il peut lire et envoyer du courrier et gérer contacts, modèles, domaines et plus encore, dans la limite de ce que vous approuvez. Un client se connecte de l'une de deux façons, et openemail mcp config affiche les deux pour votre client :

• —Le serveur distant. Le client effectue sa propre connexion par navigateur, vous l'approuvez sur la page de consentement d'OpenEmail, et il apparaît dans Compte → Applications connectées. C'est le choix le plus simple quand le client le prend en charge.
• —Le pont local, openemail mcp serve, que le client démarre via npx. Il utilise la connexion de cette CLI, lancez donc d'abord openemail login. Il convient aux clients qui ne démarrent que des serveurs locaux.

openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json

claude mcp add --transport http openemail https://api.openemail.uk/mcp

claude mcp add openemail -- npx -y @openemail/cli mcp serve

Après l'ajout du serveur distant, Claude Code se connecte depuis /mcp et Codex avec codex mcp login openemail. Claude Desktop l'ajoute sous Settings → Connectors → Add custom connector. openemail mcp config --client <name> indique aussi quel fichier chaque client lit.

openemail mcp serve lit du JSON-RPC délimité par des retours à la ligne sur stdin, transmet chaque message au serveur MCP avec votre connexion par navigateur enregistrée, et écrit chaque réponse sur stdout en une ligne. Il renouvelle un jeton d'accès expiré sans que le client le remarque, répond à un lot par un seul tableau et s'arrête quand stdin se ferme. Seul le protocole atteint stdout, et stderr reste muet sauf si vous passez --debug.

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'

• —mcp tools liste les outils que cette connexion peut utiliser, en excluant déjà ceux que votre rôle ou l'approbation n'autorisent pas. Nommez un outil pour voir sa description et ses arguments.
• —mcp call prend les arguments sous forme d'un objet JSON dans --args (en ligne, @file ou -), et --arg key=value en définit un à la fois. Une valeur est lue comme du JSON quand elle s'analyse, mettez donc entre guillemets un nombre que vous voulez comme texte.
• —Le serveur MCP ne demande jamais de confirmation, donc un outil qui envoie ou supprime agit aussitôt.
• —Un résultat qui commence par Refused ( sort avec le code 4. Un outil inconnu sort avec 5, des arguments invalides avec 7, et une allocation d'IA épuisée avec 8.

Six outils font un changement que l'API REST protège par un code de vérification, et demandent le même code : createRule, setRuleEnabled, removeDomain, removeDomainAddress, deleteAudience pour une audience que vous avez créée, et emptyAudience pour une audience que vous avez créée et qui contient encore des contacts. Dans un terminal, mcp call demande le code et rappelle l'outil. Sans surveillance, il sort avec le code 4, lancez donc d'abord openemail verify.

openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read

• —docs ask pose une question à l'assistant de la documentation et affiche la réponse au fil de sa rédaction, puis les pages dont elle vient. Il ne répond qu'à partir de cette documentation, ne demande aucune connexion et n'envoie jamais vos identifiants. Une question peut compter jusqu'à 600 caractères, et chaque réseau peut en poser un nombre limité par jour.
• —docs open ouvre une page dans votre navigateur, et --print affiche plutôt son lien.
• —docs read affiche une page en Markdown. Sans page, il affiche l'index de toutes les pages.