Zum Hauptinhalt springen

Limits

Die Limits gelten pro Konto und werden von allen MCP-Verbindungen des Kontos geteilt.
  • Anfragen an den MCP-Server: bis zu 60 pro Minute, oder das API-Rate-Limit deines Plans, falls es niedriger ist. Sie zählen getrennt von deinen API-Aufrufen, sodass ein sehr aktiver Agent nie deine CLI, deine SDKs oder deine Bots blockiert. Darüber, oder solange das Konto über seinem API-Limit liegt, antwortet der MCP-Server mit 429 RATE_LIMITED.
  • Tool-Aufrufe: ein Budget pro Minute, das mit deinem Plan wächst.
  • Tools, die in deinen Anwendungen oder im Edge-Netzwerk arbeiten (Dateien, Logs, Metriken, Netzwerkanalysen, Snapshots, Datenbanken und Löschungen), haben zusätzlich eigene, engere Limits.
  • Jeder Tool-Aufruf zählt, auch Aufrufe, die wegen einer Ressource oder eines Scopes abgelehnt werden, der von den Argumenten abhängt (etwa restart bei set_env_vars).
  • Commits folgen einem Tempo pro Konto und pro Anwendung, gemeinsam mit der API, der CLI und dem Dashboard. Ein zu früh gesendeter Commit antwortet mit RATE_LIMITED.
Ein Tool über einem Limit antwortet mit TOOL_RATE_LIMITED, unten beschrieben, samt Wartezeit.

Zips und Dateien

  • Zip: upload_application und commit_application nehmen ein Zip bis 1 MB an, als base64 gesendet, und bis 100 MB entpackt. Das Dashboard und die CLI nehmen Zips bis 100 MB an: nutze sie für ein größeres Projekt.
  • Dateien: commit_application nimmt bis zu 50 Textdateien an, je bis 128 KB und zusammen bis 512 KB. Versteckte Dateien, .env-Dateien, private Schlüssel und die Konfigurationsdatei sind ausgeschlossen; die Konfigurationsdatei änderst du mit edit_config_file.

TOOL_RATE_LIMITED

Ein Tool über einem Limit läuft nicht. Die Antwort ist ein reguläres Tool-Ergebnis mit isError: true, kein HTTP-Fehler, sodass die Verbindung weiter funktioniert. retry_after_seconds sagt, wann das Tool wieder laufen kann:
Ist das Tool-Budget pro Minute das erreichte Limit, warten alle Tools; sonst wartet nur dieses Tool. Wird dasselbe Tool vor Ablauf der Wartezeit erneut aufgerufen, antwortet es mit TOOL_EXECUTION_FAILED. Das sagt dem Client, dass er aufhören soll: Warte ein paar Minuten oder nutze das Dashboard.

Fehler

HTTP-Fehler

Diese kommen als HTTP-Status der Anfrage zurück, mit einem JSON-Body, der code enthält.

Beim Verbinden

Tool-Ergebnisse

Diese kommen in einem Tool-Ergebnis als code zurück, neben einer summary, die der Client liest. Ein Tool, das dein Schlüssel nicht nutzen kann, oder eines, das nicht existiert, antwortet mit dem JSON-RPC-Fehler -32602 Unknown tool. Prüfe die Scopes des Schlüssels. Andere Codes kommen vom Tool selbst, und die summary erklärt sie.