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

> Serveur MCP pour les bots Telegram serverless (@tgcloud)

# tgcloud-mcp

[English](index.en) · [Русский](index.ru) · [中文](index.zh) · [العربية](index.ar) · [Deutsch](index.de)

Un serveur MCP qui apprend à un assistant à gérer des **bots Telegram serverless** (plateforme `@tgcloud`, core.telegram.org/bots/serverless) : échafaudage, liaison du bot, handlers et endpoints, déploiement, migrations, webhooks.

Fonctionne avec tout client MCP : opencode, Claude Code, Cursor, Claude Desktop, VS Code (Copilot), Windsurf, Zed. Le même serveur et le même skill sont aussi livrés comme un [Agent Plugin](https://agent-plugins.org) pour Codex, Cursor, Copilot, Kiro et VS Code.

<CardGroup cols={2}>
  <Card title="Démarrage" icon="rocket" href="/quickstart.fr">
    Du jeton CLI access à un bot en ligne, en un dialogue
  </Card>
  <Card title="Installation" icon="download" href="/installation.fr">
    npm, curl | bash, Docker, ou une config client manuelle
  </Card>
  <Card title="16 outils" icon="list" href="/tools.fr">
    Échafaudage, déploiement, migrations et webhooks
  </Card>
  <Card title="Ressources" icon="book" href="/resources.fr">
    tgcloud://docs/* — structure, SDK, CLI, limites
  </Card>
  <Card title="Sécurité" icon="shield" href="/security.fr">
    confirm: true, jetons masqués, projet non officiel
  </Card>
  <Card title="Recette" icon="utensils" href="/cookbook.fr">
    Un bot avec base, boutons et Mini App
  </Card>
</CardGroup>

## Fonctions

- **16 outils** pour la CLI `tgcloud`, dont `upgrade` (disposition d'avant 0.2.0) et `deploy` (build, puis push)
- **Ressources** `tgcloud://docs/*` — référence intégrée de la plateforme, en anglais, alignée sur la documentation officielle
- **Gardes** — les opérations destructives exigent `confirm: true` ; les jetons sont masqués
- **Plusieurs projets** — chaque outil reçoit un `project_dir` absolu

## Démarrage

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

Ensuite : [Installation](installation.fr) → [Démarrage](quickstart.fr) → [Recette](cookbook.fr).