> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# tgcloud-mcp

> 用于 Telegram 无服务器机器人（@tgcloud）的 MCP 服务器

# tgcloud-mcp

[English](index.en) · [Русский](index.ru) · [العربية](index.ar) · [Deutsch](index.de) · [Français](index.fr)

这个 MCP 服务器让 AI 助手管理 **Telegram 无服务器机器人**（`@tgcloud` 平台，core.telegram.org/bots/serverless）：创建项目、绑定机器人、handlers 与 endpoints、部署、数据库迁移、webhook。

适用于任何 MCP 客户端：opencode、Claude Code、Cursor、Claude Desktop、VS Code (Copilot)、Windsurf、Zed。同一套服务器和 skill 也作为一份 [Agent Plugin](https://agent-plugins.org) 提供给 Codex、Cursor、Copilot、Kiro 和 VS Code。

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/quickstart.zh">
    一次对话：从 CLI access token 到上线的机器人
  </Card>
  <Card title="安装" icon="download" href="/installation.zh">
    npm、curl | bash、Docker，或手动写入客户端配置
  </Card>
  <Card title="16 个工具" icon="list" href="/tools.zh">
    脚手架、部署、迁移和 webhook
  </Card>
  <Card title="资源" icon="book" href="/resources.zh">
    tgcloud://docs/* — 目录、SDK、CLI、限制
  </Card>
  <Card title="安全" icon="shield" href="/security.zh">
    confirm: true、令牌掩码、非官方项目
  </Card>
  <Card title="食谱" icon="utensils" href="/cookbook.zh">
    带数据库、按钮和 Mini App 的机器人
  </Card>
</CardGroup>

## 功能

- **16 个工具** — 覆盖 `tgcloud` CLI，包括 `upgrade`（0.2.0 之前的目录布局）和 `deploy`（先构建再 push）
- **资源** `tgcloud://docs/*` — 内置平台参考，英文，与官方文档对齐
- **护栏** — 破坏性操作需要 `confirm: true`，令牌会被掩码
- **多项目** — 每个工具都接收绝对路径 `project_dir`

## 快速开始

```bash
npm install -g tgcloud-mcp && tgcloud-mcp setup
```

接下来：[安装](installation.zh) → [快速开始](quickstart.zh) → [教程](cookbook.zh)。