> ## 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-клиента

# Установка

Нужен **Node.js 20+**. CLI платформы требует Node.js 18+.

<CardGroup cols={2}>
  <Card title="npm" icon="box" href="#npm">
    npm install -g tgcloud-mcp, затем tgcloud-mcp setup
  </Card>
  <Card title="Одна команда" icon="terminal" href="#curl-bash">
    curl | bash — сначала язык, затем баннер и мастер
  </Card>
  <Card title="Docker" icon="layers" href="#docker">
    ghcr.io/sdamarketing/tgcloud-mcp, stdio, без Node на хосте
  </Card>
  <Card title="Конфиги клиентов" icon="plug" href="#clients">
    opencode, Claude Code, Cursor, VS Code
  </Card>
</CardGroup>

## Из npm {#npm}

```bash
npm install -g tgcloud-mcp
tgcloud-mcp setup     # мастер настройки клиента
```

Мастер записывает MCP-конфиг и спрашивает, ставить ли
[Agent Plugin](https://agent-plugins.org) (каталог `agent-plugin/` в репозитории).
Копия попадает в `~/.tgcloud-mcp/agent-plugin`. Для Cursor — в
`~/.cursor/plugins/local/tgcloud`. Для VS Code — запись в `chat.pluginLocations`.
Codex, Copilot и Kiro подхватывают тот же каталог через свой UI плагинов.

Claude Code и opencode продолжают использовать MCP-конфиг. Скилл:

```bash
npx skills add sdamarketing/tgcloud_mcp
```

## Одна команда {#curl-bash}

```bash
curl -fsSL https://raw.githubusercontent.com/sdamarketing/tgcloud_mcp/main/install.sh | bash
```

Клонирует в `~/.tgcloud-mcp`, собирает, запускает мастер. Повторный запуск обновляет.
Сначала вопрос о языке (English, Русский, 中文, العربية, Deutsch, Français;
Enter — английский, либо `TGCLOUD_MCP_LANG`). Затем баннер в рамке (синий
градиент в truecolor-терминале) и спиннер на время клонирования, установки и
сборки. Мастер идёт на том же языке и читает `/dev/tty`, поэтому вопросы
задаются и при `curl | bash`.

## Docker {#docker}

```bash
docker run -i --rm ghcr.io/sdamarketing/tgcloud-mcp
```

## Конфиги клиентов {#clients}

**opencode** (`~/.config/opencode/opencode.json`):

```json
{ "mcp": { "tgcloud": { "type": "local", "command": ["npx", "-y", "tgcloud-mcp"], "enabled": true } } }
```

**Claude Code / Cursor:**

```json
{ "mcpServers": { "tgcloud": { "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }
```

**VS Code** (`mcp.json`):

```json
{ "servers": { "tgcloud": { "type": "stdio", "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }
```

## Переменные окружения

| Переменная | По умолчанию | Назначение |
|---|---|---|
| `TGCLOUD_CLI` | `npx` | Команда запуска CLI (можно обёртку с прокси) |
| `TGCLOUD_CLI_ARGS` | `tgcloud` | Аргументы перед субкомандой |
| `TGCLOUD_TIMEOUT_MS` | `120000` | Таймаут одной команды. `deploy` даёт сборке не меньше 300000 мс |
| `TGCLOUD_TOKEN` | — | CLI access token вместо `tgcloud login` |