Bedengan Apps MCP

Единственный способ сейчас публиковать или обновлять приложения в Bedengan App Hub (https://apps.wisatabedengan.com) — через AI-инструмент для кодинга (напр. Antigravity), а не через веб-страницу.

Кратко о повседневном использовании: после установки (один раз, см. ниже) достаточно попросить ИИ «загрузи эту папку как новое приложение» или «обнови приложение X последним кодом». Остальное — проверка проекта, исправление недостающего и отправка — выполняется автоматически. Ручного одобрения администратором больше нет: как только проверка пройдена, приложение сразу становится live.

Это не новый путь к VPS. Этот сервер лишь вызывает тот же API хаба через токен собственной учётной записи — он никогда не касается Docker или сервера напрямую.

Установка один раз на ноутбуке

1. Скачайте эту папку. Если вы не знакомы с git clone, просто нажмите зелёную кнопку «Code» → «Download ZIP» на странице этого репозитория GitHub, затем распакуйте в любую папку на ноутбуке (напр. Documents/bedengan-apps-mcp).

2. Запросите API-токен у администратора или создайте его сами, если у вас уже есть аккаунт: войдите на https://apps.wisatabedengan.com → кнопка «Token API» → «Buat / Perbarui Token API». Появившийся код показывается только один раз — запишите его, прежде чем закрывать окно.

3. Откройте терминал в папке, куда вы распаковали файлы, и выполните:

npm install
npm run build
npm run init

npm run init спросит URL хаба (нажмите Enter, чтобы использовать значение по умолчанию, https://apps.wisatabedengan.com) и токен из шага 2. Он сохраняется в ~/.bedengan-apps/config.json на вашем ноутбуке — никогда не попадает в ZIP-архив какого-либо проекта и не подлежит передаче другим людям.

Related MCP server: Citizen Deployment MCP Server

Подключение к Antigravity

Добавьте в настройки MCP-сервера Antigravity (найдите меню «MCP Servers» в его настройках):

{
  "mcpServers": {
    "bedengan-apps": {
      "command": "node",
      "args": ["/path/absolut/ke/folder-hasil-ekstrak/dist/index.js"]
    }
  }
}

Замените путь выше на расположение dist/index.js внутри папки, куда вы распаковали/установили файлы (шаг 1 выше) — полный путь, не относительный. После сохранения перезапустите Antigravity — теперь его ИИ может использовать инструменты ниже.

Что происходит, когда просят «загрузить эту папку»

1. ИИ проверяет проект (validate_project) — проверяет, что тип приложения определён, что секретные файлы (.env, ключи API) не попали в ZIP-архив и что структура полная.

2. Если что-то нужно исправить, ИИ исправляет только эту часть кода, затем проверяет снова — повторяет, пока всё не будет чисто. Вам не нужно вмешиваться, если только ИИ действительно не понимает, что делать.

3. После того как всё чисто, отправляется по-настоящему (submit_app для нового приложения, update_app для обновления уже live-приложения).

4. Никто не должен утверждать. Через несколько мгновений приложение уже можно открыть по адресу https://<subdomain-pilihan>.apps.wisatabedengan.com.

Доступные инструменты

Если используемый AI-инструмент для кодинга поддерживает «MCP prompts», есть также готовый сценарий под названием siapkan_dan_terbitkan, который объединяет шаги 1–4 выше в одну команду. Если он не поддерживается, не страшно — ИИ всё равно знает правильный порядок из описания каждого инструмента.

Если заявка отклонена

Сообщение об отклонении всегда указывает, что нужно исправить, например:

• «Отклонено автоматически — есть признаки загрузки секретов: файл .env попал в ZIP-архив» → удалите/исключите .env из отправляемого проекта (см. раздел «Что исключается автоматически» ниже) и попробуйте снова.

• «Тип приложения не распознан» → обычно главный файл находится не там, где ожидается (напр. index.html/app.py/package.json не в самой внешней папке) или отсутствует скрипт start. Попросите ИИ исправить структуру: статическому вебу нужен index.html в корне, Python нужен app.py + requirements.txt, Node нужен package.json со скриптом "start", который читает process.env.PORT и слушает на 0.0.0.0.

• «Ваша квота приложений Python/Node исчерпана» → сначала удалите одно из старых неиспользуемых приложений через веб-панель, затем попробуйте снова.

Хранение данных, которые должны сохраняться (базы данных, пользовательские загрузки и т. д.)

Если приложение хранит собственные данные (напр. базу данных зарплат, пользовательские загрузки, результаты ввода) и эти данные должны сохраняться даже после обновления приложения через update_app, сохраняйте всё в папке ./data/ в корне проекта (относительно папки, где находятся package.json/app.py/index.html). Эта папка — единственная часть приложения, которая НЕ заменяется при обновлении кода — остальные части (код, node_modules и т. д.) заменяются полностью при каждом успешном submit_app/update_app.

Если в проекте уже есть реальные данные в папке ./data/ при первой загрузке (напр. коллега переносит уже используемое приложение со своего ноутбука вместе с содержимым) — эти данные переносятся вместе и остаются на сервере с самого начала, переносить их вручную не нужно.

Что исключается автоматически при создании ZIP-архива

node_modules, .git, __pycache__, .venv/venv, .DS_Store, .next, .cache. Чтобы исключить что-то ещё, создайте файл .bedenganignore в корне папки проекта — по одному относительному имени папки/файла на строку (не полный glob, как в .gitignore, а просто точное имя).

Если токен утёк

Отзовите его самостоятельно через веб-панель (кнопка «Token API» → «Cabut Token API») или попросите администратора отозвать его из админ-панели — пароль для входа и веб-сессии при этом не затрагиваются. Создайте новый токен и снова выполните npm run init.