Установка#

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

Из npm #

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

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

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

npx skills add sdamarketing/tgcloud_mcp

Одна команда #

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 run -i --rm ghcr.io/sdamarketing/tgcloud-mcp

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

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

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

Claude Code / Cursor:

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

VS Code (mcp.json):

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

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