Referencia
Plugins y skills de Emailit
El plugin oficial de Emailit para ChatGPT, Codex, Claude Code, Cursor y Grok incluye el servidor MCP alojado, skills y una regla que mantiene los secretos fuera del código.
El plugin de Emailit reúne todo lo que un asistente de IA necesita para trabajar con Emailit: una conexión al servidor MCP alojado, skills que enseñan al asistente cómo funciona Emailit y una regla de Cursor para manejar los secretos de forma segura. Es de código abierto y está en github.com/emailit/emailit-plugins (MIT).
Inicias sesión con tu cuenta de Emailit mediante OAuth y eliges qué espacios de trabajo puede usar el plugin: todos o solo los que selecciones. El plugin no guarda ninguna clave de API.
Qué incluye
| Parte | Qué hace |
|---|---|
| Servidor MCP | https://api.emailit.com/mcp con 109 herramientas para emails, dominios, DMARC, plantillas, listas de contactos, contactos, direcciones bloqueadas, campañas, automatizaciones, formularios, verificación, webhooks, eventos, claves de API y espacios de trabajo |
Skill emailit |
Elegir entre las herramientas MCP y la API REST, enviar de forma segura, ID, paginación, errores y la lista completa de herramientas |
Skill emailit-get-started |
Conectarse, confirmar el espacio de trabajo, comprobar un dominio y enviar un primer email de prueba |
Skill emailit-domain-setup |
Añadir un dominio, publicar los registros DNS en cualquier proveedor, verificarlos y corregir los registros que fallen |
Skill emailit-deliverability |
Rebotes, entrega en spam, direcciones bloqueadas, informes DMARC y verificación de listas, con respuestas basadas en los datos de tu cuenta |
Skill emailit-campaigns |
Listas de contactos, contactos, campañas, automatizaciones y formularios de suscripción, con envío seguro |
Skill emailit-webhooks |
Eventos, filtros, verificación de firmas, payloads por lotes, reintentos y depuración |
Skill emailit-sdk |
Código para producción con los SDK de Node.js, Python, PHP, Laravel, Go, Ruby, Java, .NET y Rust, además de SMTP |
| Regla de Cursor | Mantiene las claves de API de Emailit (secret_…) y los secretos de webhook (whsec_…) fuera del código fuente y los lee de EMAILIT_API_KEY y EMAILIT_WEBHOOK_SECRET |
Las skills se cargan bajo demanda: el asistente lee una skill cuando tu petición encaja con ella; por ejemplo, «¿por qué ha rebotado mi email?» carga emailit-deliverability.
Instalar
Abre Plugins, busca Emailit y elige Connect. Inicia sesión, elige los espacios de trabajo que quieres permitir y aprueba el acceso. Consulta ChatGPT.
codex plugin marketplace add emailit/emailit-pluginsAbre /plugins, instala Emailit e inicia sesión cuando se te pida. Consulta Codex.
claude plugin marketplace add emailit/emailit-plugins
claude plugin install emailit@emailit-pluginsEjecuta /mcp, selecciona emailit y elige Authenticate. En claude.ai, Claude Desktop y móvil, usa en su lugar el conector de Emailit. Consulta Claude.
Instala Emailit desde el Cursor Marketplace o con /add-plugin emailit y después elige Connect junto a emailit en Settings > MCP. Consulta Cursor.
grok plugin marketplace add emailit/emailit-plugins
grok plugin install emailit --trustEn grok.com, añade un conector personalizado con https://api.emailit.com/mcp. Consulta Grok.
Acceso y seguridad
- OAuth 2.1 con PKCE. El asistente nunca ve tu contraseña. Apruebas el acceso
sending(enviar y gestionar los emails enviados) o el accesofull(todo) y eliges los espacios de trabajo. - Confirmación antes de actuar. Las herramientas que envían emails, eliminan datos o llaman a URL externas están etiquetadas para que el cliente te pregunte antes, y las skills indican al asistente que pida confirmación.
- Revoca el acceso cuando quieras en AccountConnected apps.
- Los clientes sin interfaz, como la API de xAI y los jobs de CI, pueden enviar una clave de API de Emailit como
Authorization: Bearer <key>al mismo servidor. Usa una clave Sending Only siempre que puedas.
Endpoints que usa el plugin
El plugin solo se comunica con Emailit:
| Endpoint | Finalidad |
|---|---|
https://api.emailit.com/mcp |
Servidor MCP alojado (Streamable HTTP) |
https://api.emailit.com/.well-known/oauth-protected-resource/mcp |
Metadatos del recurso protegido OAuth |
https://api.emailit.com/.well-known/oauth-authorization-server |
Metadatos del servidor de autorización OAuth |
https://api.emailit.com/oauth/register |
Registro dinámico de clientes |
https://api.emailit.com/oauth/authorize |
Inicio de sesión y consentimiento |
https://api.emailit.com/oauth/token |
Canje y actualización de tokens |
https://api.emailit.com/oauth/revoke |
Revocación de tokens |
https://api.emailit.com/v2 |
API REST, que usa el código que la skill de SDK escribe en tu proyecto |
smtp.emailit.com:587 |
SMTP, solo si tu proyecto está configurado para usarlo |
Manifiestos
El repositorio incluye un manifiesto por cliente:
| Archivo | Lo lee |
|---|---|
plugin.json, mcp.json |
ChatGPT, Codex y otros clientes de Agent Plugins |
.cursor-plugin/ |
Cursor |
.claude-plugin/, .mcp.json |
Claude Code, el directorio de Claude y Grok |
.grok-plugin/plugin.json |
Grok |
.agents/plugins/marketplace.json |
El marketplace de Codex |
La referencia de herramientas de las skills se genera a partir del catálogo de herramientas del servidor MCP, la misma fuente que la referencia de herramientas de esta documentación, así que los nombres de herramientas que aparecen en las skills siempre existen en el servidor.