MCP-Server für andere KI-Werkzeuge

Claude Code, Cursor und andere KI-Werkzeuge nutzen deine kaiport-Verbindungen über einen lokalen MCP-Server – was sie dürfen, was deine Freigabe braucht und wie du sie einrichtest.

Auf dieser Seite

MCP-Server einschalten
KI-Werkzeug einrichten
Was KI-Werkzeuge können
Wo es läuft
Freigaben
KI-Protokoll
Sicherheit

kaiport kann ein MCP-Server sein. KI-Werkzeuge, die das Model Context Protocol sprechen – Claude Code, Cursor, VS Code, Claude Desktop und andere –, sehen dann deine gespeicherten Verbindungen und können auf deinen Servern Befehle ausführen und mit Dateien arbeiten. Alles geschieht in kaiport: in einem Terminal-Tab, dem du zusehen kannst, mit den Zugangsdaten, die kaiport verwahrt, und mit deiner Freigabe für jede Änderung. Passwörter und Schlüssel sehen die KI-Werkzeuge nie.

MCP-Server einschalten

Öffne Einstellungen › AI Pilot und scrolle zu MCP-Server.
Schalte MCP-Server aktivieren (Enable MCP server) ein. Die Zeile darunter zeigt „Läuft unter http://127.0.0.1:47321/mcp“.
Richte dein KI-Werkzeug mit URL und Token ein, wie unten beschrieben.

Einstellung	Was sie tut
MCP-Server aktivieren	Startet und stoppt den Server. Er lauscht nur auf diesem Computer (127.0.0.1).
URL	Wohin sich das KI-Werkzeug verbindet, mit Kopierknopf.
Token	Das Geheimnis, das jede Anfrage als `Authorization: Bearer …` mitschicken muss. Neuer Token (New token) ersetzt ihn; Werkzeuge mit dem alten werden ab dann abgewiesen.
Port	47321, solange du keinen anderen wählst, etwa wenn ein anderes Programm ihn benutzt. Die URL ändert sich mit.
KI-Werkzeug einrichten (Set up an AI tool)	Fertige Einrichtung für Claude Code, Cursor, VS Code und Claude Desktop, mit eingesetzter URL und eingesetztem Token.

Meldet die Zeile unter MCP-Server aktivieren, dass der Port von einem anderen Programm benutzt wird, trage einen anderen Port ein.

KI-Werkzeug einrichten

Wähle unter KI-Werkzeug einrichten dein Werkzeug, kopiere den Text und verwende ihn wie dort beschrieben:

Claude Code: Führe den Befehl in einem Terminal aus. Er lautet claude mcp add --transport http kaiport <URL> --header "Authorization: Bearer <Token>".
Cursor: Trage das JSON in ~/.cursor/mcp.json ein, oder in .cursor/mcp.json eines Projekts.
VS Code: Trage das JSON in .vscode/mcp.json eines Workspace ein oder in deine Benutzerkonfiguration (Befehl MCP: Open User Configuration).
Claude Desktop: Trage das JSON in claude_desktop_config.json ein (Claude › Einstellungen › Entwickler › Konfiguration bearbeiten). Claude Desktop startet lokale Server als Programme, deshalb nutzt die Einrichtung mcp-remote über npx; dafür braucht es Node.js.
Andere MCP-Clients – zum Beispiel OpenAI Codex, Windsurf oder Zed: Füge einen Remote-Server (Streamable HTTP) mit der URL und dem Header Authorization: Bearer <Token> hinzu, wie in der Dokumentation deines Werkzeugs beschrieben. Ein Werkzeug, das lokale Server nur als Programme startet, verbindet sich über mcp-remote, wie Claude Desktop.

Was KI-Werkzeuge können

