Lokale Werkzeuge

Lokale Werkzeuge

Mit Lokale Werkzeuge kann der Chat-Agent MCP-Server und Programme auf Ihrem eigenen Rechner nutzen, zum Beispiel lokale Dateien, Entwicklungswerkzeuge oder Archicad. Sie beschreiben im Chat, was Sie brauchen, und der Agent ruft die passenden Werkzeuge direkt auf Ihrem Rechner auf. Die Verbindung stellt hermine.ai Capture her, die Desktop-App von hermine.ai.

MCP (Model Context Protocol) ist ein offener Standard, über den Programme einem KI-Assistenten Werkzeuge bereitstellen. Ein MCP-Server ist ein solches Programm auf Ihrem Rechner.

Einrichtung

  1. Installieren Sie hermine.ai Capture von der Downloads-Seite und melden Sie sich mit Ihrem hermine.ai-Konto an.
  2. Öffnen Sie in hermine.ai Capture die Einstellungen, klappen Sie Erweiterte Einstellungen auf und schalten Sie auf der Karte Lokale Werkzeuge den Schalter Lokale Werkzeuge aktivieren ein. Er ist anfangs ausgeschaltet.
  3. Die Karte zeigt den Verbindungsstatus und für jeden MCP-Server, ob er bereit ist und wie viele Werkzeuge er bereitstellt.

In hermine.ai sehen Sie unter Persönlich im Reiter Verbundene Dienste im Abschnitt Lokale Werkzeuge, welche Rechner verbunden sind und welche MCP-Server sie bereitstellen. Dort können Sie alte Rechner auch aus der Liste entfernen.

MCP-Server einrichten

Server aus anderen Apps übernehmen

hermine.ai Capture findet MCP-Server, die Sie bereits in Claude Desktop, Cursor, VS Code oder Windsurf eingerichtet haben, und listet sie unter MCP-Server auf. Gefundene Server bleiben ausgeschaltet, bis Sie sie einzeln einschalten. Schalten Sie nur Server ein, denen Sie vertrauen, denn sie führen Programme auf Ihrem Rechner aus. Mit Erneut suchen liest hermine.ai Capture die Konfigurationen erneut ein.

Ändert sich die Konfiguration eines Servers in der anderen App, schaltet hermine.ai Capture ihn aus und weist Sie darauf hin. Prüfen Sie die neue Fassung und schalten Sie den Server wieder ein, wenn Sie ihr vertrauen.

Eigene Server hinzufügen

Mit Server hinzufügen richten Sie einen Server selbst ein. Sie haben zwei Möglichkeiten:

  • Programm (stdio): hermine.ai Capture startet ein Programm auf Ihrem Rechner. Geben Sie den Befehl, die Argumente (eines pro Zeile) und bei Bedarf Umgebungsvariablen und ein Arbeitsverzeichnis an.
  • Lokale Adresse (HTTP): hermine.ai Capture verbindet sich mit einem MCP-Server, der bereits auf Ihrem Rechner läuft, zum Beispiel unter http://127.0.0.1:3000/mcp. Erlaubt sind nur Adressen auf diesem Rechner.

Alternativ fügen Sie unter Konfiguration einfügen einen Abschnitt mcpServers im JSON-Format ein, wie ihn viele Programme in ihrer Anleitung angeben. Der Abschnitt darf mehrere Server enthalten.

Der Name, den Sie einem Server geben, erscheint auch in hermine.ai, zum Beispiel im Verlauf der Chat-Schritte.

So nutzen Sie lokale Werkzeuge im Chat

  1. Achten Sie darauf, dass hermine.ai Capture läuft und verbunden ist. Die App darf dabei auch nur im Infobereich der Taskleiste beziehungsweise in der Menüleiste laufen.
  2. Starten Sie bei Bedarf das Programm, das der MCP-Server anspricht.
  3. Beschreiben Sie im Chat, was Sie brauchen. Der Agent wählt die passenden Werkzeuge selbst aus.

Werkzeuge laufen ohne Rückfrage. Möchten Sie Änderungen vorher prüfen, schalten Sie in hermine.ai Capture unter „Erweiterte Einstellungen“ die Option „Schreibende Werkzeuge immer bestätigen“ ein. Dann fragt hermine.ai Capture vor jedem Werkzeug nach, das etwas auf Ihrem Rechner verändern kann. Bestätigen Sie nicht innerhalb von zwei Minuten, wird die Aktion nicht ausgeführt und der Agent erhält einen entsprechenden Hinweis.

Sind lokale Werkzeuge verbunden, sehen Sie im Chat direkt neben den Werkzeugen den grünen Hinweis Lokal: … mit dem ersten MCP-Server. Ein Klick darauf zeigt Ihre Rechner mit ihren MCP-Servern. Ist nichts verbunden, erscheint kein Hinweis.

Lokale Werkzeuge stehen im Chat nur zur Verfügung, solange hermine.ai Capture auf einem Ihrer Rechner verbunden ist. Sind mehrere Rechner verbunden, nutzt der Agent den zuletzt aktiven.

