Grenzen und Fehler

Die Grenzen, die Toolaufrufe schnell und vorhersehbar halten, und was ein KI-Client sieht, wenn ein Aufruf fehlschlägt.

Grenzen pro Aufruf

Was	Grenze
Befehlsausgabe (`exec`, `shell_run`)	32.000 Bytes; längere Ausgaben werden abgeschnitten
Timeout für Befehle	Standardmäßig 60 Sekunden, höchstens 900 Sekunden; für längere Arbeiten `job_start` verwenden
Maschinen pro `exec_many`	8, jede mit der Hälfte der Ausgabegrenze
`read_file`	Standardmäßig 200.000 Bytes pro Aufruf, bis zu 4.000.000; ab `next_offset` fortsetzen
`write_file`, `copy_between_hosts`	4.000.000 Bytes; für größere Dateien `transfer_start` verwenden
`transfer_start`	Keine Größenbegrenzung; 2 gleichzeitig pro Verbindung, mit jeweils bis zu 10.000 Dateien
Auftragsausgabe (`job_output`)	64.000 Bytes pro Lesevorgang
Terminalausgabe pro Aufruf	20.000 Zeichen; wartet bis zu 600 Sekunden
HTTP-Body bei Portweiterleitung (`tunnel_http`)	32 KB

Offene Sitzungen

Was	Grenze
Shell-Sitzungen	4 pro Maschine; nach 30 Minuten Inaktivität geschlossen
Terminals	8 pro Verbindung; nach 30 Minuten Inaktivität geschlossen
Tunnel	Nach 1 Stunde geschlossen
Zeitpläne	200 pro Konto
Geteilte Webdienste	Standardmäßig 24 Stunden, wenn eine KI einen erstellt, höchstens 30 Tage
Wartende Freigaben	20 pro Verbindung

Aufrufe, die länger als 10 Sekunden dauern, senden alle 10 Sekunden MCP-Fortschrittsbenachrichtigungen, wenn der Client sie anfordert, damit beim Client kein Timeout eintritt, während ein Befehl, eine Übertragung oder eine Freigabe aussteht.

Tarifgrenzen

Tarife legen fest, wie viele Maschinen und Mitglieder ein Konto hat und welche Funktionen seine Richtlinien nutzen können, etwa Dateiregeln pro Ordner, Befehlsregeln, Zeitpläne, geteilte Webdienste und geheime Umgebungsvariablen. Siehe Preise. Ein Aufruf, der eine Funktion braucht, die der Tarif nicht enthält, schlägt mit einer Meldung fehl, die das sagt.

Fehler

Ein abgelehnter oder fehlgeschlagener Aufruf gibt ein MCP-Toolergebnis mit isError: true und einer verständlichen Meldung zurück, die der KI sagt, was passiert ist und was als Nächstes zu tun ist. Die Meldungen, die Sie am ehesten sehen:

Meldung beginnt mit	Bedeutung
`token lacks fleet.…`	Die Verbindung wurde ohne den Scope bestätigt, den dieses Tool braucht. Verbinden Sie den Client neu und bestätigen Sie den Scope.
`refused by this connection's command rules`	Die Befehlsregeln der Richtlinie verbieten diesen Befehl.
`high-risk operation`	Die KI muss Ihnen den genauen Befehl zeigen und dann erneut mit `confirm=true` aufrufen.
`refused by guardrail`	Ein Befehl, den LetKite nie ausführt, etwa das Löschen einer Festplatte.
`waiting for a person to approve this`	Eine Freigabe steht aus; die Meldung nennt, wer gefragt wurde und bis wann.
`this connection's authorization is no longer valid`	Die Verbindung wurde getrennt. Verbinden Sie den Client neu, um sich erneut anzumelden.

Anmeldefehler verwenden die standardmäßigen OAuth-Fehlercodes (invalid_grant, invalid_client, access_denied usw.). Ein fehlendes oder abgelaufenes Token führt zu HTTP 401 mit einem WWW-Authenticate-Header, und Clients melden sich selbst erneut an oder aktualisieren ihr Token.