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에 로그인 → "API 토큰" 버튼 → 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 키)이 함께 압축되지 않는지, 구조가 완전한지 확인합니다.

2. 수정해야 할 부분이 있으면 AI가 코드에서 해당 부분만 수정한 다음 다시 검사합니다 — 깨끗해질 때까지 반복합니다. AI가 정말 혼란스러워하지 않는 한 직접 개입할 필요가 없습니다.

3. 깨끗해지면 실제로 전송합니다(submit_app은 새 앱, update_app은 이미 라이브인 앱 업데이트).

4. 승인할 사람이 없습니다. 잠시 후 앱은 https://<선택한-서브도메인>.apps.wisatabedengan.com에서 열 수 있습니다.

사용 가능한 도구

사용 중인 AI 코딩 도구가 "MCP 프롬프트"를 지원한다면, 위 1-4단계를 하나의 명령으로 묶은 **siapkan_dan_terbitkan**이라는 바로 사용 가능한 흐름도 있습니다. 지원하지 않아도 문제없습니다 — AI는 각 도구의 설명에서 올바른 순서를 알고 있습니다.

거부된 경우

거부 메시지에는 항상 수정해야 할 사항이 명시되어 있습니다. 예:

• "비밀 정보가 함께 업로드된 것으로 감지되어 자동 거부됨: .env 파일이 함께 압축됨" → 전송하는 프로젝트에서 .env를 삭제/제외하고(아래 "자동 제외 항목" 섹션 참조) 다시 시도하세요.

• "앱 유형을 인식할 수 없음" → 일반적으로 기본 파일이 예상 위치에 없거나(예: 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이 필요합니다.

• "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 파일을 만드세요 — 줄당 상대 폴더/파일 이름 하나씩(.gitignore와 같은 전체 glob이 아니라 정확한 이름만).

토큰이 유출된 경우

웹 대시보드에서 직접 취소하거나("API 토큰" 버튼 → "API 토큰 취소") 관리자에게 관리자 패널에서 취소하도록 요청하세요 — 로그인 비밀번호와 웹 세션은 영향을 받지 않습니다. 새 토큰을 만들고 npm run init을 다시 실행하세요.