# 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](/es/docs/mcp/), 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](https://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

**ChatGPT**

  Abre **Plugins**, busca **Emailit** y elige **Connect**. Inicia sesión, elige los espacios de trabajo que quieres permitir y aprueba el acceso. Consulta [ChatGPT](/es/docs/mcp/chatgpt/).

**Codex**

```bash
codex plugin marketplace add emailit/emailit-plugins
```

  Abre `/plugins`, instala **Emailit** e inicia sesión cuando se te pida. Consulta [Codex](/es/docs/mcp/codex/).

**Claude Code**

```bash
claude plugin marketplace add emailit/emailit-plugins
claude plugin install emailit@emailit-plugins
```

  Ejecuta `/mcp`, selecciona **emailit** y elige **Authenticate**. En claude.ai, Claude Desktop y móvil, usa en su lugar el conector de Emailit. Consulta [Claude](/es/docs/mcp/claude/).

**Cursor**

  Instala **Emailit** desde el Cursor Marketplace o con `/add-plugin emailit` y después elige **Connect** junto a **emailit** en **Settings > MCP**. Consulta [Cursor](/es/docs/mcp/cursor/).

**Grok**

```bash
grok plugin marketplace add emailit/emailit-plugins
grok plugin install emailit --trust
```

  En grok.com, añade un conector personalizado con `https://api.emailit.com/mcp`. Consulta [Grok](/es/docs/mcp/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 acceso `full` (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 **Account → Connected 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](/es/docs/mcp/tools/) de esta documentación, así que los nombres de herramientas que aparecen en las skills siempre existen en el servidor.

---
Fuente: https://emailit.com/es/docs/mcp/plugins-and-skills/