KlickTipp für KI-Agenten

Installieren

Voraussetzung ist ein KlickTipp-Konto. In Claude Code:

claude plugin marketplace add klicktipp/agent-plugins
claude plugin install klicktipp@klicktipp
claude mcp login plugin:klicktipp:klicktipp

In Codex zeigst du die Plugin-Konfiguration auf das Verzeichnis plugins/klicktipp des Repositories. Beide Varianten lesen dieselbe .mcp.json und sprechen denselben Endpunkt: https://mcp.klicktipp.com/mcp.

Die einmalige Anmeldung

Im Paket steckt kein Schlüssel und kein Token. Der Endpunkt liegt hinter OAuth: beim ersten Zugriff öffnet sich ein Browserfenster, du meldest dich mit deinen KlickTipp-Zugangsdaten an und bestätigst den Zugriff. Danach wird das Token gespeichert und selbstständig erneuert — pro Rechner einmal.

Vor der Anmeldung antwortet der Server mit 401. Die Werkzeugliste kann leer bleiben und Aufrufe scheitern mit einem Authentifizierungsfehler. Das ist der erwartete Vorlauf der Anmeldung und kein Defekt — melde dich an, statt die Konfiguration zu ändern.

Der Server eines installierten Plugins ist eine eigene Verbindung mit eigenem, vorangestelltem Namen. claude mcp login klicktipp allein wird abgelehnt; es muss plugin:klicktipp:klicktipp sein. In Claude Code führt /mcp zum selben Ziel.

Was das Plugin mitbringt

Werkzeug	Wofür
`email-newsletter-search`	Newsletter finden, neueste zuerst, nach Name und Versandzustand eingegrenzt
`email-newsletter-get`	einen lesen; Projektionen liefern Metadaten, Empfängerkreis, Inhalt, Versandkonfiguration und Versandstand
`email-newsletter-draft-create`	einen Entwurf anlegen, mit Name und erstem Betreff
`email-newsletter-draft-update`	Name, interne Notiz und Empfängerkreis eines Entwurfs
`email-newsletter-draft-delete`	einen Entwurf verwerfen
`email-newsletter-content-import`	ein Design hereinholen, das nur als HTML existiert — einmalig, gebunden an die gelesene Revision
`email-newsletter-content-edit`	benannte Bausteine des gespeicherten Dokuments ändern — das Werkzeug für jede spätere Änderung
`email-newsletter-content-publish`	den geprüften Inhalt zu dem machen, den ein Versand sendet
`email-newsletter-delivery-configure`	Absendername, Absenderadresse, Antwortadresse, Signatur
`email-newsletter-test-send`	Testversand an die Kontoadresse oder eine verifizierte Absenderadresse
`email-newsletter-send`	den echten Versand vorbereiten und eine Bestätigungs-URL zurückgeben

Ein eigenes Werkzeug für den Versandstand gibt es nicht: wo ein Newsletter mit seinem Versand steht, ist die Projektion deliveryStatus von email-newsletter-get. Der Betreff wird einmal geschrieben, beim Anlegen — danach ändert man ihn im KlickTipp-Editor und liest ihn über die Projektion metadata.

Opt-in

Werkzeug	Wofür
`search-opt-in-processes`	die Opt-in-Prozesse des Kontos auflisten
`get-opt-in-process`	die vollständige Konfiguration eines Prozesses lesen
`get-subscription-redirect-url`	die Pending- oder Danke-Seite auflösen, auf die ein Abonnent weitergeleitet wird

Der Skill E-Mail-Erstellung

Mit dabei ist ein Skill, der HTML für den HTML-Import des KlickTipp-E-Mail-Editors erzeugt. Dieser Import ist kein allgemeiner HTML-Parser: er mappt vorhandene Struktur auf die Blocktypen, die er kennt. HTML, das nicht darauf hin geschrieben wurde, landet als eine große, unteilbare Textwüste im Editor — importiert, aber nicht mehr bearbeitbar. Der Skill kodiert, welche Struktur der Importer erwartet und welche Elemente sich per HTML überhaupt stabil erzeugen lassen.

Wie es mit deinen Daten umgeht