Beispiel: Archicad

Für Archicad bringt hermine.ai Capture eine integrierte Anbindung mit. Zusätzlich können Sie den offiziellen MCP-Server von Graphisoft nutzen. Sie können einen oder beide Wege verwenden.

Integrierte Anbindung mit dem Tapir-Add-on

Die integrierte Anbindung nutzt die JSON-Schnittstelle von Archicad. Mit dem kostenlosen Tapir-Add-on kommen Werkzeuge wie Elemente abfragen, Eigenschaften lesen und ändern sowie Wände, Decken, Stützen, Fenster und Türen anlegen hinzu. Ohne Tapir sind nur lesende Werkzeuge verfügbar.

  1. Laden Sie das Tapir-Add-on in der Version herunter, die zu Ihrer Archicad-Version und Ihrem Betriebssystem passt.
  2. Öffnen Sie in Archicad den Add-On-Manager, fügen Sie das Add-on hinzu und starten Sie Archicad neu.
  3. Öffnen Sie ein Projekt. hermine.ai Capture findet die laufende Archicad-Instanz automatisch und zeigt sie als bereit an.

Koordinaten und Maße gibt der Agent in Metern an.

Offizieller MCP-Server von Graphisoft

Neuere Archicad-Versionen bringen einen eigenen MCP-Server mit. Er wird wie jeder andere Server eingerichtet:

  1. Öffnen Sie in Archicad das Menü Optionen und dort Desktop-KI-Werkzeugverbindung.
  2. Archicad zeigt eine Konfiguration im JSON-Format an (beginnend mit mcpServers). Kopieren Sie diese vollständig und unverändert.
  3. Fügen Sie die Konfiguration in hermine.ai Capture unter Konfiguration einfügen ein und klicken Sie auf Hinzufügen.

Haben Sie diese Konfiguration bereits in einer der oben genannten Apps eingerichtet, erscheint der Server automatisch in der Liste. Ändern Sie die Konfiguration nicht von Hand, sie enthält Angaben zu Ihrer Archicad-Lizenz.

Beispiele für Anfragen

  • „Welche Wände sind gerade ausgewählt und wie hoch sind sie?“
  • „Lege eine 6 m lange Wand mit 3 m Höhe entlang der x-Achse an.“

Sicherheit und Datenschutz

  • Nur ausgehende Verbindungen: hermine.ai Capture baut die Verbindung von Ihrem Rechner zu hermine.ai auf. Auf Ihrem Rechner muss kein Port geöffnet werden, ein VPN ist nicht nötig.
  • Nur lokal: hermine.ai Capture spricht MCP-Server per HTTP ausschließlich über lokale Adressen wie 127.0.0.1 an. Andere Rechner im Netzwerk werden nicht angesprochen.
  • Bestätigung: Auf Wunsch führt hermine.ai Capture Werkzeuge, die etwas verändern können, erst nach Ihrer Bestätigung aus.
  • Ihre Auswahl: Server aus anderen Apps stehen dem Chat erst zur Verfügung, wenn Sie sie in hermine.ai Capture eingeschaltet haben.
  • Nur Ihr Konto: Werkzeugaufrufe aus Ihren Chats gehen nur an Rechner, auf denen Sie selbst in hermine.ai Capture angemeldet sind.
  • Ausschalten: Mit dem Schalter auf der Karte Lokale Werkzeuge trennen Sie die Verbindung jederzeit.

Hinweis für die IT

  • hermine.ai Capture benötigt ausschließlich eine ausgehende HTTPS-Verbindung (WebSocket) zu Ihrer hermine.ai-Adresse. Eingehende Ports für lokale Werkzeuge werden nie benötigt.
  • Lokale MCP-Server, die per HTTP angebunden werden, dürfen nur auf 127.0.0.1 lauschen. Sie sollten aus dem Netzwerk nicht erreichbar sein.
  • Die Archicad-Schnittstelle lauscht auf den lokalen Ports 19723 bis 19743. Wir empfehlen, eingehende Verbindungen auf diese Ports an den Arbeitsplätzen per Firewall zu blockieren.

Fehlerbehebung

  • „hermine.ai Capture ist auf Ihrem Rechner nicht verbunden“: Starten Sie hermine.ai Capture, melden Sie sich an und prüfen Sie, ob der Schalter Lokale Werkzeuge aktivieren eingeschaltet ist.
  • „Dieses lokale Werkzeug ist gerade nicht verfügbar“: Der MCP-Server ist ausgeschaltet, konnte nicht starten oder das zugehörige Programm läuft nicht. Bei Archicad ist eventuell kein Projekt geöffnet oder das Tapir-Add-on nicht geladen. Prüfen Sie den Status auf der Karte Lokale Werkzeuge und klicken Sie auf Erneut prüfen.
  • „hermine.ai Capture hat nicht rechtzeitig geantwortet“: Die Bestätigung wurde nicht innerhalb von zwei Minuten erteilt oder das Programm war beschäftigt. Wiederholen Sie die Anfrage.

War diese Seite hilfreich?