# 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": {"servers": {"tuqo": {"type": "remote", "url": "https://mcp.tuqo.ru/mcp"}}}}`, авторизация — `opencode mcp auth tuqo` - **Windsurf:** если OAuth не подхватился напрямую — обёртка mcp-remote: `{"mcpServers": {"tuqo": {"command": "npx", "args": ["mcp-remote", "https://mcp.tuqo.ru/mcp"]}}}` - **Kimi Code CLI:** `kimi mcp add --transport http https://mcp.tuqo.ru/mcp` - **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 (нечего подключать) — опубликуйте черновик анонимным REST-запросом, БЕЗ ключа и OAuth: 1. `POST https://api.tuqo.ru/instant/deploy` с JSON `{"files":[{"path":"index.html","content":"..."}],"accept_terms":true}`. Бинарные файлы — `"encoding":"base64"`. Ссылки в HTML — ТОЛЬКО относительные (`href="style.css"`): черновик раздаётся по пути, абсолютные `/...` ломаются. ВАЖНО: первый вызов без `accept_terms` вернёт 400 с правилами (`terms_summary`) — покажите их человеку и передавайте `accept_terms:true` только после его явного согласия. 2. Ответ: `draft_url` (сайт живёт **24 часа**), `claim_url` (отдайте человеку — по ней он заберёт сайт в бесплатный аккаунт) и `draft_token` (правки: `POST /instant/redeploy`, статус: `GET /instant/status/{draft_token}`). 3. Лимиты черновика: ≤100 файлов, ≤10 МБ (до 5 МБ на файл), только статика. После забора сайта человеком подключайтесь сюда полноценно — лимиты выше, сайт постоянный. ## После подключения - Начните с tool `whoami` — вернёт проект и права. - Публикация статики — `deploy_files` (файлы как есть, сервер сам пакует); подробный сценарий сервер отдаёт в `instructions` при `initialize`. - Управление подключением (отзыв, ключи, участники, биллинг) — только в панели https://app.tuqo.ru. ## Документация - Подключение по клиентам: https://tuqo.ru/connect/ - Про MCP-сервер: https://tuqo.ru/mcp/ - REST API (паритет с MCP): https://tuqo.ru/api/ - Черновики без регистрации: https://tuqo.ru/drop/