Integrationen

Was sie sindEine hinzufügenWerkzeuge und BestätigungenIm Chat und in AgentenDatenschutzAlte MCP-ServerDemnächst

Was sie sind

Eine Integration ist ein MCP-Server (Model Context Protocol): ein offener Standard, um Modellen externe Werkzeuge zu geben, etwa Gedächtnis, Kalender, Datenbanken und Webdienste. Es gibt zwei Arten:

Art	Wie sie funktioniert
Auf diesem PC	Ein Programm, das HotMoE auf deinem Computer startet. Die Daten bleiben auf dem PC, außer was das Programm selbst ins Netz schickt.
Remote (online)	Ein Onlinedienst unter einer https://-Adresse. Die Anfragen des Modells und die Antworten gehen über das Internet und den Anbieter des Dienstes. In den Listen trägt sie die Markierung ONLINE.

Integrationen gehören dir, nicht einem einzelnen Agenten: Wie E-Mail-Konten richtest du sie einmal ein und hakst sie dann dort an, wo du sie nutzen willst.

Eine Integration hinzufügen

1. Öffne die Seite Integrationen über die Leiste links und wähle Integration hinzufügen.
2. Fülle die Felder aus (siehe Tabelle unten).
3. Drücke Verbinden und Werkzeuge zeigen. Die App speichert, verbindet sich mit dem Server und listet seine Werkzeuge auf.
4. Wähle die Werkzeuge, die an sein sollen, und hake die Integration an, wo du sie nutzen willst: im Chat oder in einem Agenten (siehe unten).

Feld	Wofür
Name	Woran du sie in den Listen erkennst. Im Chat ist es auch der Name ihrer Rolle.
Wofür sie ist	Ein Satz, am besten auf Englisch, mit Verben für das, was sie tut (zum Beispiel: „the user's GitHub: issues, pull requests, code review“). Der Chat erkennt daran, wann diese Werkzeuge gebraucht werden; leer nimmt er die Namen der Werkzeuge.
Wo sie läuft	Auf diesem PC oder Remote (online).
Befehl	Auf diesem PC. Das zu startende Programm mit seinen Argumenten, wie in der Dokumentation des Servers: zum Beispiel npx -y @modelcontextprotocol/server-memory.
Schlüssel und Variablen	Auf diesem PC, optional. Die Umgebungsvariablen, die der Server braucht, zum Beispiel GITHUB_TOKEN. Die Werte werden verschlüsselt gespeichert und nicht mehr angezeigt: Zum Ändern gib den neuen Wert ein; lass das Feld leer, um den gespeicherten zu behalten.
Adresse	Remote. Die Adresse des Dienstes, beginnend mit https://.
Anmeldung	Remote. Keine, Token (persönlicher Schlüssel) oder Anmeldung im Browser (OAuth).

Anmeldung im Browser (OAuth)

Mit OAuth öffnet Verbinden und Werkzeuge zeigen den Browser zur Anmeldung beim Dienst. HotMoE sieht dein Passwort nie: Es speichert nur die Berechtigung, verschlüsselt, und erneuert sie selbst.

Läuft die Anmeldung ab, öffnet der Chat den Browser nicht von selbst: Er zeigt einen Hinweis, dass du dich auf der Seite Integrationen erneut anmelden sollst.

Wenn ein Programm fehlt

Viele Integrationen auf dem PC starten mit npx (Node.js), uvx (uv) oder Docker. Ist das Programm nicht installiert, sagt dir die Seite das, bevor sie sich zu verbinden versucht, mit dem Link Wo es herunterladen.

Werkzeuge und Bestätigungen

• Nach dem Verbinden erscheint unter Werkzeuge jedes Werkzeug des Servers mit einem Schalter.
• Standardmäßig sind nur die Werkzeuge an, die der Server als schreibgeschützt angibt (markiert mit nur lesen). Schalte die anderen ein, wenn das Modell auch etwas ändern darf.
• Jeder Aufruf eines Werkzeugs fragt dich trotzdem vorher und zeigt dir die Daten, die es gleich erhält.
• Immer erlauben gilt für das einzelne Werkzeug, nicht für die ganze Integration. Du widerrufst es unter Zugriff › Berechtigungen (bei einem Agenten in seinem Editor).
• Jeder Aufruf landet im Protokoll, auch die abgelehnten. Rückgängig machen lassen sie sich nicht.

Im Chat und in Agenten

Eine eingerichtete Integration tut nichts, bis du sie anhakst:

• Im Chat: im Zugriff, Abschnitt Integrationen, hakst du die an, die der Chat nutzen darf.
• In einem Agenten: im Editor des Agenten, Abschnitt Integrationen.

Neben den Kästchen führt der Link Auf der Seite Integrationen einrichten hierher, um eine hinzuzufügen oder zu ändern.

Im Chat ist jede angehakte Integration eine Rolle, wie Dateien, E-Mail oder Bildschirm, mit dem Namen der Integration. Der Chat aktiviert sie nur, wenn die Anfrage diesen Dienst betrifft, und erst dann bekommt das Modell ihre Werkzeuge. Lokale Modelle haben wenig Kontext: So füllt er sich nicht mit Werkzeugen, die gerade nicht gebraucht werden.

Datenschutz

• Auf diesem PC: Die Daten bleiben auf deinem Computer, außer was das Programm selbst ins Netz schickt.
• Remote: Die Anfragen des Modells und die Antworten gehen über das Internet zum Anbieter des Dienstes. Verbinde ihn nur, wenn du ihm vertraust.
• Der Chat-Kopf zeigt es dir. Normalerweise steht neben dem Modell „· lokal, nichts verlässt deinen PC“. Hakst du eine Remote-Integration an, wird daraus „· nutzt auch Onlinedienste:“ mit ihren Namen.
• Werte der Variablen, Tokens und Anmeldeberechtigungen werden verschlüsselt gespeichert und nicht mehr angezeigt.

Alte MCP-Server der Agenten

Früher wurden MCP-Server in jedem Agenten hinzugefügt, im Abschnitt MCP-Server des Editors. Diese Server sind automatisch zu Integrationen geworden: Du findest sie auf der Seite Integrationen, schon angehakt in den Agenten, die sie genutzt haben. Derselbe Server in mehreren Agenten ist zu einer einzigen Integration geworden.

Demnächst

HotMoE ist ein Projekt von Virsion. Dieses Handbuch beschreibt die App so, wie sie heute ist: Was noch kommt, ist als solches gekennzeichnet.