techtv-mail — ein Cowork-Konnektor für pete@techtv.live

Dies ist ein kleiner MCP-Server, der es Claude (Cowork) ermöglicht, E-Mails über Ihr cPanel-gehostetes Postfach pete@techtv.live zu lesen und zu senden – genau so, wie es bereits mit Ihren Microsoft-365- und Gmail-Konten funktioniert, nur eben speziell für dieses Postfach gebaut, da Anthropic keinen vorgefertigten Konnektor für generische IMAP/cPanel-Mail anbietet.

Er stellt Claude vier Werkzeuge zur Verfügung:

• list_folders – ansehen, welche Mailordner existieren

• search_emails – einen Ordner nach Absender, Betreff, Textinhalt oder Aktualität durchsuchen

• get_email – den vollständigen Text/HTML einer Nachricht abrufen

• send_email – E-Mail als pete@techtv.live senden

1. Deployment auf einen immer erreichbaren Server

Das muss auf einem kleinen Server laufen, der rund um die Uhr über das öffentliche Internet erreichbar ist – es kann weder auf dem eigenen Computer noch in einer Claude-Sitzung laufen, da beide offline gehen. Die günstigsten und einfachten Optionen für etwas so Kleines:

• Railway (railway.app) – kostenlose/vergünstiger Tarr, deployst direblue aus eineem ZIP-Archiv oder einem GitHub-Repo und setzt leist PORT automatisch.

• Render (render.com) – ähnlich, hat einen kostenlosen Tarif für kleine Bendienste (kann im kostenlosen Tarif beinak­tivität schlafen, was die erste Anfr age nach einer Weile um ein paar Sekun­den ver­zögert).

• Ein kleinen VPS, den Sie bereits beitzen, falls Sie es lieber selbst betreiben.

Je nachdem, für welches Sie sich entscheiden, die Schritte sind immer gle:

1. Laden Sie diesen Ordner hoch (oder pushen Sie ihn in ein GitHub-Repo und verbinden Sie dies Repo).

2. Stetlen Sie ein, dass npm install ausgeführt wird, dann npm start (oder node server.js).

3. Setzen Sie die unmgebene Umgebungs­variabl­en im Dashboard des Hosters – ge­ben Sie echte Zugangs­daten nie­mals in den Code oder con­men Sie in Git.

4. Sobald das Deploy­ment ab­geschlosen ist, gibt Ihnen der Host eine öffentliche URL, z.B.:

   https://techtv-mail-publication.up.railvalway.app.

Related MCP server: IMAP MCP Server

2. Umgebungsvariablen, die auf dem Host zu setzen sind

Um einen guten ACCESS_TOKEN zu erzeugen, führen Sie dieses einen beliebigen Computer mit Node aus – oder nutzzen Sie einen Passwörter gen­erator für etwa 40+ zufällige Zeichen:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Die­ser Token wird Teil der Server-URL und ist das einzige, was zǫschen dem öffentlichen Internet und Ihrem Postfach steht. Be­handeln Sie ihn also genau wie ein Passwort: lang, zu­fällig, nie teilen, nie öffentlich pos­ten.

3. Als benutzer­definierten Konnektor zu Cowork hin­zfügen

Sobald deployed, in der Claude-App:

1. Gehen Sie zu **Customize > Connek­tors (oder click-en "+" / typp "/" in ein Chat und wählen Manage connekors).

2. Klicken Sie auf +, um es zu druchblät­tern, dann Add custom connektor.

3. Ge­ben Sie für die Server-URL ein:

   https://<your-host-domain>/mcp/<ACCESS_TOKEN>

   (beide Teile stam­men von Ihrem De­ploy­ment – die Domäne, die Ihr Host Ihnen gegeben hat, und den Token, den Sie als Ungebungs­variable fest­gelegt haben).

4. Lassen Sie die Felder OAuth -lient ID/Sekret leer – dieser Server ver­wendet kein OA­h, der Token in der URL ist der Zugriffs­schutz.

5. Save / Con­nect. Claude sollte die Tools list_files, search_emails, get_email und send_email jetzt als verfügbare Tools listen, sobal­d diesen Konnek­tor in einem Chat aktiv ist.

Sicherheithinweise

• Das Postfach-Passwort liegt nur in den Umgebungsvariablen des Host – nie in diesem Cod, nie in einem Chat mit Claude.

• Jeder, der die volle Konnektor-URL (mit Token) erhält, könnte diese Tools für das Postfach nutzen. Ver­ö­fen­llichen Sie diese URL nie­nds (gemeinsames Dok, öffentliches Repo, Slack-Kanal, den an­dere sehen).

• Falls Sie den URL einmal wiesen muss, er­zeugen Sie einen neuen ACCESS_TOKEN, aktual­isieren Sie ihn am Host und erneut­eres Sie die neue URL in der Kon­nek­tor­ein­stellungen von Coworks - die alte URL funktoniert sofort nicht mehr.

• Das wirk­liche Passwort des Mailboxes sollte au­ßem in Ihrem Passwortmanager wie ge­wöhnlich bleiben; dieser Node braucht es nur ein­mal beim De­ploy­ment als Umgebungs­variable.

Lokaler Test (optional, vor dem Deploy­ment)

Sie können es lokalststarten, um sic­zwücklichen zu stellen, dass die echten Echtgangs daten funktionieren:

npm install
MAIL_HOST=mail.techtv.live IMAP_PORT=993 SMTP_PORT=465 \
EMAIL_USER=pete@techtv.live EMAIL_PASS='<real password>' \
ACCESS_TOKEN=test123 PORT=3000 node server.js

Dann in einem an­deren Terminal:

curl -s -X POST http://localhost:3000/mcp/test123 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Eine gelun­gene Antwort sieht wie ein result-Block aus, der den Server nennt – falls statt­dessen Auth­en­fehler auftreten, prüfen Sie EMAIL_PASS und ob IMAP/SMTP-Zu­griff für dieses Post­fach in „pannel" nicht blockiert ist.