资源#
服务器把平台参考作为 MCP 资源暴露出来。助手不调用工具就能阅读。正文是英文，与 core.telegram.org/bots/serverless 相同，便于对照官方页面。
| URI | 内容 |
|---|---|
tgcloud://docs/project-structure | tgcloud/ 布局、handlers、endpoints、lib、schema.js。项目导入是带 .js 的相对路径。Mini App 静态托管 |
tgcloud://docs/cli | CLI 参考：命令、--dry-run / --safe / --yes / --local、upgrade、webhook |
tgcloud://docs/sdk-db | sdk/db：列类型（text、integer、real、numeric、blob、boolean、json）与 mode、查询构造器、原始 SQL、无外键、通过 .deprecated 删除 |
tgcloud://docs/sdk-api | sdk/api：完整 Bot API、BotApiError、InputFile |
tgcloud://docs/sdk-fetch | sdk/fetch：HTTP 客户端、body 辅助函数、32 MB 上限 |
tgcloud://docs/limits | 已记录的限制，以及尚未公布的配额 |
在脚手架项目里，先读 AGENTS.md 和 docs/tgcloud-sdk.md。它们与创建该项目的 CLI 一致。不在项目目录中时，再用这些资源。
仓库中的原文是 resources/docs/*.md。npm run docs:check 检查每个文件都已注册、两份 skill 副本一致，以及每个英文页面都有 ru、zh、ar、de、fr 对应页。
平台限制#
tgcloud://docs/limits 汇总已公布的限制：Bot API 每次上传 50 MB（照片 10 MB）、getFile 每次下载 20 MB、fetch 响应体 32 MB。console 输出由 tgcloud run 显示，没有公布大小上限。
运行时配额——内存、CPU、handler 与 endpoint 的墙钟超时、调用频率、数据库大小——尚未公布。不要臆测数字。run_handler 会打印一次运行的耗时：用它测量你的路径，让 handler 保持简短，并把重活移出更新路径、改用 fetch 发出。具体数值请到 @BotFather → 机器人 → Serverless，或平台的官方渠道询问。
同一资源还列出运行时不提供的能力：数据库事务与原子批处理、自定义入站 HTTP 端点（webhook 由平台拥有）、密钥存储与环境变量、定时任务——并给出各自 受支持的替代方案。