Elastic Email MCP

oficial

El servidor MCP de Elastic Email permite que agentes de inteligencia artificial como GitHub Copilot, ChatGPT, Claude y otros asistentes compatibles se integren sin problemas con tu cuenta de Elastic Email.

Ver en elasticemail.com

¿Qué puedes hacer con Elastic Email MCP?

  • Gestionar contactos y listas — Pídele a tu asistente que agregue contactos a listas, cargue lotes de contactos, cree listas o elimine contactos de listas o de tu cuenta.
  • Crear y ejecutar campañas de correo electrónico — Haz que tu asistente cree, actualice, liste o pause campañas, y obtenga los detalles de campañas existentes cuando los necesites.
  • Enviar correos transaccionales y masivos — Indícale a tu asistente que envíe correos individuales o masivos a través de tu cuenta de Elastic Email.
  • Recuperar datos de la cuenta — Pídele a tu asistente que obtenga contactos, listas, plantillas o segmentos para que puedas revisar lo que está almacenado en tu cuenta.
  • Verificar la conectividad del servidor — Haz que tu asistente ejecute una verificación de estado para confirmar que la conexión MCP y el servicio de Elastic Email estén listos para usar.

Documentación

¡Nota! El video anterior muestra solo un método de autorización con clave de API.

La dirección del servidor MCP, https://mcp.elasticemail.com, se utiliza únicamente para conectar agentes de IA. No es la dirección de la API REST de Elastic Email y no puede usarse como host de API en otras integraciones. Para la dirección de la API, consulte el artículo "Configuración de API".

Al implementar MCP, Elastic Email permite que los agentes de IA accedan y controlen sus operaciones de correo electrónico mientras mantienen la seguridad y una autenticación adecuada.

Acciones disponibles que nuestro MCP podrá realizar por usted

  • Agregar contacto a una lista
  • Subir y agregar contactos
  • Crear una lista
  • Crear un segmento
  • Crear una campaña
  • Obtener campañas
  • Actualizar una campaña
  • Pausar una campaña
  • Listar campañas
  • Enviar correos electrónicos: tanto transaccionales como masivos
  • Obtener contacto, contactos, contacto de lista
  • Obtener listas
  • Obtener plantillas
  • Obtener segmentos
  • Verificar disponibilidad (verificación de salud, conexión y preparación)
  • Eliminar contacto de lista
  • Eliminar contacto de cuenta

Tenga en cuenta que no todos los endpoints listados están disponibles para todos los planes de precios de Elastic Email. Por ejemplo, los endpoints de campañas y contactos no están disponibles para los planes de Email API. Aquí está la lista completa de nuestros artículos disponibles sobre las funciones mencionadas anteriormente:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

Configuración

Para conectarse a nuestro servidor MCP, puede usar cualquier agente de IA que admita MCP. El requisito clave para cualquier configuración es el soporte del "modo agente", que permite que el agente de IA interactúe programáticamente con servicios externos de manera segura.

Hemos preparado un ejemplo de configuración paso a paso usando VS Code y las herramientas de Github Copilot.

A continuación, deberá conectar su cuenta de Github a VS Code

  • Autorice Visual Studio Code en Github Copilot

  • Permita ejecutar VS Code en el siguiente paso

  • Para mostrar la ventana de chat, vaya a Ver → Chat en el menú superior de VS Code. El chat debería mostrarse en el lado derecho.

  • Cambie el chat al modo Agente

  • Ahora puede usar uno de los dos métodos de autorización disponibles:

1. Cree una clave de API en Elastic Email. Los permisos requeridos para ver y modificar son los siguientes: Cuenta, Plantillas, Campañas, Contactos, Archivos, Enviar HTTP. Además de esto, se requiere al menos acceso de "vista" a los Tokens de Acceso. ¡Recuerde **nunca** compartir su clave de API con terceros no autorizados!

2. Use el método de autorización OAuth. Simplemente siga los siguientes pasos de instrucciones y omita agregar la sección de encabezados con X-Auth-Token. Cuando esté listo, inicie la conexión al servidor MCP: haga clic en Iniciar encima de elasticemail.mcp en el archivo de configuración y permita que VS Code se autentique a través de oidc.elasticemail.com.

Será redirigido a la página de inicio de sesión. Después de un inicio de sesión exitoso, será redirigido automáticamente de vuelta a VS Code. Si eso no sucede, siga las instrucciones mostradas en la página:

  • En la barra superior de VS Code, use la función de búsqueda para encontrar: Mostrar y ejecutar comandos
  • Puede escribir "MCP" en el campo de búsqueda para reducir las opciones disponibles y elegir "MCP: Abrir configuración de usuario".
  • Pegue el texto de configuración como se muestra a continuación (si ya tiene algunos servidores, solo los datos de elasticemail.mcp serán suficientes)
  • Use la sección de encabezados con su clave de API solo si desea usar el método de clave para la autorización. Elimínela si está usando el método OAuth.
{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

Tenga en cuenta que el paso más importante aquí es ingresar su clave de API real con los permisos mencionados anteriormente. También asegúrese de que después de modificar este campo, guarde los cambios antes de continuar. Sin guardar los cambios, la opción de "iniciar" la integración no aparecerá.

  • Ahora puede iniciar la conexión al servidor MCP: haga clic en Iniciar encima de elasticemail.mcp en el archivo de configuración.

A partir de ahora, puede usar las acciones proporcionadas por el servidor MCP de Elastic Email dentro de la ventana de chat. Estas acciones se describieron al principio de este artículo.

Puede probar su primer comando para asegurarse de que la integración funcione. Puede ingresar el mensaje "¿Está funcionando MCP?" como ejemplo y, si todo funciona, debería recibir una confirmación como respuesta.

Para comprender mejor cómo funciona este tipo de integración en el lado de Elastic Email, no dude en revisar también nuestra Documentación de API:

https://elasticemail.com/developers/api-documentation/rest-api

Consejos

  1. Los agentes de IA pueden quedarse atascados recordando algunas instrucciones anteriores y reintentándolas. Es útil iniciar una nueva sesión de chat para resolver tales problemas. También puede indicar al agente que vuelva a obtener las herramientas y decirle que ha habido cambios en el servidor para asegurarse de que realmente vuelva a obtener nuevos datos.
  2. Cuanto más preciso sea el mensaje, menos espacio de interpretación dejará al LLM, reduciendo los problemas relacionados con alucinaciones.
  3. Es útil revisar las solicitudes antes de enviarlas, ya que podría notar posibles inconsistencias en cómo el LLM tradujo su solicitud a llamadas de API.

Conexión de MCP en otros agentes de IA

La configuración anterior usa VS Code y GitHub Copilot, pero la misma dirección de servidor funciona con cualquier agente de IA que admita MCP y pueda ejecutarse en modo agente. Para un ejemplo paso a paso basado en Claude, consulte Cómo conectar el servidor MCP de Elastic Email a Claude.