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 (z.B. Remote-HTTP statt NPX).
Lösung
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, Python, HTTP API, OpenAPI) gewählt wurde.
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?
Authentifizierung prüfen
Falls der Server einen API-Key oder Token erfordert, prüfen Sie, ob die hinterlegten Zugangsdaten aktuell und korrekt sind.