Qué es el servidor MCP de Mailjet

El MCP de Mailjet es el asistente de IA Claude Desktop que lee datos de Mailjet desde tu cuenta usando tu clave API. Una vez configurado, puedes pedirle a Claude información sobre el rendimiento de campañas, listas de contactos o estadísticas y obtendrá la información a través de la API de Mailjet.

MCP (Model Context Protocol) es una forma para que herramientas de IA se conecten a servicios externos. El servidor MCP de Mailjet es un pequeño servicio que se ejecuta en tu computadora y expone las APIs de Mailjet a Claude. Esto permite que Claude responda preguntas usando datos en vivo de tu cuenta de Mailjet.

Qué necesitas antes de empezar

Esta configuración pide a un usuario no técnico realizar algunas tareas técnicas. Para facilitarlo, mostraremos las herramientas que necesitas y cómo instalarlas.

• Cuenta de Mailjet con una clave API y clave secreta activas
• Claude Desktop instalado 
• Git para descargar el servidor MCP de Mailjet desde GitHub
• Node.js para ejecutar el servidor MCP
• pnpm para instalar los archivos del servidor MCP
• Permiso para editar la configuración de Claude Desktop

Paso 1. Descargar el proyecto

Vas a descargar el servidor MCP de Mailjet desde el repositorio oficial en GitHub y entrar en esa carpeta.

1. Abre Terminal (Mac) o Símbolo del sistema (Windows).

2. Ejecuta:

   git clone https://github.com/mailgun/mailjet-mcp-server.git
   cd mailjet-mcp-server
   

El primer comando descarga el servidor MCP en una nueva carpeta. El segundo comando te mueve a esa carpeta para que los siguientes comandos funcionen.

Paso 2. Instalar las dependencias

Luego, instala los paquetes que el servidor necesita.

pnpm install

Paso 3. Iniciar (encender) el servidor MCP

Este paso inicia el programa MCP de Mailjet para que Claude pueda conectarse a él.

1. Asegúrate de estar todavía dentro de la carpeta mailjet-mcp-server.

2. Ejecuta:

   node src/mailjet-mcp.js
   

Esto lanza el servidor MCP de Mailjet en tu computadora. Puedes ver algunas líneas de texto. Eso significa que está funcionando.

Paso 4. Conectar Claude Desktop

Claude Desktop usa un archivo de configuración JSON para saber qué servidores MCP cargar. Añade el servidor MCP de Mailjet allí para que Claude pueda encontrarlo.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["/TU/RUTA/mailjet-mcp-server/src/mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "TU_clave_publica:TU_clave_privada"
      }
    }
  }
}

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["C:\\RUTA\\AL\\mailjet-mcp-server\\src\\mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "TU_clave_publica:TU_clave_privada"
      }
    }
  }
}

Variables de entorno

El servidor MCP de Mailjet soporta las siguientes variables de entorno.

Puedes definir estas variables en tu sistema o directamente en la configuración de Claude en la sección env.

Probar la configuración

El proyecto incluye un conjunto de pruebas local. Para ejecutarlo:

NODE_ENV=test pnpm test

Si las pruebas pasan sin errores, tu instalación está funcionando.

Solución de problemas

• Claude no muestra herramientas de Mailjet
  Verifica que la ruta en claude_desktop_config.json apunte al archivo real mailjet-mcp-server/src/mailjet-mcp.js. Reinicia Claude.
• Error de autenticación
  Asegúrate de que el valor API use el formato CLAVE_PUBLICA:CLAVE_PRIVADA. Si falta el colon, la autenticación falla.
• El servidor se cierra inmediatamente
  Ejecuta node src/mailjet-mcp.js desde dentro de la carpeta mailjet-mcp-server.
• Cuenta EU no carga
  Configura MAILJET_API_REGION=eu en tu entorno o en la sección env de la entrada de configuración de Claude.

Uso del MCP de Mailjet en Claude Desktop

Una vez que el servidor MCP esté funcionando y Claude Desktop se haya reiniciado, puedes empezar a usarlo.

1. Abre Claude Desktop.
2. Haz una pregunta relacionada con Mailjet, por ejemplo: ¿Cuál de mis listas de contactos tiene más suscriptores?.
3. Claude detectará que necesita contactar a Mailjet y mostrará un cuadro similar a: Claude quiere usar Get v3 liststatistics de mailjet.

4. Verás botones como Denegar, Permitir una vez, y Permitir siempre.

   • Permitir una vez permite que Claude haga esta única solicitud a Mailjet ahora.
   • Permitir siempre indica a Claude que puede usar el servidor MCP de Mailjet para solicitudes futuras sin pedir permiso otra vez.
   • Denegar bloquea la solicitud y Claude no obtendrá datos de Mailjet.

   

   1. Elige Permitir una vez si solo quieres probar la configuración
   2. Elige Permitir siempre si quieres que Claude ejecute la solicitud cada vez sin tener que pedir permiso nuevamente.

5. Después de permitir la solicitud, Claude llamará al servidor MCP de Mailjet, obtendrá los datos y responderá con el resultado, por ejemplo una lista de tus listas de contactos y sus cantidades de suscriptores.