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

1. Подключение

1. В Claude (claude.ai или приложение) откройте Настройки → Коннекторы → Добавить свой коннектор.
2. Назовите его «Koi Launch», укажите адрес https://launch.koiswarm.com/mcp, добавьте и нажмите «Подключить».
3. На странице подтверждения нажмите «Подтвердить в Telegram». В Telegram откроется бот — нажмите «Подтвердить».
4. Вернитесь на страницу и нажмите «Разрешить». Теперь Claude может управлять приложениями от имени вашего аккаунта Telegram.

Отключить можно в любой момент в настройках Claude.

2. Создание и публикация

Просто попросите в диалоге:

• «Сделай тренажёр для экзамена по химии: вопросы по темам и повтор ошибок».
• «Покажи предпросмотр» → попробуйте приложение прямо в Claude, в той же среде, что и в Telegram.
• «Сделай кнопки крупнее», «Добавь ещё 30 вопросов» → Claude меняет только нужное.
• «Опубликуй в Telegram» → вы получите ссылку t.me/…?startapp=…, бот тоже пришлёт уведомление.

Каждая публикация создаёт новую версию, ссылка не меняется. Скажите «Верни предыдущую версию» — и Claude откатит изменения.

3. Приложения и обмен

• Кнопка меню бота (Apps) открывает список всех ваших приложений.
• Поделиться можно тремя способами: кнопка ↗ в списке, кнопка внутри приложения или введите @koilaunch_bot в любом чате и выберите приложение.
• Приложения, которые открыли друзья, появятся у них во вкладке «Общие и недавние». Данные каждого друга хранятся отдельно.
• Доступ: «по ссылке» (по умолчанию) или «только я». Скажите Claude «Сделай приложение закрытым», чтобы переключить.

4. Среда и SDK

Перед созданием Claude читает руководство платформы (get_platform_guide) и следует правилам среды:

• Приложения раздаются с отдельного домена и работают в изолированном iframe-песочнице (opaque origin).
• localStorage работает как обычно и сохраняется на сервере для каждой пары «пользователь × приложение».
• window.TgApp даёт storage, shared (рейтинги), haptic, share, mainButton / backButton, alert, CSS-переменные темы (--tg-bg …) и безопасные зоны (--tg-safe-top …).
• Основные части window.Telegram.WebApp (HapticFeedback, MainButton, BackButton, CloudStorage, showAlert…) доступны как слой совместимости.

const p = TgApp.storage.get("progress", { correct: 0 });
p.correct++;
TgApp.storage.set("progress", p);
await TgApp.shared.put("scores", { name: TgApp.user.firstName }, { score: p.correct });
const top = await TgApp.shared.list("scores", { order: "score", limit: 10 });
TgApp.share({ text: "9 из 10!" });

5. Ограничения

6. Правила публикации

Запрещено: фишинг, сбор паролей и данных карт, выдача себя за реальные сервисы или людей, вредоносный код и незаконный контент. Приложения по жалобам проверяются и блокируются. Пожаловаться можно через меню (⋯) открытого приложения.

7. Конфиденциальность

Мы храним ваш ID, имя и username в Telegram, файлы созданных приложений и данные, сохранённые внутри приложений.

Код приложения может читать данные, которые вы используете в этом приложении, а также ваше имя и ID в Telegram, и может отправить их на внешние серверы — пользуйтесь приложениями только от тех, кому доверяете. Всё, что вы записываете в общие данные (например, рейтинги), видят все пользователи приложения. Приложения изолированы друг от друга и не имеют доступа к вашим аккаунтам KoiSwarm и Telegram. При удалении приложения удаляются и все его данные.