> ## 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

> MCP-сервер для serverless-ботов Telegram (@tgcloud)

# tgcloud-mcp

[English](index.en) · [中文](index.zh) · [العربية](index.ar) · [Deutsch](index.de) · [Français](index.fr)

MCP-сервер, который учит AI-ассистента управлять **serverless-ботами Telegram**
(платформа `@tgcloud`, core.telegram.org/bots/serverless): скаффолд проекта,
привязка бота, handlers и endpoints, деплой, миграции БД, вебхуки.

Работает с любым MCP-клиентом: opencode, Claude Code, Cursor, Claude Desktop,
VS Code (Copilot), Windsurf, Zed. Тот же сервер и скилл поставляются одним
[Agent Plugin](https://agent-plugins.org) для Codex, Cursor, Copilot, Kiro и VS Code.

<CardGroup cols={2}>
  <Card title="Быстрый старт" icon="rocket" href="/quickstart.ru">
    От CLI access token до живого бота за один диалог
  </Card>
  <Card title="Установка" icon="download" href="/installation.ru">
    npm, curl | bash, Docker или ручной конфиг клиента
  </Card>
  <Card title="16 инструментов" icon="list" href="/tools.ru">
    Скаффолд, деплой, миграции и вебхуки
  </Card>
  <Card title="Ресурсы" icon="book" href="/resources.ru">
    tgcloud://docs/* — layout, SDK, CLI, лимиты
  </Card>
  <Card title="Безопасность" icon="shield" href="/security.ru">
    confirm: true, маскировка токенов, неофициальный статус
  </Card>
  <Card title="Кукбук" icon="utensils" href="/cookbook.ru">
    Бот с базой, кнопками и Mini App
  </Card>
</CardGroup>

## Возможности

- **16 инструментов** — команды `tgcloud` CLI, включая `upgrade` (layout до 0.2.0) и `deploy` (сборка, затем push)
- **Ресурсы** `tgcloud://docs/*` — встроенная справка платформы на английском, вровень с официальной документацией
- **Guardrails** — деструктивные операции требуют `confirm: true`, токены маскируются
- **Мультипроектность** — каждый инструмент принимает абсолютный `project_dir`

## Быстрый старт

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

Дальше: [Установка](installation.ru) → [Быстрый старт](quickstart.ru) →
[Кукбук](cookbook.ru).