Servidor MCP de Emailit

El servidor MCP de Emailit conecta los asistentes de IA con tu cuenta de Emailit a través del Model Context Protocol. 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.

Conectar tu herramienta de IA

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 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.

Niveles de acceso

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:

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.

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 y envíala como token bearer:

{
  "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.

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