Conecta tu email a un agente de IA
Un agente de IA puede enviar, consultar y gestionar tu cuenta de Vemudo con el Model Context Protocol, con exactamente los permisos que le des al conectarlo.
Revisado el
Qué puede hacer un agente
read , send y full :
Con scope read, el agente consulta sin poder escribir nada: cuenta y uso del plan (get_account), estadísticas (get_stats), historial de emails y eventos (list_emails,get_email_events), campañas (list_campaigns,get_campaign), dominios (list_domains,get_domain), contactos y listas (list_contacts,get_contact,list_lists,list_segments), plantillas (list_templates,get_template), bajas (list_suppressions) y webhooks (list_webhooks): 16 herramientas en total, ninguna de envío.Con scope send(sinread), el agente gana exactamente tres herramientas:send_email,send_batch(hasta 100 destinatarios en una llamada) ycancel_email(cancelar un email programado, con confirmación explícita). Una clave solosendno desbloquea las 16 herramientas de consulta de arriba: el agente puede enviar, pero no ver tus estadísticas, campañas, dominios ni contactos.Con scope full, el agente suma las dos listas anteriores: las 21 herramientas, consulta y envío.Con cualquier scope, incluido solo reado solosend, hay dos herramientas siempre disponibles:whoami(qué clave, plan y límites quedan) yget_email(estado de un email concreto).
mcp:write ), crear y cambiar dominios, plantillas, contactos, listas, bajas, webhooks y campañas, incluido enviarlas; con «Gestionar claves API» ( mcp:keys ), listar, crear y revocar claves. Esas herramientas no existen con una clave de API: una clave no gestiona claves. Lo que un agente no puede hacer de ninguna forma es cambiar la facturación: eso sigue siendo solo del panel.
Dos formas de conectarlo
npx -y @vemudo/mcp , con la variable de entorno VEMUDO_API_KEY y transporte stdio: es la que ya documenta la guía MCP . En cuanto el paquete esté publicado en npm, instalarlo será tan sencillo como ejecutar ese comando; mientras tanto sigue en desarrollo.
https://api.vemudo.com/mcp , hablando JSON-RPC 2.0 sin sesiones ni SSE ( protocolVersion 2025-06-18 ). Se habilitará junto con el resto del despliegue de producción, así que de momento no hay URL activa ni fecha que prometer.
test o live y permisos, sin copiar ninguna clave. Las conexiones se verán y se revocarán en el panel, en «Claves de API > Conexiones de IA». La otra es una clave de API en la cabecera Authorization: Bearer vm_live_… , que solo da las 21 herramientas de consulta y envío.
Clientes compatibles
claude.ai y Claude Desktop: con el MCP remoto, como conector personalizado con la URL del servidor y OAuth; también en Claude Desktop con el paquete local. Claude Code: con claude mcp add --transport httpy la URL del MCP remoto (autorizas con/mcp), o con el paquete local.Codex: con la URL del MCP remoto en su config.tomlycodex mcp login.Cursor y VS Code: se añaden desde los ajustes de extensiones o servidores MCP del editor. Otros clientes MCP: cualquiera que ejecute un servidor por stdio con una variable de entorno sirve igual.
Qué permisos darle
read: solo consultar. El agente no puede enviar, cancelar ni modificar nada.send: enviar y consultar lo que esa misma clave ha enviado.full: todo lo anterior, más las escrituras sobre bajas y webhooks.
test o live : una clave test no envía correo real, así que es el entorno recomendado para probar un agente nuevo antes de darle una clave live .
mcp:read ), «Enviar emails» ( mcp:send ), «Gestionar la cuenta» ( mcp:write ) y «Gestionar claves API» ( mcp:keys ). La pantalla solo ofrece los que permite tu rol y cada conexión trabaja en un único entorno. Si el agente crea una clave, su secreto aparece una sola vez en la conversación y pasa por tu proveedor de IA. La tabla completa está en la guía MCP .
Límites de la API por plan
| Plan | Peticiones/min por clave | Unidades de coste/día | Peticiones simultáneas | Claves activas |
|---|---|---|---|---|
| Inicio | 120 | 10.000 | 3 | 3 |
| Beta | 240 | 20.000 | 5 | 5 |
| Crece | 300 | 50.000 | 5 | 10 |
| Pro | 600 | 150.000 | 10 | 25 |
429 con una cabecera Retry-After . Para más de 400.000 emails al mes hay un plan Empresa a medida: sus límites de API se acuerdan caso por caso y no están en esta tabla.
Seguridad y buen uso
Si tu clave está bloqueada o tu organización tiene los agentes bloqueados, cada llamada responde 403y deja de funcionar hasta resolverlo con soporte.Hay un interruptor de plataforma que puede bloquear todos los agentes de una organización sin tocar el resto del envío. El uso de cada clave (peticiones, coste consumido) se ve en tu panel, en la sección de claves de API.
Preguntas frecuentes
¿Necesito instalar algo para conectar un agente?
Depende de la vía: el paquete local se instala con npx cuando esté publicado en npm; el MCP remoto, cuando esté activo, no instala nada: basta con su URL y autorizar en el navegador, o con una clave.
¿El MCP remoto ya funciona?
Todavía no: se habilita junto con el resto del despliegue de producción. Mientras tanto, la vía documentada es el paquete local por stdio.
¿Qué permiso debería dar al agente?
Empieza por el permiso de solo lectura en entorno de pruebas, tanto con una clave como con OAuth. Si necesitas que envíe o que gestione la cuenta, añade ese permiso solo cuando ya lo hayas probado así.
¿Puede el agente crear claves de API?
Solo si lo conectas con OAuth y le das el permiso de gestionar claves. El secreto de la clave nueva aparece una sola vez en la conversación, así que pasa por tu proveedor de IA; para claves de producción sensibles, créalas desde el panel.
¿Qué pasa si la plataforma bloquea los agentes de mi organización?
Cada llamada del agente responde con un 403, tanto por el paquete local como por el MCP remoto, hasta que soporte levante el bloqueo; el resto de tu cuenta (panel, envío, campañas) sigue funcionando con normalidad.
¿Qué pasa si el agente hace demasiadas peticiones?
La API responde con un código de límite superado en cuanto se pasa el tope por minuto o el de coste diario de tu plan; el agente debe esperar antes de reintentar.
Prueba Vemudo en la beta
Pide acceso, conecta tu dominio y envía. Revisamos cada cuenta antes de activarla.