> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Werkzeug-Verbindung (MCP) schlägt fehl

> Ein Werkzeug bzw. Tool-Server kann nicht verbunden werden oder ist nicht erreichbar.

## 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

<Steps>
  <Step title="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](/core-functions/Werkzeuge).
  </Step>

  <Step title="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?
  </Step>

  <Step title="Authentifizierung prüfen">
    Falls der Server einen API-Key oder Token erfordert, prüfen Sie, ob die hinterlegten [Zugangsdaten](/settings/organization/Zugangsdaten) aktuell und korrekt sind.
  </Step>

  <Step title="Verbindungstest nutzen">
    Nutzen Sie die Testfunktion in der Werkzeug-Konfiguration, um die Verbindung direkt zu prüfen.
  </Step>
</Steps>

<Tip>
  Bei Netzwerkproblemen in Unternehmensumgebungen klären Sie mit Ihrer IT-Abteilung, ob die Ziel-URL in der Firewall freigegeben ist.
</Tip>