Automatisierte Workflows & Organisation
KlickTipp MCP Server mit Claude oder Codex nutzen
Nutze diese Anleitung, um Claude Code oder Codex über den lokalen KlickTipp MCP Server mit Deinem KlickTipp-Konto zu verbinden.
Anschließend kann Dein KI-Assistent KlickTipp-Strukturen einsehen, Tools der KlickTipp Management API nutzen und Dich bei der Verwaltung Deiner Kontakte unterstützen.
Nutzt Du Claude Desktop statt Claude Code? Dann folge der Anleitung: KlickTipp MCP Server mit Claude Desktop integrieren.
KlickTipp MCP Server einrichten
Voraussetzungen
- Zugriff auf ein KlickTipp-Konto mit Benutzername und Passwort
- Claude Code oder ein lokal installierter Codex-Client
Du musst die technischen Anforderungen nicht selbst vorab prüfen. Claude Code oder Codex kann das Repository des KlickTipp MCP Servers auslesen und überprüfen, ob auf Deinem System alle benötigten Komponenten vorhanden sind.
Empfohlene sichere Konfiguration
- Installiere den vorgefertigten KlickTipp MCP Server.
- Lass Claude Code oder Codex die Anforderungen des Repositorys prüfen.
- Verbinde den MCP Server mit Deinem KlickTipp-Konto.
- Teste die Verbindung zunächst mit reinem Lesezugriff.
- Aktiviere Schreib-Tools nur, wenn Du sie ausdrücklich benötigst.
KlickTipp MCP Server installieren
Öffne einen neuen Chat in Claude oder Codex, um das vorgefertigte KlickTipp-MCP zu installieren.
Füge diesen Befehl ein:
Please set up the KlickTipp MCP server from:
https://github.com/klicktipp/klicktipp-mcp
Use the repository README, package.json and .env.example as the source of truth.
Check my system requirements first. If anything is missing, guide me through the smallest safe fix.
Then clone the repository, install dependencies, create .env from .env.example, and help me fill in the required values locally.
Use username and password authentication for this local setup.
Keep the server read-only:
KT_TOOL_MODE=readonly
KT_ENABLE_WRITES=false
KT_ENABLE_DESTRUCTIVE=false
Do not ask me to paste credentials into chat.
Test read-only tools first.
Kopieren
Genehmige nur Aktionen, die für die sichere Einrichtung erforderlich sind. Dazu gehören das Klonen des Repositorys, die Installation der Abhängigkeiten, die Erstellung der lokalen .env-Datei und schreibgeschützte Tests.
Genehmige während der Einrichtung keine Veröffentlichungen, Commits, Löschvorgänge oder die Aktivierung von Schreib-Tools.
MCP Server mit KlickTipp verbinden
Die .env-Datei ist Deine lokale Konfigurationsdatei. Der KlickTipp MCP Server liest daraus Deinen KlickTipp-Benutzernamen und Dein Passwort aus. Öffne die erstellte .env-Datei selbst in Deinem lokalen Editor. Lass Claude Code oder Codex die Datei nicht mehr öffnen oder ausgeben, sobald Du Deine Anmeldedaten eingetragen hast.
- Öffne die erstellte .env-Datei selbst in Deinem lokalen Editor. Bitte den KI-Assistenten nicht, die Datei zu öffnen, nachdem die Anmeldedaten hinzugefügt wurden.
Show me the path to the generated .env file. Do not print the file contents.
Kopieren
- Ersetze nicht die gesamte Datei. Gib Benutzername und Passwort direkt in die lokale .env-Datei ein. Füge die KlickTipp-Anmeldedaten nicht in den Chat ein.
KT_AUTH_MODE=session
KT_USERNAME=your-klicktipp-username
KT_PASSWORD=your-klicktipp-password
Kopieren
- Speichere Deine Änderungen in der .env-Datei.
Bewahre diese Datei lokal auf. Füge die .env-Datei nicht zu Git hinzu und übertrage sie nicht in ein Repository.
Verbindung mit KlickTipp testen
Nachdem Du die Verbindung eingerichtet hast, starte Claude Code oder Codex neu und öffne einen neuen Chat.
Teste die Verbindung anhand einiger Beispiel-Prompts:
List my KlickTipp tags.
Kopieren
List my KlickTipp fields.
Kopieren
List my KlickTipp opt-in processes.
Kopieren
Sollten diese Lesetests fehlschlagen, behebe zunächst den Konfigurationsfehler. Aktiviere Schreib-Tools erst, wenn alle Lesetests erfolgreich sind.
Schreib-Tools sicher aktivieren
Aktiviere Schreib-Tools erst, wenn die Lese-Tools zuverlässig funktionieren. Schreib-Tools können Daten in Deinem KlickTipp-Konto verändern. Lasse destruktive Tools weiterhin deaktiviert.
Passe die Einstellung KT_ENABLE_WRITES in der .env-Datei an und speichere Deine Änderungen:
KT_TOOL_MODE=full
KT_ENABLE_WRITES=true
KT_ENABLE_DESTRUCTIVE=false
Kopieren
Starte Claude Code oder Codex neu, nachdem Du die .env-Datei geändert hast.
Fehler bei der MCP-Verbindung beheben
Falls der KI-Assistent den MCP-Server nicht starten kann, frage ihn:
Please inspect the MCP server logs, verify node -v and npm -v, check the .env file, and confirm that the MCP client points to the correct absolute path.
Kopieren
Sollte die Authentifizierung fehlschlagen, überprüfe Folgendes:
- Ist KT_AUTH_MODE=session in der .env-Datei eingetragen?
- Sind KT_USERNAME und KT_PASSWORD korrekt?
- Kannst Du Dich mit diesen Zugangsdaten regulär bei KlickTipp anmelden?
- Befindet sich die .env-Datei im Repository-Ordner des KlickTipp MCP Servers?
Häufige Fragen zum KlickTipp MCP Server
Was ist der KlickTipp MCP Server?
Der KlickTipp MCP Server verbindet kompatible KI-Programmierassistenten wie Claude Code oder Codex mit Deinem KlickTipp-Konto. Dadurch kann der KI-Assistent ausgewählte Strukturen und Daten in KlickTipp auslesen und – nach Deiner ausdrücklichen Freigabe – auch Schreib-Tools nutzen.
Läuft der KlickTipp MCP Server lokal?
Ja. Der KlickTipp MCP Server wird lokal auf Deinem Rechner installiert und ausgeführt. Die Konfiguration und Deine KlickTipp-Zugangsdaten werden in einer lokalen .env-Datei gespeichert.
Kann ich KlickTipp mit Claude Code oder Codex verbinden?
Ja. Du kannst Claude Code oder einen lokal installierten Codex-Client über den KlickTipp MCP Server mit Deinem KlickTipp-Konto verbinden. Für Claude Desktop gibt es eine separate Anleitung.
Muss ich meine KlickTipp-Zugangsdaten in den KI-Chat eingeben?
Nein. Gib Deinen KlickTipp-Benutzernamen und Dein Passwort nicht in den KI-Chat ein. Trage Deine Zugangsdaten ausschließlich selbst in die lokale .env-Datei ein und lasse deren Inhalt anschließend nicht vom KI-Assistenten öffnen oder ausgeben.
Kann Claude Code oder Codex Daten in meinem KlickTipp-Konto verändern?
Standardmäßig solltest Du den KlickTipp MCP Server zunächst nur mit Lesezugriff verwenden. Schreib-Tools können Daten in Deinem KlickTipp-Konto verändern und sollten deshalb erst aktiviert werden, wenn die Verbindung und alle Lesetests zuverlässig funktionieren.
Was kann ich tun, wenn die Verbindung zum KlickTipp MCP Server nicht funktioniert?
Prüfe, ob die benötigten Komponenten installiert sind, die .env-Datei im richtigen Repository-Ordner liegt und Deine Zugangsdaten korrekt eingetragen sind. Kontrolliere außerdem die Konfiguration des MCP Servers und teste, ob Du Dich mit den verwendeten Zugangsdaten regulär bei KlickTipp anmelden kannst.
Partnerauthentifizierung für mehrere Konten
Verwende bei Multi-Account-Integrationen, im produktiven Einsatz oder bei der Verwaltung von Kundenkonten keine Authentifizierung mit Benutzername und Passwort. Nutze stattdessen die Authentifizierung mit Entwicklerschlüssel und Kundenschlüssel: Management-API-Authentifizierung.
Weitere Anleitungen und Ressourcen
KlickTipp MCP Server mit Claude Desktop integrieren
Nutze diese Anleitung, wenn Du den KlickTipp MCP Server mit Claude Desktop statt mit Claude Code oder Codex verbinden möchtest.
KlickTipp KI-Agent für Kontakte und API-Automatisierungen
Entdecke weitere Möglichkeiten, KlickTipp-Kontakte mit KI und der Management API zu verwalten.
KlickTipp Integrationen und API
Finde weitere Möglichkeiten, KlickTipp mit externen Anwendungen und Diensten zu verbinden.