# Tuqo — подключение за одну строку

Ты — ИИ-агент, и человек попросил подключить Tuqo (tuqo.ru, российский хостинг
статических сайтов с MCP). Выполни шаги по порядку и отчитайся коротко.

## 1. Добавь MCP-сервер

Endpoint: `https://mcp.tuqo.ru/mcp` (Streamable HTTP, JSON-RPC 2.0).

- Claude Code: `claude mcp add --transport http tuqo https://mcp.tuqo.ru/mcp`
- Codex CLI: `codex mcp add tuqo --url https://mcp.tuqo.ru/mcp`, затем `codex mcp login tuqo`
- Cursor: в `.cursor/mcp.json` → `{"mcpServers": {"tuqo": {"url": "https://mcp.tuqo.ru/mcp"}}}`
- VS Code (Copilot): `.vscode/mcp.json` → `{"servers": {"tuqo": {"type": "http", "url": "https://mcp.tuqo.ru/mcp"}}}`
- Windsurf, Cline, Kimi Code, OpenCode, claude.ai, ChatGPT: конфиги — https://tuqo.ru/ai.md
- Gemini CLI, Continue, Zed, Qwen Code, GigaChat: страницы — https://tuqo.ru/connect/

## 2. Авторизуйся

Сервер ответит `401` + `WWW-Authenticate`; клиент сам пройдёт OAuth 2.1 (DCR) и
откроет браузер. Человек войдёт в панель и на consent-экране выберет проект, права
(readonly / editor / full) и срок подключения. Если браузер недоступен — попроси у
человека API-ключ `tqk_…` (панель app.tuqo.ru → проект → «API-ключи») и передавай
его заголовком `Authorization: Bearer tqk_…`. Ключ показывается один раз, в файлы
сайта его класть нельзя.

## 3. Проверь

Вызови `whoami` — вернёт `project_id`, название проекта и `scopes`. Если ответ
пришёл — подключение работает.

## 4. Прочитай правила

https://tuqo.ru/SKILL.md — порядок публикации, что нельзя, как читать ошибки.
Это 3 минуты.

## 5. Пять вещей, которые надо знать

1. `deploy_files(site_id, files)` — ПОЛНЫЙ набор файлов сайта (не патч), `index.html`
   в корне, ссылки относительные; картинки — `encoding: "base64"`. Публикация
   мгновенная, без сборки.
2. Правка существующего сайта: `get_manifest(site_id)` → неизменные файлы передай как
   `{path, sha256}` без содержимого, изменённые — с `content`. Медиа не перезаливаются.
3. Главное для человека — поле `url` в ответе (боевой адрес). Покажи его сразу.
4. В ответе деплоя бывает `recommendations` («Что улучшить»): перечисли коротко и
   предложи исправить. Не переделывай без спроса.
5. У человека нет аккаунта? Черновик без регистрации:
   `POST https://api.tuqo.ru/instant/deploy` с `{"files":[…],"accept_terms":true}` —
   24 часа, в ответе `draft_url` и `claim_url` (по ней сайт забирают в аккаунт).
   Правила показать человеку до `accept_terms`.

## 6. Спроси, что публиковать

Не создавай сайт «на пробу» без запроса. Уточни у человека: что за сайт, есть ли
готовые файлы, нужен ли свой домен. Дальше — по `next_action` из ответов сервера.

Ссылки: https://tuqo.ru/ai.md · https://mcp.tuqo.ru/.well-known/mcp.json ·
https://tuqo.ru/openapi.json · https://tuqo.ru/llms.txt