Bedengan Apps MCP

现在在 Bedengan App Hub（https://apps.wisatabedengan.com）发布或更新应用的唯一方式——通过 AI 编码工具（例如 Antigravity），不再通过网页。

日常使用方式，简而言之： 安装完成后（只需一次，见下文），只需让 AI "帮我把这个文件夹上传为新应用" 或 "用最新代码更新应用 X"。其余工作——检查项目、修复缺失的部分、然后提交——全部自动完成。不再需要管理员手动审批：一旦通过检查，应用立即上线。

这不是通往 VPS 的新通道。 此服务器仅通过您自己的账户令牌调用同一个 hub API——从不直接接触 Docker 或服务器。

在笔记本电脑上安装一次

1. 下载此文件夹。 如果不熟悉 git clone，只需点击此 GitHub 仓库页面上的绿色 "Code" → "Download ZIP" 按钮，然后解压到笔记本电脑上的任意文件夹（例如 Documents/bedengan-apps-mcp）。

2. 向管理员索取 API 令牌，或者如果已有账户可自行创建：登录 https://apps.wisatabedengan.com → 点击 "Token API" 按钮 → 创建 / 更新 API 令牌。显示的代码只出现一次——关闭窗口前请先记下来。

3. 在刚才解压的文件夹中打开终端，运行：

npm install
npm run build
npm run init

npm run init 会询问 hub 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"]
    }
  }
}

将上面的路径替换为刚才解压/安装的文件夹中 dist/index.js 的位置（上面的第 1 步）——使用完整路径，而非相对路径。保存后，重启 Antigravity——AI 现在可以使用下面的工具了。

当被要求"上传这个文件夹"时会发生什么

1. AI 检查项目（validate_project）——检查应用类型是否被识别、是否有秘密文件（.env、API 密钥）被打包、以及结构是否完整。

2. 如果有需要修复的地方，AI 只修复代码中的那部分，然后重新检查——反复进行直到干净。除非 AI 真的困惑，否则您无需干预。

3. 干净之后，真正提交（新应用用 submit_app，更新已上线的应用用 update_app）。

4. 无需任何人审批。 片刻之后，应用就可以在 https://<subdomain-pilihan>.apps.wisatabedengan.com 打开。

可用工具

如果所用的 AI 编码工具支持 "MCP prompts"，还有一个名为 siapkan_dan_terbitkan 的现成流程，将上面的第 1-4 步封装为一条命令。如果不支持也没关系——AI 仍然能从每个工具的描述中知道正确的顺序。

如果被拒绝

拒绝消息总会说明需要修复什么，例如：

• "自动拒绝——有迹象表明秘密文件被上传：.env 文件被打包" → 从发送的项目中删除/排除 .env（见下文"自动排除的内容"部分），然后重试。

• "无法识别应用类型" → 通常是因为主文件不在预期位置（例如 index.html/app.py/package.json 不在最外层文件夹）或没有 start 脚本。让 AI 修复结构：静态网站需要在根目录有 index.html，Python 需要 app.py + requirements.txt，Node 需要带有 "start" 脚本的 package.json，该脚本读取 process.env.PORT 并监听 0.0.0.0。

• "您的 Python/Node 应用配额已满" → 先通过 Web 仪表板删除一个不再使用的旧应用，然后再试。

保存需要持久化的数据（数据库、用户上传等）

如果应用自己存储数据（例如工资数据库、用户上传、输入结果），并且即使以后通过 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 文件——每行一个相对文件夹/文件名（不像 .gitignore 那样使用完整 glob，只需精确名称）。

如果令牌泄露

通过 Web 仪表板自行撤销（"Token API" 按钮 → "Cabut Token API"）或让管理员从管理面板撤销——登录密码和 Web 会话不受影响。创建新令牌，再次运行 npm run init。