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

# Troubleshooting Guide

> Häufige Probleme und Lösungsansätze für die Localmind Plattform

Hier finden Sie Lösungen für häufige Probleme bei der Nutzung der Localmind Plattform. Jede Seite folgt demselben Aufbau: Symptom → mögliche Ursachen → Lösung in Schritten.

<CardGroup cols={2}>
  <Card title="Häufige Probleme (Symptom-Index)" icon="list-checks" href="/troubleshooting/Common-Issues">
    Alle Symptome im Überblick — mit Kurzlösungen und Links zu den dedizierten Seiten.
  </Card>

  <Card title="Agent antwortet nicht" icon="bot" href="/troubleshooting/Agent-Antwortet-Nicht">
    Keine Antwort oder endloser Ladeindikator — Modell, Tools und System-Prompt prüfen.
  </Card>

  <Card title="Dokument-Upload schlägt fehl" icon="upload" href="/troubleshooting/Dokument-Upload-Fehlgeschlagen">
    Upload bricht ab oder wird abgelehnt — Größenlimit, Format und Speicher prüfen.
  </Card>

  <Card title="Werkzeug-Verbindung schlägt fehl" icon="plug" href="/troubleshooting/Werkzeug-Verbindung-Fehlgeschlagen">
    Ein Tool-Server (MCP) ist nicht erreichbar oder lässt sich nicht verbinden.
  </Card>

  <Card title="Hybrid Search ohne Ergebnisse" icon="search" href="/troubleshooting/Hybrid-Search-Keine-Ergebnisse">
    Der Agent findet trotz hochgeladener Dokumente keine relevanten Inhalte.
  </Card>

  <Card title="Parser liefert schlechte Ergebnisse" icon="file-x" href="/troubleshooting/Parser-Liefert-Schlechte-Ergebnisse">
    Dokumente werden fehlerhaft oder unvollständig für die KI aufbereitet.
  </Card>

  <Card title="API-Key funktioniert nicht" icon="key" href="/troubleshooting/API-Key-Funktioniert-Nicht">
    Anfragen scheitern mit 401, 403 oder stillem 404 — Status, Scope und Header prüfen.
  </Card>

  <Card title="HTTP-Fehlercodes verstehen" icon="circle-alert" href="/troubleshooting/HTTP-Fehlercodes">
    Was 422, 403 und das stille 404 bedeuten — die Fehlercode-Referenz der API.
  </Card>

  <Card title="Benutzer kann Space nicht sehen" icon="eye-off" href="/troubleshooting/Benutzer-Kann-Space-Nicht-Sehen">
    Ein Org-Mitglied sieht einen Space nicht — Mitgliedschaft und Teams prüfen.
  </Card>

  <Card title="Variablen werden nicht ersetzt" icon="braces" href="/troubleshooting/Variablen-Werden-Nicht-Ersetzt">
    Platzhalter im System-Prompt erscheinen als Text, statt durch ihren Wert ersetzt zu werden.
  </Card>
</CardGroup>

<Info>
  Diese Seite wird laufend erweitert. Falls Ihr Problem hier nicht aufgeführt ist, kontaktieren Sie unser Support-Team unter [support@localmind.ai](mailto:support@localmind.ai).
</Info>