SMTP (Email)

Das SMTP-Plug-in sendet E-Mails über einen SMTP-Server. Es hat zwei Rollen:

• Benachrichtigungen senden – E-Mails mit klickbaren Aktions-Buttons, z. B. für Freigaben aus der Human-in-the-Loop-Funktion von mcp-toolbox (funktioniert in jedem Mail-Client)
• E-Mails versenden – beliebige Nachrichten mit Text- oder HTML-Inhalt, Empfängern (To/CC/BCC), Antwort-Adresse, Kopfzeilen und Attachments

Typische Einsatzfälle: Freigabe-Anfragen per E-Mail zustellen, automatisch Berichte oder Alerts versenden, E-Mail-Versand aus Workflows heraus.

Einrichtung

Erstelle eine Instanz im Plug-in-Manager und trage die Zugangsdaten ein:

Feld	Bedeutung
Host	SMTP-Server, z. B. smtp.example.com (Pflicht)
Port	Server-Port, Standard 587 (ohne direkte TLS)
User	Optionaler Benutzer für die Anmeldung
Password	Passwort zu diesem Benutzer
Use TLS directly	Ob eine direkte TLS-Verbindung genutzt wird (z. B. Port 465)
From	Absender-Adresse, die verwendet wird (Pflicht)
Verify TLS certificate	Ob das TLS-Zertifikat geprüft werden soll (Standard: ja)

In den Einstellungen lassen sich zusätzlich Standard-Empfänger (to) sowie die maximale Attachment-Größe festlegen. Die Voreinstellungen (Timeout, STARTTLS) passen für die meisten Mail-Server.

Tools

Benachrichtigungen

Tool	Funktion
notify_send	Sendet eine Benachrichtigungs-E-Mail und rendert die übergebenen Aktions-Links als Buttons – z. B. „Freigeben“ / „Ablehnen“. Empfänger kommen aus dem Aufruf oder der Standard-Empfänger-Einstellung.

E-Mails senden

Tool	Funktion
smtp_send	Sendet eine E-Mail: Empfänger (To/CC/BCC), Betreff, Text- und/oder HTML-Inhalt, optionale Absender-Adresse, Antwort-Adresse, zusätzliche Kopfzeilen sowie Attachments (Inhalt als Base64).
smtp_verify	Verbindet sich mit dem Server und prüft Anmeldung und Konfiguration.

Typische Arbeitsabläufe

Versand prüfen

1. smtp_verify – Verbindung, TLS und Anmeldung testen.
2. Bei Fehlern: Instanz-Konfiguration prüfen (Host, Port, secure für Port 465, STARTTLS für 587).

Einfache E-Mail senden

1. smtp_send mit to (eine Adresse oder kommasepariert), subject und text- oder html-Inhalt angeben.
2. Optional CC/BCC sowie eine abweichende from-Adresse mitgeben.
3. Im Ergebnis stehen messageId sowie akzeptierte/abgelehnte Empfänger.

E-Mail mit Anhang senden

1. Datei-Inhalt als Base64 kodieren.
2. smtp_send mit attachments: [{ filename, content (Base64), contentType }] aufrufen.
3. Größen-Limit (Instanz-Einstellung) beachten – zu große Attachments werden abgelehnt.

Freigabe anfordern

1. notify_send mit message und actions aufrufen – jede Aktion ist ein Link mit label und url (optional mit Stil-Angabe).
2. Die Empfänger per to angeben oder die Standard-Empfänger der Instanz nutzen.
3. Die Empfänger können die Freigabe direkt per Klick auf die Buttons erteilen oder ablehnen.

Hinweise für KI-Agenten

• Keine Secrets in E-Mails: Keine Passwörter, Tokens oder Schlüssel in Betreff, Inhalt oder Anhängen platzieren – E-Mails sind keine sicheren Kanäle.
• Empfänger bestimmen: notify_send nutzt to aus dem Aufruf, danach die Standard-Empfänger-Einstellung der Instanz. Vor dem Versand prüfen, an wen die Nachricht geht.
• TLS-Konfiguration: Für Port 465 secure aktivieren, für Port 587 bleibt es aus (STARTTLS wird dann automatisch angefordert). Nach einer Fehlkonfiguration hilft smtp_verify zur Diagnose.
• Attachments sind Base64: Der Inhalt muss als Base64-kodierter String übergeben werden; die Größe ist über die Instanz-Einstellung begrenzt. Nach dem Versand über das Ergebnis prüfen, ob alle Empfänger angenommen wurden.