Symptom
Beim Hinzufügen oder Verwenden eines Werkzeugs (Tool-Server / MCP) erscheint ein Verbindungsfehler, oder der Agent meldet, dass ein Werkzeug nicht erreichbar ist. Seit v1.5.0 nennt der Chat den betroffenen MCP-Server und antwortet mit den Werkzeugen der übrigen Server weiter – so sehen Sie direkt, welchen Server Sie prüfen müssen.Mögliche Ursachen
- Die Server-URL ist falsch oder nicht erreichbar.
- Der Tool-Server ist nicht gestartet oder antwortet nicht.
- Authentifizierungsdaten (API-Key, Bearer-Token) sind ungültig oder abgelaufen.
- Netzwerkeinschränkungen (Firewall, VPN) blockieren die Verbindung.
- Eine REST-API ist als Typ Remote-HTTP angelegt — Remote-HTTP erwartet einen MCP-Server, keine REST-API. Typisches Fehlbild: Der Verbindungstest läuft lange und endet ohne Antwort. Für REST-Schnittstellen verwenden Sie den Typ HTTP API oder OpenAPI.
- Die Code-Ausführung ist auf der Instanz deaktiviert — Server vom Typ NPX-Paket oder Python-Paket starten seit v1.5.0 in einer eigenen Sandbox und setzen die Code-Ausführung voraus. Der Verbindungstest weist darauf hin.
- Ein Remote-HTTP-Server mit eigenen Headern (z. B. API-Schlüssel) verbindet sich nicht – vor v1.5.0 ein bekannter Fehler, behoben in v1.5.0.
- Der Verbindungstest ist grün, Aufrufe des Werkzeugs scheitern trotzdem — der Test prüft nur, ob der Server startet bzw. erreichbar ist. Zugangsdaten, Kontingente und Freigaben für ausgehende Verbindungen greifen erst beim Aufruf. Beispiel: Gesetze-MCP ist gedrosselt.
Lösung
1
URL und Verbindungstyp prüfen
Öffnen Sie die Werkzeug-Konfiguration und stellen Sie sicher, dass URL bzw. Befehl korrekt eingegeben sind und der richtige Verbindungstyp (Remote-HTTP, NPX-Paket, Python-Paket, HTTP API, OpenAPI, Skill) gewählt wurde. Der Typ Skill benötigt keine Server-URL — prüfen Sie stattdessen die
SKILL.md und die Skill-Dateien. Details zu allen Verbindungstypen: Werkzeuge.Remote-HTTP ist nur für MCP-Server gedacht. Binden Sie eine normale REST-API an, legen Sie das Werkzeug als HTTP API an oder – wenn die API eine OpenAPI-Spezifikation mitbringt – als OpenAPI.2
Code-Ausführung aktivieren (NPX- und Python-Server)
Meldet der Verbindungstest, dass die Code-Ausführung nicht aktiviert ist, bitten Sie Ihren Administrator, die Code-Ausführung zu aktivieren. Details zur Code-Sandbox: Administration → Werkzeuge.
3
Server-Erreichbarkeit testen
Prüfen Sie, ob der Tool-Server läuft und von der Localmind-Instanz aus erreichbar ist. Bei selbst gehosteten Servern: Ist der Port offen und der Service gestartet?
4
Authentifizierung prüfen
Falls der Server einen API-Key oder Token erfordert, prüfen Sie, ob die hinterlegten Zugangsdaten aktuell und korrekt sind.
5
Verbindungstest nutzen
Nutzen Sie die Testfunktion in der Werkzeug-Konfiguration, um die Verbindung direkt zu prüfen.