mailprotector-mcp

MCP-Server für Mailprotector – E-Mail-Sicherheitsverwaltung für MSPs (CloudFilter, Bracket, SafeSend, XtraMail): Kunden, Domains, Benutzer, Quarantäne, Allow/Block-Regeln, Logs, Konfiguration und die vollständige Long-Tail-API über einen Router.

Basierend auf der MCP 2026-07-28-Spezifikation über das aufgeteilte v2 SDK (@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5) mit Dual-Era- Bereitstellung: Ein gemeinsamer McpServerFactory hinter createMcpHandler({ legacy: 'stateless' }) bedient sowohl 2025-Era-initialize-Handshake-Clients (heute das WYRE-Gateway) als auch moderne 2026-07-28-Envelope-Clients – mit einer identischen, deterministischen 22-Tool-Oberfläche für jeden Aufrufer. Wird nur als GHCR-Container ausgeliefert (kein MCPB-Bundle).

Tools (22 erstklassig + gerouteter Long Tail)

Router: mailprotector_status, mailprotector_list_categories, mailprotector_list_category_tools, mailprotector_execute_tool.

Promovierte Lesevorgänge: 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.

Promovierte Schreibvorgänge: mailprotector_customers_create, mailprotector_domains_create, mailprotector_messages_release / release_many (⚠ HOHE AUSWIRKUNG), mailprotector_allow_block_rules_create (⚠ HOHE AUSWIRKUNG) und das ⚠ ZERSTÖRERISCHE – UNWIDERRUFLICHE mailprotector_allow_block_rules_delete.

Router-Kategorien (52 geroutete Operationen über mailprotector_execute_tool): resellers (CRUD), customers (update/delete), domains (update/delete/move/aliases), user_groups (CRUD + services), users (create/create_many/update/delete/reset_password/aliases), managers (CRUD + Benachrichtigungsziele), configuration (update), statements, email_routing (Ziele/Quellen für Domain|user_group), user_syncs (CRUD + Zeitplan + Filter), notifications (Benutzer-Benachrichtigungsziele), results (find_by_code). Jeder geroutete Löschvorgang ist ⚠ ZERSTÖRERISCH und bestätigungsgeschützt; Schemas mit mailprotector_list_category_tools entdecken.

Bereichsbezogene Tools

Die Hierarchie von Mailprotector ist Anbieter → Wiederverkäufer → Kunde → Domain → Benutzergruppe → Benutzer, und viele Operationen existieren in mehreren Bereichen. Bereichsbezogene Tools akzeptieren scope (reseller | customer | domain | user_group | user, teilmengenabhängig) plus scope_id; scope_id standardmäßig auf den gebundenen Wiederverkäufer, wenn scope "reseller" ist.

Löschbestätigungen (MRTR-Elicitation)

Jeder Löschvorgang durchläuft die SDK v2 MRTR-Naht: Der Handler gibt input_required zurück, interaktive Clients sehen eine Bestätigungsaufforderung, und Ablehnen bricht den Löschvorgang ab. Aufrufer, die keine Elicitation-Fähigkeit deklariert haben – einschließlich zustandsloser 2025-Era-Aufrufer wie dem WYRE Conduit-Gateway – fallen zurück auf Fortfahren gemäß dem Integrationsvertrag: Elicitation ist hier rein additiv, und das Gateway erzwingt den Zugriff auf zerstörerische Tools mit seinem eigenen serverseitigen Tool-Klassifikationsgate.

Related MCP server: avanan-mcp

Anmeldeinformationen

Im Gateway-Modus wird eine Anfrage, der einer der beiden Header fehlt (oder die eine nicht-numerische Wiederverkäufer-ID enthält), mit 401 (JSON-RPC-Fehler -32001) beantwortet, bevor der MCP-Handler ausgeführt wird – sie fällt nie auf Umgebungsanmeldeinformationen zurück.

Ausführung

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 gemäß Fleet-Gesetz):

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

Wire-Hinweise (erwartetes Dual-Era-Verhalten)

• Legacy-Era-POST-Antworten sind SSE-gerahmt (text/event-stream) – parsen Sie die letzte data:-Zeile.

• Legacy-GET/DELETE-Sitzungsoperationen antworten mit 405: Zustandslose Bereitstellung hat keine Sitzungen.

Lizenz

Apache-2.0