Ваш проект. Ваш помощник.
Одна платформа.

Подключение: три шага

MCP подключается к одному проекту, а не ко всему аккаунту. Если проекта ещё нет, создайте его — можно пустой.

1. Откройте проект и нажмите плитку «MCP-коннектор» (или Настройки → Свой ИИ / MCP).
2. Выберите, где вы общаетесь с ИИ: Claude, ChatGPT или Claude Code / Codex. Создайте ключ на 1, 7 или 30 дней; галочка «Разрешить изменять черновик» нужна, чтобы ИИ мог что-то менять.
3. Сделайте шаги из инструкции для своего ИИ ниже. Когда ИИ подключится, в кабинете появится отметка «Ваш ИИ подключился».

Ничего скачивать не нужно: ИИ получает одну ссылку, в которой уже есть ключ. Храните её как пароль и не публикуйте. Встроенная KIRA AI работает в конструкторе и без этого.

Claude — сайт и приложение

Подходит для бесплатного и платного Claude. На бесплатном тарифе можно подключить один свой коннектор.

1. Откройте claude.ai → Настроить → Коннекторы (claude.ai/customize/connectors).
2. Нажмите «+» → «Добавить свой коннектор» (Add custom connector).
3. Название — KIRA, адрес — ссылка-коннектор из кабинета. Нажмите «Продолжить», вход — «Без входа» (No sign in), затем «Добавить».
4. В новом чате нажмите «+» внизу слева → «Коннекторы» и включите KIRA. Первая просьба: «Прочитай мой проект KIRA и расскажи, что в нём есть. Ничего не меняй».

ChatGPT

Нужна платная подписка (Plus, Pro, Business, Enterprise или Edu) и сайт chatgpt.com: в мобильном приложении этих настроек нет.

1. Откройте chatgpt.com → Настройки → «Безопасность и вход» и включите «Режим разработчика».
2. Откройте «Плагины» → «+». Название — KIRA, MCP server URL — ссылка-коннектор из кабинета, авторизация — «Без авторизации» (No authentication). Создайте.
3. В новом чате нажмите «+» → «Режим разработчика» и выберите KIRA.
4. Перед каждым изменением ChatGPT показывает, что собирается сделать, и просит подтверждение — проверьте и нажмите «Подтвердить».

Claude Code и Codex

Программы для разработки на компьютере. Подключаются сами — им достаточно сообщения.

1. В кабинете выберите «Claude Code или Codex», создайте ключ и нажмите «Скопировать сообщение».
2. Вставьте сообщение в чат Claude Code или Codex и отправьте. ИИ выполнит команду сам: claude mcp add … или codex mcp add ….
3. Откройте новый чат: в /mcp появится kira. Попросите прочитать проект.

Если ИИ не может открыть ссылку (например, старая версия Claude Desktop), в кабинете есть запасной путь — файл-коннектор и готовая настройка. Для него нужен Node.js 22 или новее.

Если вы с телефона

Claude

В приложении коннектор добавить нельзя. Один раз добавьте его на claude.ai в браузере телефона или на компьютере — после этого KIRA доступна и в приложении Claude.

ChatGPT

Настройки режима разработчика есть только на сайте. Откройте chatgpt.com в Chrome, в меню браузера включите «Версия для ПК» и пройдите шаги. Проще — на компьютере.

Claude Code и Codex

Работают на компьютере. Создайте ключ, открыв кабинет KIRA там же.

Дорабатывайте то, что уже работает

Опишите изменение

Например: «Прочитай проект, сохрани запись и оплату. Добавь страницу услуг и кнопку в меню». Помощник видит актуальный сценарий и страницы.

Проверьте черновик

Обновите проект в браузере, пройдите диалог и проверьте страницы. Перед изменением KIRA создаёт копию; устаревшая правка отклоняется.

Опубликуйте сами

Сохранение через MCP не меняет работающую публикацию. Запуск на хостинге KIRA выполняется владельцем в мастере публикации; для рабочего Telegram-бота подключается собственный бот.

GitHub — по желанию

Для работы в KIRA репозиторий не нужен. Если вы привыкли к GitHub, храните копии проекта рядом со своей разработкой.

1. Попросите MCP-помощника прочитать проект и сохранить содержимое черновика в файл kira-project.json на вашем компьютере. Не добавляйте конфигурацию MCP, ключи и токены в репозиторий.
2. Проверьте файл и сохраните его в своём репозитории обычным коммитом. Доступ к GitHub выдаётся вашему инструменту отдельно, а не через ключ проекта KIRA.
3. Чтобы перенести правку обратно, помощник читает текущий проект и схему KIRA, проверяет UUID страниц и узлов и обновляет черновик с актуальным fingerprint.
4. Размещение результата происходит на KIRA после проверки. Произвольный код из репозитория пока не импортируется и не запускается на сервере конструктора.

Сейчас это рабочий процесс через локального помощника и GitHub. Кнопка автоматической синхронизации репозитория и размещение произвольного кода ещё не доступны. JSON проекта KIRA не является самостоятельным сайтом для GitHub Pages.

API: понятные операции, ограниченный доступ

Адрес API — тот же домен KIRA. Авторизация: Authorization: Bearer <ключ проекта>. Для API ключ передаётся только в заголовке: не вставляйте его в браузерный код сайта и не храните в GitHub. Исключение — ссылка-коннектор MCP: ключ уже внутри неё, поэтому храните её как пароль.

GET /v1/developer/projects/{projectId}
GET /v1/developer/projects/{projectId}/schema
GET /v1/developer/projects/{projectId}/history
PUT /v1/developer/projects/{projectId}
POST /v1/developer/projects/{projectId}/restore

Для PUT нужны content, expectedFingerprint, idempotencyKey (UUID) и summary. Для восстановления — versionId, expectedFingerprint и idempotencyKey. Повтор после сетевого сбоя отправляйте с тем же ключом и тем же телом. 401 — доступ истёк/отозван; 403 — только чтение; 409 — проект изменился или ключ повтора уже использован; 429 — слишком много запросов.

Где заканчивается доступ помощника

Только выбранный проект

Нет доступа к чужим проектам, CRM, заявкам клиентов, платежным записям и токенам Telegram. Подмена UUID проекта отклоняется сервером.

Без доступа к серверу

MCP проекта не выполняет команды, SQL и произвольный код, не читает файловую систему сервера и не управляет админкой.

Отдельно для владельца платформы

Служебный коннектор владельца читает агрегированную аналитику KIRA. Сервер проверяет право владельца; обычный аккаунт и ключ проекта такой доступ не получают. Для клиентской доработки мастер работает с согласованными материалами и предлагает правки на проверку.

Что появится дальше

План развития: вход через аккаунт KIRA (OAuth) вместо ключа и выбор проекта при подключении → загрузка файлов и сборки сайтов/Mini Apps → изолированный запуск собственного кода ботов. Эти режимы будут опубликованы после реализации и проверки.