# Servidor MCP de Emailit

> Conecta ChatGPT, Claude, Cursor, Codex, Grok y otras herramientas de IA a Emailit con el servidor MCP alojado, el inicio de sesión con OAuth y toda la API v2 como herramientas.

El servidor MCP de Emailit conecta los asistentes de IA con tu cuenta de Emailit a través del [Model Context Protocol](https://modelcontextprotocol.io). Pide en lenguaje natural que envíe un email, añada y verifique un dominio, averigüe por qué ha rebotado un mensaje, cree una lista de contactos o lance una campaña, y el asistente llama a la herramienta de Emailit correspondiente.

Emailit aloja el servidor. No hay nada que instalar ni ninguna clave de API que pegar: inicias sesión en Emailit en tu navegador, eliges los espacios de trabajo que puede usar el asistente y apruebas el acceso.

| | |
| --- | --- |
| **URL del servidor** | `https://api.emailit.com/mcp` |
| **Transporte** | Streamable HTTP (sin estado, `POST`) |
| **Inicio de sesión** | OAuth 2.1 con PKCE, o una clave de API como token bearer |
| **Herramientas** | 109, que cubren toda la API v2 |
| **Descubrimiento** | `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` |

## Conectar tu herramienta de IA

| Cliente | Cómo conectarlo | Guía |
| --- | --- | --- |
| ChatGPT | Plugin de Emailit | [ChatGPT](/es/docs/mcp/chatgpt/) |
| Claude (claude.ai, Desktop y móvil) | Conector de Emailit | [Claude](/es/docs/mcp/claude/) |
| Claude Code | Plugin de Emailit o `claude mcp add` | [Claude Code](/es/docs/mcp/claude/#claude-code) |
| Cursor | Plugin de Emailit o **Add to Cursor** | [Cursor](/es/docs/mcp/cursor/) |
| Codex | Plugin de Emailit o `codex mcp add` | [Codex](/es/docs/mcp/codex/) |
| Grok | Conector de grok.com, plugin de Grok Build o la API de xAI | [Grok](/es/docs/mcp/grok/) |
| VS Code, Windsurf, Zed y otros | URL del servidor MCP remoto | [Otros clientes](/es/docs/mcp/other-clients/) |

Para cualquier otro cliente MCP, añade un servidor remoto (Streamable HTTP) con la URL `https://api.emailit.com/mcp`. Los clientes compatibles con la autorización de MCP encuentran automáticamente el inicio de sesión a partir de la URL de descubrimiento anterior, así que solo necesitan la URL.

Los [plugins de Emailit](/es/docs/mcp/plugins-and-skills/) para ChatGPT, Codex, Claude Code, Cursor y Grok añaden skills sobre el servidor: indicaciones que enseñan al asistente a configurar dominios, resolver problemas de entregabilidad, lanzar campañas, verificar webhooks y elegir un SDK.

## Qué ocurre al conectarte

1. **Inicia sesión.** Tu herramienta de IA abre una página de inicio de sesión de Emailit. Introduce tu email y tu contraseña, además del código de tu app de autenticación si usas la autenticación en dos pasos.

2. **Elige los espacios de trabajo.** Elige **All my workspaces**, que incluye los que crees o a los que te unas más adelante, o **Only these workspaces** con los que marques. Si permites más de uno, elige en cuál empieza la herramienta.

3. **Permite el acceso.** Revisa el acceso que pide la herramienta (`sending` o `full`) y selecciona **Allow access**.

La herramienta recibe un token de acceso que dura 15 minutos y un token de actualización que la mantiene conectada durante un máximo de 60 días de inactividad. Los tokens de actualización rotan con cada uso, y reutilizar uno antiguo revoca la conexión. Todas las conexiones aparecen en **Account → Connected apps**.

## Varios espacios de trabajo

Una conexión cubre todos los espacios de trabajo que hayas permitido, así que puedes gestionar varias marcas o cuentas de clientes desde el mismo chat. Indica el espacio de trabajo en tu petición:

> «En Acme Client, lista los dominios.»

El asistente pasa `workspace: "Acme Client"` solo a esa llamada de herramienta. Acepta un ID de espacio de trabajo o el nombre exacto del espacio de trabajo, y no cambia el espacio de trabajo por defecto de la conexión, así que dos chats que trabajan a la vez en espacios de trabajo distintos no interfieren entre sí.

- «¿Qué espacios de trabajo de Emailit puedes usar?» lista los espacios de trabajo permitidos y tu rol en cada uno.
- «Cambia a mi espacio de trabajo Marketing» cambia el espacio de trabajo por defecto para las peticiones posteriores que no indiquen ninguno.
- Para añadir o quitar espacios de trabajo, abre **Account → Connected apps** y elige **Edit access**. Los cambios se aplican en la siguiente petición de la aplicación, sin volver a conectarla.
- Si abandonas un espacio de trabajo o alguien te quita de él, la aplicación también pierde el acceso.

La herramienta trabaja con tu rol en cada espacio de trabajo, igual que el panel: los miembros no pueden gestionar claves de API ni eliminar dominios. Consulta [Espacios de trabajo y permisos](/es/docs/mcp/workspaces-and-permissions/).

## Niveles de acceso

| Permiso | Qué puede hacer la herramienta |
| --- | --- |
| `sending` | Enviar, programar, reprogramar, cancelar, reintentar y reenviar emails. Consultar el espacio de trabajo y cambiar de espacio de trabajo. |
| `full` | Todo lo que ofrece la API v2: dominios, informes DMARC, plantillas, claves de API, listas de contactos, contactos, direcciones bloqueadas, webhooks, campañas, automatizaciones, formularios, verificación de emails, eventos y creación de espacios de trabajo. |

La mayoría de las herramientas de IA piden ambos permisos. Si una conexión sin `full` llama a una herramienta que lo necesita, la herramienta devuelve un error que te pide volver a conectarte con acceso total. Los clientes compatibles con la autorización escalonada (step-up), como ChatGPT, vuelven a mostrar la pantalla de aprobación.

## Reducir la lista de herramientas

Algunos clientes limitan cuántas herramientas cargan. Añade estas opciones a la URL del servidor, o envíalas como cabeceras, para exponer menos herramientas:

| Opción | Consulta | Cabecera | Ejemplo |
| --- | --- | --- | --- |
| Solo algunos conjuntos de herramientas | `?toolsets=` | `X-MCP-Toolsets` | `emails,domains,events` |
| Ocultar las herramientas de escritura | `?read_only=true` | `X-MCP-Readonly` | `true` |

Por ejemplo, `https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true` da al asistente acceso de lectura solo a los emails y a los dominios. Las herramientas de espacios de trabajo se incluyen siempre. Para la lista completa, consulta [Conjuntos de herramientas y modo de solo lectura](/es/docs/mcp/toolsets/).

## Usar una clave de API

Los servidores, los scripts, los jobs de CI y los agentes sin interfaz gráfica no pueden abrir un navegador para iniciar sesión. [Crea una clave de API](/es/docs/developers/api-keys/) y envíala como token bearer:

```json title="mcp.json"
{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}
```

Una clave de API está vinculada al espacio de trabajo en el que se creó y no puede acceder a otros espacios de trabajo, y el servidor solo lista las herramientas que permite el permiso de la clave. En las aplicaciones de escritorio y de chat, usa preferentemente OAuth, porque una clave guardada en un archivo de configuración puede filtrarse.

## Desconectar una aplicación

Abre **Account → Connected apps**. La página lista todas las herramientas de IA y aplicaciones que has aprobado, con los espacios de trabajo que pueden usar, su nivel de acceso y cuándo se conectaron. Elige **Edit access** para cambiar sus espacios de trabajo o **Revoke access** para cortarle el acceso: sus tokens dejan de funcionar de inmediato. Consulta [Aplicaciones conectadas](/es/docs/account/connected-apps/).

> **Precaución:** Quitar el servidor de tu herramienta de IA no revoca su acceso en Emailit. Para eso, usa **Connected apps**.

## Seguridad

- **Herramientas etiquetadas.** Cada herramienta lleva anotaciones MCP (solo lectura, destructiva, mundo abierto), así que los clientes pueden pedir confirmación antes de ejecutar cualquier cosa que escriba, elimine o acceda al exterior.
- **Instrucciones integradas.** El servidor indica a los asistentes que confirmen los destinatarios, el remitente y el contenido antes de enviar emails reales, que busquen los ID en lugar de adivinarlos y que pregunten antes de eliminar o cancelar algo.
- **Contenido no fiable.** Los cuerpos de los emails, los campos de los contactos y las respuestas de los formularios pueden contener texto escrito por otras personas. Revisa lo que el asistente piensa hacer antes de aprobar un envío o una eliminación.
- **Comprobaciones de red.** Las URL de los webhooks se comprueban para que las peticiones no puedan llegar a redes privadas.
- **Se aplica tu rol.** Los asistentes nunca pueden hacer más que tú en cada espacio de trabajo.
- **Las claves, fuera del código.** No subas nunca claves de API al repositorio; la regla de Cursor del plugin de Emailit advierte de ello al agente.

## Próximos pasos

  - [Referencia de herramientas](/es/docs/mcp/tools/): Todas las herramientas con su tipo, su permiso y sus argumentos.
  - [Plugins y skills](/es/docs/mcp/plugins-and-skills/): Qué añaden los plugins de Emailit en cada cliente.
  - [Espacios de trabajo y permisos](/es/docs/mcp/workspaces-and-permissions/): Acceso a los espacios de trabajo, roles, permisos y tokens.
  - [Solución de problemas](/es/docs/mcp/troubleshooting/): Resuelve problemas de inicio de sesión, permisos, espacios de trabajo y carga de herramientas.

---
Fuente: https://emailit.com/es/docs/mcp/