Fehlersuche
Verbindung
| Symptom | Ursache | Lösung |
|---|---|---|
401 Unauthorized |
Token falsch, abgelaufen oder widerrufen | neuen Token anlegen und im Client eintragen |
429 Too Many Requests |
mehr als 60 Anfragen pro Minute | kurz warten, Schleifen im Agenten prüfen |
| Client zeigt keine Werkzeuge | Adresse ohne /api/mcp oder Header fehlt |
mit dem curl-Aufruf prüfen |
| Client kann sich nicht verbinden | Client spricht nur SSE oder lokale Prozesse | einen Client mit HTTP-Transport nehmen |
Antworten des Servers
Jede Antwort trägt ein Maschinenfeld in _meta: lalabase/kind bei einem Ergebnis, zum Beispiel
ok oder empty, und lalabase/code bei einem Fehler, bei einer Ablehnung dazu lalabase/reason.
| Meldung | Code | Ursache und Lösung |
|---|---|---|
| This token is read-only; writes are not permitted. | read_only |
Schreibaufruf mit Nur-Lese-Token. Nur-Lese-Zugriff am Token abwählen. |
| Missing required arguments: project_id | invalid_input |
Der Agent hat kein Projekt genannt. list_projects liefert die ID. |
| Project not found or not accessible. | not_found |
ID falsch, Projekt außerhalb der Reichweite oder, bei den Code-Werkzeugen, kein Recht auf das Repository. |
| No ticket found for … | empty in lalabase/kind |
Das Ticket gibt es nicht, oder du darfst es nicht lesen. |
| Not authorized. | forbidden |
Ticket ist lesbar, aber dir fehlt das Recht für diese Aktion. |
| exactly one change per call … | invalid_input |
update_ticket mit mehr als einer Änderung. In zwei Aufrufe teilen. |
| status is not a status of this project … | refused |
Falscher Status-Schlüssel. Die Werte stehen in meta.available_statuses. |
| a user in this change cannot be assigned in this project | refused |
Person ist dem Projekt nicht zuweisbar. |
| this project has no status field | refused |
Das Projekt hat kein Statusfeld. |
| notification is archived … | refused |
Eine archivierte Meldung lässt sich nicht markieren. |
| create failed: … | refused |
Lalabase lehnt das Ticket ab, etwa wegen eines falschen Status-Schlüssels. Meldung lesen. |
| AI features are disabled for this organisation. | refused |
Die KI wurde abgeschaltet, nachdem das Repository eingelesen war. search_code_symbols braucht sie. |
| idempotency_key already used with different parameters | invalid_input |
Derselbe Schlüssel mit anderen Argumenten. Einen neuen Schlüssel nehmen. |
Häufige Überraschungen
Der Filter nach Status liefert null Treffer. Status gehört zum Projekt. Lass den Agenten
list_tickets einmal ohne Filter aufrufen und meta.available_statuses lesen.
Das Personen-Verzeichnis ist „nicht gefunden“. Der Token erreicht nicht alle Projekte der Organisation.
In der Inbox fehlen Organisationen. Der Token erreicht sie nicht. Für alle Organisationen brauchst du Alle Organisationen, auch künftige.
Code-Werkzeuge liefern nichts. Das Repository ist nicht verbunden oder noch nicht eingelesen. Ohne eingeschaltete KI wird es nie eingelesen. Darfst du es nicht sehen, meldet Lalabase das Projekt als nicht gefunden, auch wenn Tickets desselben Projekts funktionieren.