Ressourcen#
Der Server stellt die Plattformreferenz als MCP-Ressourcen bereit. Der Assistent liest sie ohne Werkzeugaufruf. Der Text ist Englisch, dieselbe Sprache wie core.telegram.org/bots/serverless, damit er gegen diese Seite geprüft werden kann.
| URI | Inhalt |
|---|---|
tgcloud://docs/project-structure | Layout von tgcloud/, Handler, Endpoints, lib, schema.js. Projektimporte sind relative Pfade mit .js. Static-Hosting der Mini App |
tgcloud://docs/cli | CLI-Referenz: Befehle, --dry-run / --safe / --yes / --local, upgrade, webhook |
tgcloud://docs/sdk-db | sdk/db: Spaltentypen (text, integer, real, numeric, blob, boolean, json) und Modi, Query-Builder, Raw-SQL, keine Fremdschlüssel, Löschen nur über .deprecated |
tgcloud://docs/sdk-api | sdk/api: gesamte Bot API, BotApiError, InputFile |
tgcloud://docs/sdk-fetch | sdk/fetch: HTTP-Client, Body-Helfer, Grenze 32 MB |
tgcloud://docs/limits | Dokumentierte Grenzen und die Kontingente, die nicht veröffentlicht sind |
Lies in einem Gerüst-Projekt zuerst AGENTS.md und docs/tgcloud-sdk.md. Sie passen zur CLI, die das Projekt angelegt hat. Die Ressourcen sind der Ersatz, wenn du nicht in einem Projekt stehst.
Quelle im Repo: resources/docs/*.md. npm run docs:check prüft, dass jede Datei registriert ist, dass die beiden Skill-Kopien übereinstimmen und dass jede englische Seite Geschwister in ru, zh, ar, de und fr hat.
Plattformgrenzen#
tgcloud://docs/limits sammelt die veröffentlichten Grenzen: 50 MB pro Bot-API-Upload (10 MB für Fotos), 20 MB pro getFile-Download und 32 MB pro fetch-Antwortkörper. console-Ausgaben zeigt tgcloud run; eine Größenobergrenze ist nicht veröffentlicht.
Laufzeitkontingente — Speicher, CPU, der Wall-Time-Timeout von Handler und Endpoint, Aufrufrate, Datenbankgröße — sind nicht veröffentlicht. Erfinde keine Zahlen. run_handler gibt die Laufzeit eines Laufs aus: Miss damit deinen Pfad, halte Handler kurz und verschiebe schwere Arbeit aus dem Update-Pfad heraus über fetch. Die Werte erfährst du in @BotFather → Bot → Serverless oder über die offiziellen Kanäle der Plattform.
Dieselbe Ressource listet die Fähigkeiten, die die Laufzeit nicht bietet: Datenbanktransaktionen und atomare Stapel, eigene eingehende HTTP-Endpunkte (den Webhook besitzt die Plattform), einen Secrets-Speicher und Umgebungsvariablen sowie geplante Jobs — jeweils mit der unterstützten Alternative.