mailprotector-mcp

Servidor MCP para Mailprotector — gestión de seguridad de correo electrónico para MSPs (CloudFilter, Bracket, SafeSend, XtraMail): clientes, dominios, usuarios, cuarentena, reglas de permitir/bloquear, registros, configuración y la API completa de larga cola a través de un enrutador.

Construido sobre la especificación MCP 2026-07-28 mediante el SDK v2 dividido (@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5) con servicio de doble era: un McpServerFactory compartido detrás de createMcpHandler({ legacy: 'stateless' }) responde tanto a clientes de la era 2025 que usan el handshake initialize (el gateway WYRE hoy) como a clientes modernos de la envoltura 2026-07-28 — con una superficie de 22 herramientas idéntica y determinista para cada llamante. Se distribuye únicamente como contenedor GHCR (sin paquete MCPB).

Herramientas (22 de primera clase + larga cola enrutada)

Enrutador: mailprotector_status, mailprotector_list_categories, mailprotector_list_category_tools, mailprotector_execute_tool.

Lecturas promovidas: mailprotector_customers_list/get, mailprotector_domains_list/get, mailprotector_users_list/get/find_by_address, mailprotector_user_groups_list, mailprotector_messages_list, mailprotector_allow_block_rules_list, mailprotector_logs_list, mailprotector_configuration_get.

Escrituras promovidas: mailprotector_customers_create, mailprotector_domains_create, mailprotector_messages_release / release_many (⚠ ALTO IMPACTO), mailprotector_allow_block_rules_create (⚠ ALTO IMPACTO), y la ⚠ DESTRUCTIVA — IRREVERSIBLE mailprotector_allow_block_rules_delete.

Categorías del enrutador (52 operaciones enrutadas vía mailprotector_execute_tool): resellers (CRUD), customers (actualizar/eliminar), domains (actualizar/eliminar/mover/alias), user_groups (CRUD + servicios), users (crear/crear_muchos/actualizar/eliminar/restablecer_contraseña/alias), managers (CRUD + destinos de notificación), configuration (actualizar), statements, email_routing (destinos/orígenes para dominio|grupo_de_usuarios), user_syncs (CRUD + programación + filtros), notifications (destinos de notificación de usuario), results (buscar_por_código). Cada eliminación enrutada es ⚠ DESTRUCTIVA y requiere confirmación; descubre esquemas con mailprotector_list_category_tools.

Herramientas con ámbito

La jerarquía de Mailprotector es Proveedor → Revendedor → Cliente → Dominio → Grupo de Usuarios → Usuario, y muchas operaciones existen en varios ámbitos. Las herramientas con ámbito aceptan scope (reseller | customer | domain | user_group | user, subconjuntos por herramienta) más scope_id; scope_id por defecto es el revendedor vinculado cuando scope es "reseller".

Confirmaciones de eliminación (solicitud MRTR)

Cada eliminación pasa por la costura MRTR del SDK v2: el manejador devuelve input_required, los clientes interactivos ven un aviso de confirmación, y rechazar cancela la eliminación. Los llamantes que no declararon capacidad de solicitud — incluidos los llamantes sin estado de la era 2025, como el gateway WYRE Conduit — se retrotraen a proceder según el contrato de integración: la solicitud aquí es puramente adicional, y el gateway aplica el acceso a herramientas destructivas con su propia compuerta de clasificación por herramienta en el servidor.

Related MCP server: avanan-mcp

Credenciales

En modo gateway, una solicitud que falte cualquiera de las cabeceras (o tenga un id de revendedor no numérico) recibe un 401 (error JSON-RPC -32001) antes de que se ejecute el manejador MCP — nunca cae a las credenciales de entorno.

Ejecución

export NODE_AUTH_TOKEN=$(gh auth token)   # GitHub Packages auth for @wyre-technology/*
npm install
npm run build
node dist/index.js                        # stdio (default)
MCP_TRANSPORT=http node dist/index.js     # HTTP on :8080 (/mcp, /health)
node scripts/smoke-dual-era.mjs           # proves both protocol eras serve the same tools

Docker (linux/amd64 según la ley de flota):

docker build --platform linux/amd64 --build-arg NODE_AUTH_TOKEN=$(gh auth token) -t mailprotector-mcp .
docker run -p 8080:8080 -e AUTH_MODE=env \
  -e MAILPROTECTOR_API_KEY=... -e MAILPROTECTOR_RESELLER_ID=... mailprotector-mcp

Notas sobre el cable (comportamiento esperado de doble era)

• Las respuestas POST de la era heredada están enmarcadas en SSE (text/event-stream) — analice la última línea data:.

• Las operaciones GET/DELETE de sesión de la era heredada responden 405: el servicio sin estado no tiene sesiones.

Licencia

Apache-2.0