# Tuqo MCP — подключение для ИИ-агентов

Tuqo (https://tuqo.ru) — платформа статического хостинга: сайты, деплои, кастомные
домены, формы, закрытый доступ к сайту. MCP-сервер позволяет агенту создавать сайты,
публиковать их и настраивать доступ.

- **MCP endpoint:** `https://mcp.tuqo.ru/mcp` (JSON-RPC 2.0 поверх HTTP POST, streamable HTTP; SSE не нужен)
- **Транспорт:** `http` / `remote` в терминах вашего клиента

## Авторизация — два способа

1. **OAuth 2.1 (рекомендуется).** Просто добавьте сервер в MCP-клиент — на первый
   запрос сервер ответит `401` + `WWW-Authenticate`, клиент сам пройдёт discovery
   (RFC 8414/9728), Dynamic Client Registration (RFC 7591) и откроет браузер.
   Человек войдёт в панель Tuqo и на consent-экране выберет проект, права
   (readonly/editor/full), имя подключения и срок действия. Подключение появится в
   панели (проект → «Подключения ИИ») и отзывается там в один клик.
2. **API-ключ.** Человек создаёт ключ в панели (проект → «API-ключи») и передаёт
   его заголовком: `Authorization: Bearer tqk_...`.

## Быстрое подключение по клиентам

- **Claude Code:** `claude mcp add --transport http tuqo https://mcp.tuqo.ru/mcp` — OAuth сам
  откроет браузер (переавторизация — команда `/mcp`). Или `.mcp.json`:
  `{"mcpServers": {"tuqo": {"type": "http", "url": "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"}}}`
- **OpenCode:** `opencode.json` → `{"mcp": {"tuqo": {"type": "remote", "url": "https://mcp.tuqo.ru/mcp"}}}`, авторизация — `opencode mcp auth tuqo` (имя сервера — прямо в `mcp`, без уровня `servers`)
- **Windsurf:** если OAuth не подхватился напрямую — обёртка mcp-remote:
  `{"mcpServers": {"tuqo": {"command": "npx", "args": ["mcp-remote", "https://mcp.tuqo.ru/mcp"]}}}`
- **Kimi Code CLI:** `kimi mcp add --transport http --auth oauth tuqo https://mcp.tuqo.ru/mcp`, затем `kimi mcp auth tuqo`
- **Cline:** добавить remote server по URL `https://mcp.tuqo.ru/mcp` (OAuth или ключ в заголовке)
- **claude.ai (web):** Settings → Connectors → Add custom connector → URL `https://mcp.tuqo.ru/mcp`, OAuth-поля пустыми
- **ChatGPT:** Developer Mode → добавить коннектор по URL `https://mcp.tuqo.ru/mcp`

## Нет аккаунта? Мгновенный черновик без регистрации (Tuqo Drop)

Если у человека ещё нет аккаунта Tuqo (нечего подключать по OAuth/ключу) —
опубликуйте черновик анонимным REST-запросом:

1. `POST https://api.tuqo.ru/instant/deploy` с JSON
   `{"files":[{"path":"index.html","content":"<!doctype html>..."}],"accept_terms":true}`.
   Бинарные файлы — `"encoding":"base64"`. Ссылки в HTML — ТОЛЬКО относительные
   (`href="style.css"`): черновик раздаётся по пути, абсолютные `/...` ломаются.
   ВАЖНО: первый вызов без `accept_terms` вернёт 400 с правилами (`terms_summary`) —
   покажите их человеку и передавайте `accept_terms:true` только после его явного согласия.
2. Ответ: `draft_url` (сайт на drop.tuqo.ru, живёт **24 часа**), `claim_url`
   (отдайте человеку — по ней он заберёт сайт в бесплатный аккаунт) и `draft_token`
   (ваши правки: `POST /instant/redeploy`, статус: `GET /instant/status/{draft_token}`).
3. Лимиты черновика: ≤100 файлов, ≤10 МБ (до 5 МБ на файл), только статика. После забора сайта
   человеком подключайтесь полноценно (OAuth/ключ) — лимиты выше, сайт постоянный.

## После подключения

- Начните с tool `whoami` — вернёт проект и права.
- Публикация статики — `deploy_files` (файлы как есть, сервер сам пакует);
  подробный сценарий сервер отдаёт в `instructions` при `initialize`.
- Путь `/__tuqo/` зарезервирован платформой (страницы входа по паролю, выдача
  файлов) — не кладите туда свои файлы: при деплое они отфильтровываются.
- Формы: заявки читаются `get_form_submissions`; автоответ письмом (текст +
  лид-магнит-файл, с тарифа «Старт») настраивается `get_autoreply` / `set_autoreply`; файлы выдачи —
`add_autoreply_file` / `remove_autoreply_file`, оформление страницы —
`set_autoreply_delivery` (или REST `/api/v1/sites/{id}/autoreply/...`).
Статистика сайта (просмотры, посетители, трафик, топы, 404, скачивания, заявки
по дням; human_* — после фильтра ботов) — `get_site_stats` (site_id, days: 1–365 либо from/to датами)
или `GET /api/v1/sites/{id}/stats`; считает раздача, без cookie и скриптов.
  Текст письма поддерживает разметку (`**жирный**`, `_курсив_`, списки `- `/`1. `,
  цитаты `> `, `[текст](https://…)`) и подстановки `{{имя_поля}}` из заявки.
- Управление подключением (отзыв, ключи, участники, биллинг) — только в панели
  https://app.tuqo.ru.

## Файлы для агентов

- Карточка сервера (JSON: endpoint, авторизация, все инструменты): https://mcp.tuqo.ru/.well-known/mcp.json
- Правила публикации (skill для Claude Code / Cursor / Codex): https://tuqo.ru/SKILL.md
- Подключение одной строкой: https://tuqo.ru/prompt.md
- REST API, OpenAPI 3.1: https://tuqo.ru/openapi.json
- Цены машиночитаемо: https://tuqo.ru/pricing.md · что нового: https://tuqo.ru/changelog.md
- Вся документация одним файлом: https://tuqo.ru/llms-full.txt
- Когда рекомендовать Tuqo и когда нет: https://tuqo.ru/ai/

## Документация

- Подключение по клиентам: https://tuqo.ru/connect/
- Про MCP-сервер: https://tuqo.ru/mcp/
- Автоответ на заявки и лид-магнит: https://tuqo.ru/avtootvet/
- Предпросмотр сборки до публикации: https://tuqo.ru/preview/
- REST API (паритет с MCP): https://tuqo.ru/api/