IA y MCP
Traducir, redactar y resumir correo, conectar clientes de IA a tu buzón, llamar a herramientas MCP y preguntar a la documentación.
Comandos de IA
| Comando | Qué hace | Inicio de sesión |
|---|---|---|
| ai translate | Traducir un asunto y un cuerpo sin enviar nada | Cualquiera de los dos, con emails:send |
| ai languages | Listar cada idioma que acepta la traducción | Cualquiera, o ninguno: sin sesión muestra la tabla incluida en la CLI |
| ai compose "<prompt>" | Redactar el cuerpo de un correo con tu propio estilo | Un inicio de sesión con el navegador |
| ai summarize <thread-id> | Mostrar el resumen que OpenEmail guarda de un hilo | Un inicio de sesión con el navegador |
translate y compose gastan cada uno una acción de IA de la asignación diaria del espacio de trabajo, y una asignación agotada se detiene con el código de salida 8. compose y summarize pasan por las herramientas MCP composeEmail y getThreadSummary, por eso necesitan un inicio de sesión con el navegador: una clave de API no puede llegar al servidor MCP.
Traducir
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 portEjecuta la traducción que haría un envío traducido y muestra el resultado, para que lo leas antes de que salga nada. No se guarda ni se envía nada. --to admite un código, un nombre en inglés o el nombre propio del idioma. El cuerpo sale de --text, --html, --body-file o stdin, y --text y --html también leen un archivo con @path.
- Tu texto original se conserva debajo de la traducción, salvo que pases
--no-original. - El idioma de origen detectado se muestra en stderr, y
--jsonmuestra la traducción completa. - Para traducir al enviar, usa
openemail send --translate de.
Redactar y resumir
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 CAHk7pQ2x9LmZ4composemuestra un cuerpo redactado con tu estilo y no envía nada, así que pásalo aopenemail sendcuando te guste. Con--threadlee primero los últimos mensajes del hilo y redacta una respuesta.--tonees uno deformal,friendly,casual,concise,directowarm.summarizemuestra el resumen con el asunto, el remitente y la fecha. Los resúmenes se escriben cuando llega el correo, y un hilo que contiene un mensaje cifrado no tiene ninguno, lo que sale con el código5.
Conectar un cliente de IA
El servidor MCP de OpenEmail da a un cliente de IA las herramientas que usa el asistente de la app: puede leer y enviar correo y gestionar contactos, plantillas, dominios y más, limitado a lo que apruebes. Un cliente se conecta de una de dos formas, y openemail mcp config muestra ambas para tu cliente:
- El servidor remoto. El cliente hace su propio inicio de sesión con el navegador, lo apruebas en la página de consentimiento de OpenEmail y aparece en Cuenta → Aplicaciones conectadas. Es la opción más sencilla cuando el cliente la admite.
- El puente local,
openemail mcp serve, que el cliente arranca mediantenpx. Usa el inicio de sesión de esta CLI, así que ejecuta primeroopenemail login. Va bien con clientes que solo arrancan servidores locales.
openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --jsonclaude mcp add --transport http openemail https://api.openemail.uk/mcpclaude mcp add openemail -- npx -y @openemail/cli mcp serveDespués de añadir el servidor remoto, Claude Code inicia sesión desde /mcp y Codex con codex mcp login openemail. Claude Desktop lo añade en Settings → Connectors → Add custom connector. openemail mcp config --client <name> también dice qué archivo lee cada cliente.
El puente local
openemail mcp serve lee JSON-RPC delimitado por saltos de línea en stdin, reenvía cada mensaje al servidor MCP con tu inicio de sesión con el navegador guardado y escribe cada respuesta en stdout como una línea. Renueva un token de acceso caducado sin que el cliente lo note, responde a un lote como un único array y se detiene cuando stdin se cierra. Solo el protocolo llega a stdout, y stderr se mantiene en silencio salvo que pases --debug.
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.logEl puente no puede pedir un código de verificación por stdio. Una herramienta que lo necesita llega al cliente como un rechazo, y el puente muestra una sola pista en stderr. Ejecuta openemail verify en un terminal con el mismo perfil, y esas herramientas funcionan durante los 60 minutos siguientes.
Llamar a herramientas tú mismo
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 toolslista las herramientas que puede usar este inicio de sesión, que ya excluye las que tu rol o la aprobación no permiten. Nombra una herramienta para ver su descripción y sus argumentos.mcp callrecibe los argumentos como un objeto JSON en--args(en línea,@fileo-), y--arg key=valuefija uno cada vez. Un valor se lee como JSON cuando se puede analizar, así que pon entre comillas un número que quieras como texto.- El servidor MCP nunca pide confirmación, así que una herramienta que envía o elimina actúa al momento.
- Un resultado que empieza por
Refused (sale con el código4. Una herramienta desconocida sale con5, unos argumentos no válidos con7, y una asignación de IA agotada con8.
Seis herramientas hacen un cambio que la API REST protege con un código de verificación, y piden el mismo código: createRule, setRuleEnabled, removeDomain, removeDomainAddress, deleteAudience para una audiencia que creaste, y emptyAudience para una audiencia que creaste y que aún tiene contactos. En un terminal, mcp call pide el código y vuelve a llamar a la herramienta. Sin supervisión sale con el código 4, así que ejecuta primero openemail verify.
Preguntar a la documentación
openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs readdocs askhace una pregunta al asistente de la documentación y muestra la respuesta a medida que se escribe, y luego las páginas de las que salió. Responde solo a partir de esta documentación, no necesita iniciar sesión y nunca envía tus credenciales. Una pregunta puede tener hasta 600 caracteres, y cada red puede hacer un número limitado al día.docs openabre una página en tu navegador, y--printmuestra su enlace en su lugar.docs readmuestra una página en Markdown. Sin página, muestra el índice de todas las páginas.