Werkzeug	Was es tut	Freigabe
`list_connections`	Listet deine Verbindungen: ID, Name, Typ, Adresse, Benutzer, Gruppe, Tags, Notizen, KI-Anweisungen und verbotene Befehle. Nie Passwörter, Schlüssel oder Schlüsselpfade.	läuft
`run_command`	Führt auf einer SSH-Verbindung einen Befehl in ihrem kaiport-Tab aus und gibt Ausgabe, Exit-Code und Arbeitsverzeichnis zurück.	je nachdem
`read_screen`	Liest den sichtbaren Bildschirm dieses Tabs, etwa während ein Befehl auf eine Eingabe wartet.	läuft
`list_dir`, `read_file`, `find_files`, `search_files`	Dateien über SFTP oder eine Speicher-Verbindung (FTP, S3, WebDAV, Azure) auflisten, lesen, finden und durchsuchen.	läuft
`write_file`, `edit_file`	Eine Textdatei anlegen oder ändern. Du siehst die Änderung vorher als Diff.	fragt
`make_dir`, `rename`, `delete`	Ordner anlegen, umbenennen oder verschieben, löschen.	fragt

read_file und search_files halten sich an Dateiinhalte an die KI senden: Ist das aus, verweigern sie, wie bei AI Pilot.

Wo es läuft

Der erste Aufruf für eine Verbindung öffnet einen Terminal-Tab für sie, im zuletzt benutzten Terminal-Fenster oder in einem neuen Fenster, wenn keines offen ist. Spätere Aufrufe nutzen denselben Tab; schließt du ihn, öffnet der nächste Aufruf einen neuen. So ein Tab trägt ein Stecker-Symbol, und sein AI-Pilot-Bereich listet die Aufrufe unter dem Namen des Werkzeugs, etwa „Claude Code über MCP“ – das klappt auch, wenn du AI Pilot nicht mit einem eigenen Anbieter eingerichtet hast.

Du kannst jederzeit in den Tab tippen, zum Beispiel ein sudo-Passwort, nach dem ein Befehl fragt.

Freigaben

Der MCP-Server folgt den Regeln von AI Pilot, mit einem Unterschied: Nur Lesendes läuft ohne deinen Klick, und der Autopilot gilt hier nicht.

Schritt	Was passiert
Verbindungen auflisten, Bildschirm lesen, Dateien lesen, auflisten, finden oder durchsuchen	läuft
Ein Befehl, der nur liest (Status, Versionen, Konfiguration, Logs …)	läuft
Ein Befehl, der etwas ändert, `sudo` nutzt oder nicht als nur lesend bekannt ist	fragt
Eine Datei schreiben oder ändern, anlegen, umbenennen oder löschen	fragt, bei Dateiänderungen mit Diff
Gefährliche Befehle und Dateien, die dich aussperren können	fragen, mit Warnung
Befehle, die die Verbindung verbietet (Verbotene Befehle (KI))	werden ohne Rückfrage abgelehnt

Wartet ein Aufruf auf dich, zeigt kaiport seinen Tab; arbeitest du gerade in einem anderen Tab desselben Fensters, pulsiert stattdessen das Stecker-Symbol des Tabs. Ist kaiport im Hintergrund, erscheint eine Mitteilung und das Dock-Symbol hüpft (unter Windows und Linux blinkt das Fenster). Klicke im AI-Pilot-Bereich auf Ausführen oder Ablehnen. Lehnst du mit einer Notiz ab, bekommt das KI-Werkzeug sie und kann etwas anderes vorschlagen.

Solange kaiport gesperrt ist oder nachdem kaiport Pro geendet hat, verweigern die Werkzeuge ihre Arbeit – die Liste der Verbindungen eingeschlossen.

KI-Protokoll

Jeder Aufruf landet im KI-Protokoll wie die Schritte von AI Pilot selbst, mit dem Namen des KI-Werkzeugs hinter dem Host, etwa „über Claude Code“. In der Datei ai-audit.jsonl ist das das Feld client.

Sicherheit

Der Server antwortet nur auf diesem Computer (127.0.0.1) und nur mit dem Token. Anfragen von Webseiten werden abgewiesen.
Wer den Token hat, kann deine Verbindungen im Rahmen der Freigaberegeln oben nutzen. Halte ihn aus geteilten Konfigurationsdateien und Repositories heraus und erzeuge einen Neuen Token, wenn er bekannt geworden sein könnte.
Was ein KI-Werkzeug liest – Befehlsausgaben, Dateiinhalte, die Liste der Verbindungen –, geht an dieses Werkzeug und den KI-Anbieter, den es nutzt.
Schalte MCP-Server aktivieren aus, wenn du ihn nicht brauchst.