Alles passiert in dem KlickTipp-Konto, zu dem die Anmeldung gehört, oder in einem Unterkonto, das dieses Konto führen darf. Ein Werkzeug erweitert nie, was ein Unterkonto ohnehin dürfte.

Lesende Werkzeuge laufen ohne Rückfrage. Jedes schreibende ist so gekennzeichnet, dass der Agent vorher fragt.

Kein Werkzeug versendet einen Newsletter. email-newsletter-send prüft Konto, Berechtigung, Inhalt, Empfängerkreis und Absender, nennt den Empfängerschätzwert und gibt eine kurzlebige, einmal verwendbare Bestätigungs-URL zurück. Erst wenn du sie in KlickTipp öffnest und dort bestätigst, ist der Newsletter übergeben — dieser Schritt erreicht echte Empfänger und ist nicht zurückholbar. Ändert sich vorher ein gebundener Wert oder läuft der Link ab, wird die Bestätigung abgelehnt und muss neu vorbereitet werden.

Vier Schreibvorgänge haben kein Zurück, und der Agent soll vorher sagen, was sie kosten:

email-newsletter-content-import wandelt nur HTML und ist der Eingang für ein Design, das nur als HTML existiert — kein Weg, einen Newsletter zu ändern. Social-Icons kommen als verlinkte Bilder zurück, Tabellen als einfaches Markup, Video als Vorschaubild, Add-ons als ihre gerenderte Ausgabe; Webfonts, Zeilen-Hintergrundbilder und eigene Head-Styles fallen weg; KlickTipp-Entscheidungen und KI-Blöcke werden unwiederbringlich gelöscht. Was genau es beim jeweiligen Newsletter kostet, steht beim Lesen in importWarnings.
email-newsletter-content-edit wandelt nichts: kein Baustein verliert Gestaltung oder Bearbeitbarkeit, und eine geänderte Überschrift kostet eine geänderte Überschrift. Ein entfernter Baustein kommt trotzdem nicht zurück. Für jede Änderung an einem gestalteten Newsletter ist das der Weg, nicht der Import.
email-newsletter-content-publish ändert, was echte Empfänger bekommen würden.
email-newsletter-draft-delete löscht den Entwurf samt E-Mail, Empfängerbedingungen und System-Tags.

Personenbezug. Die Weiterleitungs-URL eines Abonnenten enthält dessen Kennung, E-Mail-Adresse, Liste, Abonnentenschlüssel und Empfehlungslink — die Antwort von get-subscription-redirect-url ist damit ein personenbezogenes Datum und geht durch den Anbieter des Agenten.

Was dabei verarbeitet wird, regelt die KlickTipp-Datenschutzerklärung; die Nutzung des Dienstes die AGB. Für die Verarbeitung durch den Agenten selbst gilt zusätzlich die Erklärung seines Anbieters.

Wenn es nicht geht

Die Anmeldung in der Claude-Desktop-App scheitert

Das ist derzeit erwartbar und liegt nicht am Plugin: die App registriert sich als OAuth-Client in einer Form, die der KlickTipp-Anmeldedienst ablehnt, der Authorize-Request endet mit HTTP 400. Zwei Wege tragen bis zur Behebung — das Plugin im Terminal installieren und dort anmelden, oder den MCP-Server ohne Plugin von Hand eintragen:

claude mcp add --scope user --transport http klicktipp https://mcp.klicktipp.com/mcp
claude mcp login klicktipp

Ein von Hand eingetragener Server wird auch von der Desktop-App benutzt, ein Plugin-Server nicht. Laufen beide Wege gleichzeitig, hast du dieselben Werkzeuge doppelt; dann einen der beiden entfernen.

Alle Aufrufe scheitern mit 401

Die Anmeldung ist nicht durchgelaufen. Wiederhole sie, statt die Konfiguration zu ändern.

Ein Werkzeug meldet, das Konto sei nicht erreichbar

Dann gehört das angesprochene Konto nicht zu deiner Anmeldung, oder es ist ein Unterkonto, für das dein Konto die nötige Berechtigung nicht führt.

Hilfe

Fragen zum Plugin und zum MCP-Zugang: support@klick-tipp.com. Der Quellcode des Pakets liegt offen unter github.com/klicktipp/agent-plugins.