Guía práctica
Ejecutar el servidor MCP en local
Ejecuta el paquete de código abierto @emailit/emailit-mcp por stdio o por HTTP local con una clave de API, y configura Claude, Cursor y VS Code para usarlo.
@emailit/emailit-mcp es la versión de código abierto del servidor MCP de Emailit. Se ejecuta en tu equipo, se comunica con la API de Emailit con tu clave de API y funciona con los clientes que solo admiten servidores locales (stdio). La mayoría de los usuarios deberían usar en su lugar el servidor alojado; en esta página se explica cuándo tiene sentido el paquete local y cómo configurarlo.
- Paquete:
@emailit/emailit-mcpen npm - Código fuente: github.com/emailit/emailit-mcp, licencia MIT
- Entorno de ejecución: Node.js 18 o posterior
Local o alojado
| Paquete local | Servidor alojado | |
|---|---|---|
| Dónde se ejecuta | En tu equipo, lo inicia tu cliente MCP | En https://api.emailit.com/mcp |
| Inicio de sesión | Solo clave de API | OAuth o clave de API |
| Herramientas | El conjunto original: emails, dominios, claves de API, listas de contactos, contactos, plantillas, direcciones bloqueadas y webhooks | 109, toda la API v2, incluidas las campañas, las automatizaciones, los formularios, DMARC, la verificación y los eventos |
| Espacios de trabajo | El espacio de trabajo de la clave de API | Varios espacios de trabajo por conexión con OAuth, elegidos en cada petición |
| Roles y permisos | El permiso de la clave de API | Tu rol en cada espacio de trabajo y el permiso aprobado |
| Remitente y dirección de respuesta por defecto | Configurables | No disponibles; el asistente pasa from en cada envío |
| Actualizaciones | Tú controlas la versión que ejecutas | Automáticas |
Elige el paquete local cuando:
- tu cliente solo admite servidores stdio o no puede usar OAuth con servidores remotos,
- quieres que se aplique una dirección del remitente y una dirección de respuesta por defecto en todos los envíos, o
- quieres leer el código del servidor, fijar su versión o modificarlo.
Antes de empezar
- Node.js 18 o posterior, para tener disponible
npx. - Una clave de API. Usa una clave Sending Only, limitada a un dominio, si el asistente solo necesita enviar; las demás herramientas necesitan Full Access.
- Un dominio de envío verificado para la dirección del remitente.
Configurar tu cliente
El cliente inicia el servidor como subproceso y se comunica con él por stdio. Pasa la clave de API a través de la variable de entorno EMAILIT_API_KEY.
claude mcp add emailit \
-e EMAILIT_API_KEY=secret_•••••••• \
-e SENDER_EMAIL_ADDRESS=hello@acme.com \
-- npx -y @emailit/emailit-mcpAbre Settings > Developer > Edit Config, añade el servidor a claude_desktop_config.json y después reinicia Claude Desktop:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Añade el servidor a ~/.cursor/mcp.json o al .cursor/mcp.json de un proyecto:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Añade el servidor a .vscode/mcp.json. VS Code te pide la clave y la guarda de forma segura:
{
"inputs": [
{ "type": "promptString", "id": "emailit-api-key", "description": "Emailit API key", "password": true }
],
"servers": {
"emailit": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "${input:emailit-api-key}",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Usa siempre el nombre del paquete con ámbito, @emailit/emailit-mcp.
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
EMAILIT_API_KEY |
Para stdio | Tu clave de API de Emailit. En modo HTTP, los clientes envían en su lugar su propia clave. |
SENDER_EMAIL_ADDRESS |
No | La dirección del remitente por defecto, de un dominio de envío verificado. |
REPLY_TO_EMAIL_ADDRESSES |
No | Las direcciones de respuesta por defecto, separadas por comas. |
MCP_PORT |
No | El puerto del modo HTTP. Por defecto, 3000. |
Si no defines un remitente, el servidor pide al asistente una dirección del remitente en cada envío.
Opciones de la línea de comandos
Las opciones tienen prioridad sobre las variables de entorno equivalentes.
| Opción | Descripción |
|---|---|
--key <key> |
La clave de API para el modo stdio. |
--sender <email> |
La dirección del remitente por defecto. |
--reply-to <email> |
La dirección de respuesta por defecto. Repite la opción para indicar varias direcciones. |
--http |
Sirve Streamable HTTP en lugar de stdio. |
--port <port> |
El puerto para --http. Por defecto, 3000 o MCP_PORT. |
-h, --help |
Muestra la ayuda de uso. |
Ejecutar por HTTP
Para compartir un único servidor local entre varios clientes, inícialo en modo HTTP:
npx -y @emailit/emailit-mcp --http --port 3000El servidor escucha en http://127.0.0.1:3000/mcp y solo es accesible desde tu equipo. Cada cliente se autentica con su propia clave de API como token bearer:
claude mcp add emailit --transport http http://127.0.0.1:3000/mcp \
--header "Authorization: Bearer $EMAILIT_API_KEY"Ejecutar desde el código fuente
git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install
EMAILIT_API_KEY=secret_•••••••• node src/index.jsPara el modo HTTP, añade --http --port 3000 al último comando.
Solución de problemas
| Problema | Solución |
|---|---|
API key is required for stdio mode. Use --key or set EMAILIT_API_KEY. |
Añade EMAILIT_API_KEY al bloque env de la configuración de tu cliente. |
El cliente no puede iniciar npx |
Las aplicaciones de escritorio no siempre ven el PATH de tu shell. Usa la ruta completa de npx (búscala con which npx) como command. |
Domain not verified al enviar |
Usa un remitente de un dominio verificado o define SENDER_EMAIL_ADDRESS con uno. |
| Errores de permisos en las herramientas que no son de envío | La clave es Sending Only. Usa una clave Full Access para los dominios, las plantillas, los contactos y las demás herramientas. |
| No se puede cancelar un email programado | Los emails programados solo se pueden cancelar o reprogramar hasta 3 minutos antes de su hora de envío. |