Symptom
Beim Hinzufügen oder Verwenden eines Werkzeugs (Tool-Server / MCP) erscheint ein Verbindungsfehler, oder der Agent meldet, dass ein Werkzeug nicht erreichbar ist.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.
- Der falsche Verbindungstyp wurde gewählt — es gibt sechs Typen (z.B. Remote-HTTP statt NPX-Paket).
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.2
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?
3
Authentifizierung prüfen
Falls der Server einen API-Key oder Token erfordert, prüfen Sie, ob die hinterlegten Zugangsdaten aktuell und korrekt sind.
4
Verbindungstest nutzen
Nutzen Sie die Testfunktion in der Werkzeug-Konfiguration, um die Verbindung direkt zu prüfen.