Bedengan Apps MCP

現在、Bedengan App Hub（https://apps.wisatabedengan.com）でアプリを公開・更新する唯一の方法は、AIコーディングツール（例：Antigravity）経由です。ウェブページ経由ではありません。

日常的な使い方（要約）： 一度インストールすれば（下記参照）、AIに 「このフォルダを新しいアプリとしてアップロードして」 や 「アプリXを最新コードで更新して」 と頼むだけです。残り（プロジェクトの確認、不足があれば修正、送信）は自動で行われます。手動で承認する管理者はいません。チェックを通過すれば、アプリはすぐに公開されます。

これはVPSへの新しい経路ではありません。 このサーバーは、自分のアカウントのトークンを使って同じハブAPIを呼び出すだけです。Dockerやサーバーに直接触れることはありません。

ラップトップに一度だけインストール

1. このフォルダをダウンロードします。 git clone に慣れていない場合は、このリポジトリのGitHubページで緑色の "Code" → "Download ZIP" ボタンをクリックし、ラップトップの任意の場所（例：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 に保存されます。決してプロジェクトに同梱されることはなく、他人と共有してはいけません。

Related MCP server: Citizen Deployment MCP Server

Antigravityに接続

AntigravityのMCPサーバー設定に追加します（設定メニューで「MCP Servers」を探してください）：

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

上記のパスを、解凍/インストールしたフォルダ（上記の手順1）内の dist/index.js の場所に置き換えてください。相対パスではなく完全なパスです。保存後、Antigravityを再起動します。これでAIは以下のツールを使えるようになります。

「このフォルダをアップロード」と頼んだ場合の流れ

1. AIがプロジェクトを検査します（validate_project）— アプリの種類が検出されるか、秘密のファイル（.env、APIキー）がZIPに含まれていないか、構造が完全かどうかを確認します。

2. 修正が必要な点があれば、AIはその部分だけをコードで修正し、再チェックします。クリーンになるまで繰り返します。AIが本当に混乱しない限り、あなたが介入する必要はありません。

3. クリーンになったら、実際に送信します（新しいアプリは submit_app、公開済みアプリの更新は update_app）。

4. 承認者は不要です。 しばらくすると、アプリは https://<選択したサブドメイン>.apps.wisatabedengan.com で開けるようになります。

利用可能なツール

使用しているAIコーディングツールが「MCPプロンプト」をサポートしている場合、上記の手順1〜4を1つのコマンドにまとめた、すぐに使えるフロー siapkan_dan_terbitkan もあります。サポートされていない場合でも問題ありません。AIは各ツールの説明から正しい順序を理解します。

拒否された場合

拒否メッセージには、修正すべき点が必ず記載されています。例：

• "Ditolak otomatis -- ada indikasi rahasia ikut terunggah: Berkas .env ikut ter-zip" → 送信するプロジェクトから .env を削除/除外します（下記の「自動的に除外されるもの」を参照）、そして再試行します。

• "Jenis aplikasi tidak dikenali" → 通常、メインファイルが期待される場所にない（例：index.html/app.py/package.json が最外フォルダにない）か、start スクリプトがないことを意味します。AIに構造を修正してもらいます：静的ウェブはルートに index.html が必要、Pythonは app.py + requirements.txt が必要、Nodeは process.env.PORT を読み取り 0.0.0.0 でリッスンする "start" スクリプトを持つ package.json が必要です。

• "Jatah aplikasi Python/Node Anda sudah penuh" → ウェブダッシュボードで不要になった古いアプリを削除してから、再試行してください。

永続化が必要なデータの保存（データベース、ユーザーアップロードなど）

アプリが独自にデータを保存する場合（例：給与データベース、ユーザーアップロード、入力結果）、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 ファイルを作成します — 各行に相対パスのフォルダ/ファイル名を1つずつ記述します（.gitignore のような完全なグロブではなく、正確な名前で十分です）。

トークンが漏洩した場合

ウェブダッシュボード（「Token API」ボタン →「Cabut Token API」）から自分で失効させるか、管理者に管理パネルから失効させてもらいます。ログインパスワードやウェブセッションには影響しません。新しいトークンを作成し、npm run init を再度実行してください。