#pabal-mcp — App Store / Play Store ASO용 MCP 서버

앱스토어/플레이스토어 메타데이터, 릴리스, ASO 동기화를 MCP 도구로 제공합니다. Claude Code, Cursor, MCP Inspector 등 MCP 클라이언트에서 stdio 서버로 실행해 바로 사용할 수 있습니다.

[!NOTE] 100% 로컬에서 실행되어 자격 증명과 캐시된 ASO 데이터가 외부로 전송되지 않습니다. 스토어 API 호출도 당신의 로컬 머신에서 직접 수행합니다.

#❌ pabal-mcp 없이

• 스토어마다 클릭하며 업데이트
• 로캘·릴리스 노트 복붙 오류
• 프로젝트마다 반복 설정

#✅ pabal-mcp와 함께

• 두 스토어 ASO 풀/푸시를 한 서버에서 처리
• 릴리스 노트 업데이트·버전 체크를 AI 클라이언트 안에서 수행
• 로컬 캐시/설정 기반의 재사용 가능한 워크플로

#🛠️ MCP 클라이언트 설치

#요구 사항

• Node.js 18 이상
• MCP 클라이언트: Cursor, Claude Code, VS Code, Windsurf

[!TIP] ASO/스토어 작업을 자주 한다면 MCP 규칙에 "항상 pabal-mcp 사용" 같은 자동 호출 규칙을 추가하세요.

#전역 설치(권장)

npm install -g pabal-mcp
# 또는
yarn global add pabal-mcp

전역 설치를 먼저 권장합니다. 프록시/방화벽·오프라인 환경에서 npm 다운로드 문제를 피하고 더 빨리 시작할 수 있습니다. npx -y pabal-mcp도 가능하지만 전역 설치가 기본 권장 경로입니다. 전역 설치 후 MCP 설정에서는 command: "pabal-mcp"로 바로 사용할 수 있습니다(npx 불필요).

#Cursor

~/.cursor/mcp.json 또는 프로젝트 .cursor/mcp.json에 추가:

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

#VS Code

settings.json 예시:

"mcp": {
  "servers": {
    "pabal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

#Claude Code

[!TIP] 자세한 설정 옵션은 Claude Code MCP 공식 문서를 참고하세요.

Claude Code MCP 설정에 추가 (JSON 형식):

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

전역 설치(npm install -g pabal-mcp) 후에는:

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "pabal-mcp"
    }
  }
}

#Windsurf

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

#🔐 자격 증명 설정

1. 설정 디렉터리 생성 및 권한 설정:

mkdir -p ~/.config/pabal-mcp
chmod 700 ~/.config/pabal-mcp

2. 플레이스홀더가 채워진 설정 파일 생성:

cat <<'EOF' > ~/.config/pabal-mcp/config.json
{
  "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
  "appStore": {
    "issuerId": "xxxx",
    "keyId": "xxxx",
    "privateKeyPath": "./app-store-key.p8"
  },
  "googlePlay": {
    "serviceAccountKeyPath": "./google-play-service-account.json"
  }
}
EOF

다음 단계에서 App Store Connect 키를 확인한 뒤 issuerId, keyId 값을 실제 값으로 바꿔주세요. dataDir는 각 스토어에서 내려받은 raw 데이터를 저장하는 절대 경로입니다 (예: /ABSOLUTE/PATH/TO/pabal-web).

3. ~/.config/pabal-mcp/에 자격 증명 추가:

   App Store Connect API 키:

   • App Store Connect → Users and Access → Keys → "Generate API Key"에서 Admin/App Manager 권한으로 키 생성 후 .p8를 다운로드합니다(한 번만 가능). ~/.config/pabal-mcp/app-store-key.p8로 저장하세요.
   • 키 상세 화면에서 Issuer ID와 Key ID를 복사한 뒤 ~/.config/pabal-mcp/config.json의 issuerId, keyId에 반영하세요.

   Google Play 서비스 계정 JSON:

   • Google Cloud 서비스 계정 관리 → 새 서비스 계정 생성(이름은 pabal 권장) → 키 생성 → JSON 다운로드.
   • 다운로드한 JSON을 ~/.config/pabal-mcp/google-play-service-account.json으로 저장합니다.
   • Play Console → 사용자 및 권한 → 새 사용자 초대 → 서비스 계정 이메일 입력.
     • 앱 권한: ASO 작업할 앱들을 선택.
     • 계정 권한: 아래 항목을 체크:
       • 앱 정보 보기 및 보고서 일괄 다운로드(읽기 전용)
       • 앱 초안 생성·수정·삭제
       • 프로덕션으로 출시
       • 기기 제외 목록 관리
       • Play 앱 서명 사용
       • 스토어 노출(스토어 프레즌스) 관리

   설정 파일 형태 (ID 업데이트 후):

   {
     "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
     "appStore": {
       "issuerId": "<your-issuer-id>",
       "keyId": "<your-key-id>",
       "privateKeyPath": "./app-store-key.p8"
     },
     "googlePlay": {
       "serviceAccountKeyPath": "./google-play-service-account.json"
     }
   }
   

4. 스토어 데이터 가져오기

   apps-init을 사용해 스토어 API에서 앱을 가져와 자동 등록합니다. 이 명령은 ~/.config/pabal-mcp/registered-apps.json에 스토어에서 사용 가능한 앱들을 저장합니다.

5. 파일 권한 잠그기 (폴더 내 모든 파일):

chmod 600 ~/.config/pabal-mcp/*

~/.config/pabal-mcp/ 아래 모든 파일에 적용됩니다. 새 자격 증명 파일을 추가할 때마다 다시 실행하세요.

#🔧 MCP 도구

• 인증
  • auth-check: App Store Connect / Google Play 인증 상태 확인
• 앱 관리
  • apps-init: 스토어 API에서 앱을 가져와 자동 등록 (Google Play는 packageName 필요)
  • apps-add: bundleId/packageName으로 단일 앱 등록
  • apps-search: 등록된 앱 검색
• ASO 동기화
  • aso-pull: ASO 데이터를 로컬 캐시(.aso/)에 가져오기
  • aso-push: 로컬 캐시(.aso/)의 ASO 데이터를 스토어에 반영
• 릴리스 관리
  • release-check-versions: 앱별 최신 버전 조회
  • release-create: 새 버전 생성
  • release-pull-notes: 릴리스 노트를 로컬 캐시(.aso/)에 가져오기
  • release-update-notes: 릴리스 노트/What's New 업데이트

#🏗️ 개발

#소스에서 실행

git clone https://github.com/quartz-labs-dev/pabal-mcp.git
cd pabal-mcp
yarn install
yarn dev:mcp

#테스트

전체 테스트 실행: npm test

#🌐 Pabal Web

ASO와 SEO를 함께 관리하고 싶으신가요? Pabal Web을 확인해보세요.

Pabal Web은 Next.js 기반의 웹 인터페이스로, ASO, SEO, Google Search Console 인덱싱 등을 통합 관리할 수 있는 완전한 솔루션입니다.

👉 Pabal Web 방문하기