@yoonion/mimi-seed-mcp 0.3.31 → 0.3.33

package/README.md

@@ -1,11 +1,11 @@
-# @yoonion/mimi-seed-mcp
-
+# @yoonion/mimi-seed-mcp
+
 **Mimi Seed** — Firebase · AdMob · Google Play · App Store Connect를 AI 콘솔에서 관리. Claude Code / Codex / Cursor / 기타 MCP 클라이언트에서 한 줄 등록으로 사용.
-
-> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg/tool>.
-
-## 설치
-
+
+> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg/tool>.
+
+## 설치
+
 Claude Code:
 
 ```bash
@@ -20,216 +20,216 @@ command = "npx"
 args = ["-y", "@yoonion/mimi-seed-mcp"]
 enabled = true
 ```
-
-Claude Desktop (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "mimi-seed": {
-      "command": "npx",
-      "args": ["-y", "@yoonion/mimi-seed-mcp"]
-    }
-  }
-}
-```
-
-## 첫 사용 전 인증
-
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
-```
-
-브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
-
-플랫폼별 추가 인증 (필요한 것만):
-
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
-npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
-npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
-```
-
-- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
-- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
-- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
-
-AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
-
-```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-```
-
----
-
-## 제공 도구 (110+개)
-
-| 영역 | 도구 수 | 주요 도구 |
-|------|---------|-----------|
-| App Store Connect | 30 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
-| Google Play | 26 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
-| Firebase | 17 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
-| AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
-| CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
-| Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
-| Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
-| BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
-| 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
-| Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
-| AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
-| 인증 | 2 | `mimi_seed_auth_start` / `mimi_seed_auth_status` |
-
-> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
-
----
-
-## 슬래시 커맨드 (MCP Prompts)
-
+
+Claude Desktop (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mimi-seed": {
+      "command": "npx",
+      "args": ["-y", "@yoonion/mimi-seed-mcp"]
+    }
+  }
+}
+```
+
+## 첫 사용 전 인증
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+```
+
+브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
+
+플랫폼별 추가 인증 (필요한 것만):
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
+npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
+```
+
+- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
+- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
+- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
+
+AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+---
+
+## 제공 도구 (110+개)
+
+| 영역 | 도구 수 | 주요 도구 |
+|------|---------|-----------|
+| App Store Connect | 30 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
+| Google Play | 26 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| Firebase | 17 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
+| AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
+| CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
+| Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
+| Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
+| BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
+| 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
+| Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
+| AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
+| 인증 | 2 | `mimi_seed_auth_start` / `mimi_seed_auth_status` |
+
+> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
+
+---
+
+## 슬래시 커맨드 (MCP Prompts)
+
 MCP 클라이언트(Claude Code, Codex 등)에서 슬래시 커맨드로 바로 노출됩니다.
-
-| 커맨드 | 설명 |
-|--------|------|
-| `/mimi-seed:deploy` | 블로커 점검 → 릴리즈 노트 생성 → 스토어 적용을 한 번에 |
-| `/mimi-seed:health` | 인증 상태 + 앱 출시 준비도 빠른 요약 |
-| `/mimi-seed:review-inbox` | 미답변 리뷰 조회 → AI 답변 초안 생성 |
-
-## MCP Resources
-
-| URI | 설명 |
-|-----|------|
-| `mimi-seed://auth/status` | Google OAuth 토큰 상태 (JSON) |
-| `mimi-seed://agent/guide` | 에이전트 역할 정의 — 출시 워크플로우·주의사항 (Markdown) |
-
----
-
-## 주요 기능
-
-### 제출 위험 점검
-
-출시 전 블로커와 경고를 자동으로 점검합니다.
-
-```
-"내 앱 출시 전 위험 요소 확인해줘"
-→ playstore_check_submission_risks("com.example.myapp")
-→ appstore_check_submission_risks("1234567890")
-```
-
-**점검 항목:**
-- Google Play: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 내부 빌드 존재, 연락처
-- App Store: What's New, 설명/키워드, 스크린샷 커버리지, TestFlight 빌드, 개인정보처리방침 URL
-
----
-
-### 스크린샷 해상도 검증
-
-업로드 전 로컬 파일을 스토어 규격과 비교합니다.
-
-```
-"이 스크린샷들이 App Store 규격에 맞는지 확인해줘"
-→ screenshot_validate(["/path/to/screen1.png", "/path/to/screen2.png"], platform="ios", displayType="APP_IPHONE_69")
-```
-
-iOS displayType 예시: `APP_IPHONE_69`, `APP_IPHONE_67`, `APP_IPHONE_65`, `APP_IPAD_PRO_3GEN_129`  
-Android imageType 예시: `phoneScreenshots`, `sevenInchScreenshots`, `featureGraphic`
-
----
-
-### AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
-
-git 커밋 내역을 Claude가 사용자 친화적인 릴리즈 노트로 변환합니다.
-
-```
-"최근 커밋으로 릴리즈 노트 만들어줘"
-→ generate_release_notes_from_commits(
-     commits=[{message: "feat: 다크모드 추가"}, ...],
-     appName="MyApp",
-     locales=["ko", "en-US", "ja"]
-   )
-```
-
-3가지 톤(간결/상세/마케팅) + 다국어를 한 번에 생성. 이후 `playstore_update_release_notes` 또는 `appstore_update_whats_new`로 바로 적용.
-
----
-
-### AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
-
-스토어 리뷰에 대한 AI 답변 초안을 생성합니다.
-
-```
-"이 리뷰에 답변 작성해줘"
-→ generate_review_reply(
-     reviewText="앱이 자꾸 튕겨요",
-     rating=2,
-     appName="MyApp",
-     tone="empathetic",
-     language="ko"
-   )
-```
-
-tone 옵션: `friendly`(친근) / `professional`(정중) / `empathetic`(공감) / `brief`(간결)
-
-> ⚠ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.  
-> 답변 게시는 `playstore_reply_to_review` 도구를 사용하세요.
-
----
-
-## End-to-end: 서비스 계정 → JSON 키 → Play Console 권한
-
-서버(예: [onesub](https://github.com/jeonghwanko/onesub))가 Google Play 영수증을 백그라운드로 검증하려면 서비스 계정 JSON이 필요합니다. Claude에게 한 번에 시킬 수 있어요:
-
-> 1. `my-project`에 `onesub-play-verifier` 서비스 계정 만들고
-> 2. JSON 키 발급받아서
-> 3. `com.yourapp.id`에 대해 검증
-
-Claude가 연쇄 호출:
-
-- `iam_create_service_account("my-project", "onesub-play-verifier", "onesub Play verifier")`
-- `iam_create_key("onesub-play-verifier@my-project.iam.gserviceaccount.com")` → JSON 반환
-- `playstore_verify_service_account(<json>, "com.yourapp.id")` → 아직 Play Console 권한이 없어서 403 반환 기대
-
-그 다음 **Play Console에서 수동으로** (또는 별도 androidpublisher.users API 호출):
-
-- Users and permissions → 서비스 계정 이메일 초대
-- **View financial data, orders, and cancellation survey responses** 체크
-- **~5분 대기** 후 `playstore_verify_service_account` 재실행 → ✓
-
-마지막으로 JSON을 `GOOGLE_SERVICE_ACCOUNT_KEY` 서버 env에 넣으면 Play 영수증 검증 가능.
-
-> Cloud IAM 역할과 Play Console 권한은 다릅니다. `iam_add_iam_policy_binding`은 Cloud IAM 역할(예: `roles/iam.serviceAccountTokenCreator`)만 부여 — Play Console의 "View financial data"는 별도.
-
----
-
-## 환경변수
-
-| 변수 | 설명 |
-|------|------|
-| `ANTHROPIC_API_KEY` | AI 릴리즈 노트 생성 / 리뷰 답변 활성화 (선택) |
-
----
-
-## 레거시 호환성
-
-Preseed 시절(`~/.preseed/`) 데이터는 자동으로 이어받음:
-
-- `~/.preseed/tokens.json` 있으면 읽음 (재인증 불필요)
-- `~/.preseed/appstore.json`도 동일
-- 환경변수 `PRESEED_GOOGLE_CLIENT_ID` / `PRESEED_GOOGLE_CLIENT_SECRET` 계속 인식
-
-새로 쓰는 건 `~/.mimi-seed/`.
-
----
-
-## Links
-
-- CLI 패키지: [`mimi-seed`](https://www.npmjs.com/package/mimi-seed)
-- 웹 콘솔: <https://mimi-seed.pryzm.gg/tool>
-- 저장소: <https://github.com/jeonghwanko/mimi-seed>
-
----
-
-## License
-
-[PolyForm Noncommercial License 1.0.0](../../LICENSE) — 비상업적 사용만 허용.
-상업적 이용 문의: turbo08@gmail.com
-
-**Required Notice:** Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/mimi-seed:deploy` | 블로커 점검 → 릴리즈 노트 생성 → 스토어 적용을 한 번에 |
+| `/mimi-seed:health` | 인증 상태 + 앱 출시 준비도 빠른 요약 |
+| `/mimi-seed:review-inbox` | 미답변 리뷰 조회 → AI 답변 초안 생성 |
+
+## MCP Resources
+
+| URI | 설명 |
+|-----|------|
+| `mimi-seed://auth/status` | Google OAuth 토큰 상태 (JSON) |
+| `mimi-seed://agent/guide` | 에이전트 역할 정의 — 출시 워크플로우·주의사항 (Markdown) |
+
+---
+
+## 주요 기능
+
+### 제출 위험 점검
+
+출시 전 블로커와 경고를 자동으로 점검합니다.
+
+```
+"내 앱 출시 전 위험 요소 확인해줘"
+→ playstore_check_submission_risks("com.example.myapp")
+→ appstore_check_submission_risks("1234567890")
+```
+
+**점검 항목:**
+- Google Play: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 내부 빌드 존재, 연락처
+- App Store: What's New, 설명/키워드, 스크린샷 커버리지, TestFlight 빌드, 개인정보처리방침 URL
+
+---
+
+### 스크린샷 해상도 검증
+
+업로드 전 로컬 파일을 스토어 규격과 비교합니다.
+
+```
+"이 스크린샷들이 App Store 규격에 맞는지 확인해줘"
+→ screenshot_validate(["/path/to/screen1.png", "/path/to/screen2.png"], platform="ios", displayType="APP_IPHONE_69")
+```
+
+iOS displayType 예시: `APP_IPHONE_69`, `APP_IPHONE_67`, `APP_IPHONE_65`, `APP_IPAD_PRO_3GEN_129`  
+Android imageType 예시: `phoneScreenshots`, `sevenInchScreenshots`, `featureGraphic`
+
+---
+
+### AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
+
+git 커밋 내역을 Claude가 사용자 친화적인 릴리즈 노트로 변환합니다.
+
+```
+"최근 커밋으로 릴리즈 노트 만들어줘"
+→ generate_release_notes_from_commits(
+     commits=[{message: "feat: 다크모드 추가"}, ...],
+     appName="MyApp",
+     locales=["ko", "en-US", "ja"]
+   )
+```
+
+3가지 톤(간결/상세/마케팅) + 다국어를 한 번에 생성. 이후 `playstore_update_release_notes` 또는 `appstore_update_whats_new`로 바로 적용.
+
+---
+
+### AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
+
+스토어 리뷰에 대한 AI 답변 초안을 생성합니다.
+
+```
+"이 리뷰에 답변 작성해줘"
+→ generate_review_reply(
+     reviewText="앱이 자꾸 튕겨요",
+     rating=2,
+     appName="MyApp",
+     tone="empathetic",
+     language="ko"
+   )
+```
+
+tone 옵션: `friendly`(친근) / `professional`(정중) / `empathetic`(공감) / `brief`(간결)
+
+> ⚠ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.  
+> 답변 게시는 `playstore_reply_review` 도구를 사용하세요.
+
+---
+
+## End-to-end: 서비스 계정 → JSON 키 → Play Console 권한
+
+서버(예: [onesub](https://github.com/jeonghwanko/onesub))가 Google Play 영수증을 백그라운드로 검증하려면 서비스 계정 JSON이 필요합니다. Claude에게 한 번에 시킬 수 있어요:
+
+> 1. `my-project`에 `onesub-play-verifier` 서비스 계정 만들고
+> 2. JSON 키 발급받아서
+> 3. `com.yourapp.id`에 대해 검증
+
+Claude가 연쇄 호출:
+
+- `iam_create_service_account("my-project", "onesub-play-verifier", "onesub Play verifier")`
+- `iam_create_key("onesub-play-verifier@my-project.iam.gserviceaccount.com")` → JSON 반환
+- `playstore_verify_service_account(<json>, "com.yourapp.id")` → 아직 Play Console 권한이 없어서 403 반환 기대
+
+그 다음 **Play Console에서 수동으로** (또는 별도 androidpublisher.users API 호출):
+
+- Users and permissions → 서비스 계정 이메일 초대
+- **View financial data, orders, and cancellation survey responses** 체크
+- **~5분 대기** 후 `playstore_verify_service_account` 재실행 → ✓
+
+마지막으로 JSON을 `GOOGLE_SERVICE_ACCOUNT_KEY` 서버 env에 넣으면 Play 영수증 검증 가능.
+
+> Cloud IAM 역할과 Play Console 권한은 다릅니다. `iam_add_iam_policy_binding`은 Cloud IAM 역할(예: `roles/iam.serviceAccountTokenCreator`)만 부여 — Play Console의 "View financial data"는 별도.
+
+---
+
+## 환경변수
+
+| 변수 | 설명 |
+|------|------|
+| `ANTHROPIC_API_KEY` | AI 릴리즈 노트 생성 / 리뷰 답변 활성화 (선택) |
+
+---
+
+## 레거시 호환성
+
+Preseed 시절(`~/.preseed/`) 데이터는 자동으로 이어받음:
+
+- `~/.preseed/tokens.json` 있으면 읽음 (재인증 불필요)
+- `~/.preseed/appstore.json`도 동일
+- 환경변수 `PRESEED_GOOGLE_CLIENT_ID` / `PRESEED_GOOGLE_CLIENT_SECRET` 계속 인식
+
+새로 쓰는 건 `~/.mimi-seed/`.
+
+---
+
+## Links
+
+- CLI 패키지: [`mimi-seed`](https://www.npmjs.com/package/mimi-seed)
+- 웹 콘솔: <https://mimi-seed.pryzm.gg/tool>
+- 저장소: <https://github.com/jeonghwanko/mimi-seed>
+
+---
+
+## License
+
+[PolyForm Noncommercial License 1.0.0](../../LICENSE) — 비상업적 사용만 허용.
+상업적 이용 문의: turbo08@gmail.com
+
+**Required Notice:** Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)

package/dist/ai/review.js

@@ -55,6 +55,6 @@ export function formatReviewReply(result) {
         '',
         `⚠ ${result.note}`,
         '',
-        '이 답변이 마음에 들면 playstore_reply_to_review 도구로 게시하세요.',
+        '이 답변이 마음에 들면 playstore_reply_review 도구로 게시하세요.',
     ].join('\n');
 }

package/dist/appstore/errors.js

@@ -27,6 +27,8 @@ const CODE_HINTS = {
     FORBIDDEN_ERROR: 'API Key 권한 부족 — App Store Connect > Users and Access 에서 키 role 확인.',
     // submit 직후 cancel 시도 (큐 진입 후)
     STATE_ERROR: '현재 상태에서 허용되지 않는 작업. cancel_review 라면 큐 진입 후라서 불가 — 새 versionString 으로 우회.',
+    // JWT 거부 — 잘못된 자격증명
+    NOT_AUTHORIZED: 'API 키가 거부됐어요 — issuerId/keyId/.p8 조합 불일치 가능. appstore_verify_credentials 로 진단하고 mimi-seed auth appstore 로 재등록.',
 };
 /** Apple 표준 에러 응답 파싱 시도. 실패하면 null 반환. */
 function parseAppleErrorBody(body) {

package/dist/appstore/tools.d.ts

@@ -1,4 +1,22 @@
 export declare function apiGet(path: string, params?: Record<string, string>): Promise<any>;
+export interface AppStoreVerifyResult {
+    ok: boolean;
+    stage: 'creds' | 'sign' | 'auth' | 'api' | 'done';
+    message: string;
+    httpStatus?: number;
+    appCount?: number;
+    firstApp?: {
+        id: string;
+        name?: string;
+    };
+}
+/**
+ * appstore.json 자격증명 유효성 단계별 검증 (creds → sign → auth → api).
+ * playstore_verify_service_account 의 App Store 대응. 읽기 전용 — GET /apps?limit=1.
+ * 파일 존재만 보는 requireAppStoreCreds 와 달리, 잘못된 .p8/keyId/issuerId 를
+ * "첫 호출 401" 로 늦게 터지기 전에 setup 단계에서 잡아준다.
+ */
+export declare function verifyAppStoreCredentials(): Promise<AppStoreVerifyResult>;
 export declare function listApps(): Promise<any>;
 export declare function getApp(appId: string): Promise<any>;
 export declare function listVersions(appId: string): Promise<any>;

package/dist/appstore/tools.js

@@ -1,4 +1,4 @@
-import { getAuthHeaders } from './auth.js';
+import { getAuthHeaders, getAppStoreCredentials, generateToken } from './auth.js';
 import { friendlyAppStoreError } from './errors.js';
 /**
  * App Store Connect API v1 래퍼
@@ -29,6 +29,61 @@ export async function apiGet(path, params) {
     }
     return res.json();
 }
+/**
+ * appstore.json 자격증명 유효성 단계별 검증 (creds → sign → auth → api).
+ * playstore_verify_service_account 의 App Store 대응. 읽기 전용 — GET /apps?limit=1.
+ * 파일 존재만 보는 requireAppStoreCreds 와 달리, 잘못된 .p8/keyId/issuerId 를
+ * "첫 호출 401" 로 늦게 터지기 전에 setup 단계에서 잡아준다.
+ */
+export async function verifyAppStoreCredentials() {
+    const creds = getAppStoreCredentials();
+    if (!creds) {
+        return {
+            ok: false,
+            stage: 'creds',
+            message: '~/.mimi-seed/appstore.json 이 없습니다. `mimi-seed auth appstore` 로 등록하세요.',
+        };
+    }
+    let token;
+    try {
+        token = await generateToken(creds);
+    }
+    catch (e) {
+        return {
+            ok: false,
+            stage: 'sign',
+            message: `JWT 서명 실패 — .p8 privateKey / keyId 확인 필요.\n${e.message}`,
+        };
+    }
+    let res;
+    try {
+        res = await fetch(`${BASE}/apps?limit=1`, { headers: { Authorization: `Bearer ${token}` } });
+    }
+    catch (e) {
+        return { ok: false, stage: 'api', message: `App Store API 연결 실패: ${e.message}` };
+    }
+    if (res.status === 401 || res.status === 403) {
+        return {
+            ok: false,
+            stage: 'auth',
+            httpStatus: res.status,
+            message: 'Apple이 인증을 거부했어요 — issuerId / keyId / .p8 조합이 틀렸거나 키 권한이 부족합니다.\n`mimi-seed auth appstore` 로 재등록하세요.',
+        };
+    }
+    if (!res.ok) {
+        const body = await res.text();
+        return { ok: false, stage: 'api', httpStatus: res.status, message: `App Store API ${res.status}: ${body.slice(0, 200)}` };
+    }
+    const data = (await res.json());
+    const first = data.data?.[0];
+    return {
+        ok: true,
+        stage: 'done',
+        message: '인증 유효',
+        appCount: data.meta?.paging?.total,
+        firstApp: first ? { id: first.id, name: first.attributes?.name } : undefined,
+    };
+}
 async function apiPatch(path, body) {
     const headers = await getAuthHeaders();
     if (!headers)

package/dist/prompts.js

@@ -61,7 +61,7 @@ export function registerPrompts(server) {
                         '3. 각 리뷰에 generate_review_reply 로 답변 초안 생성',
                         `   톤: ${tone ?? 'empathetic'}`,
                         '4. 초안 보여주고 게시 여부 확인 (비가역 — 반드시 동의 받을 것)',
-                        '5. 확인 후 playstore_reply_to_review 로 게시',
+                        '5. 확인 후 playstore_reply_review 로 게시',
                         '',
                         '⚠️ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.',
                     ].join('\n'),

package/dist/registers/ai.js

@@ -32,7 +32,7 @@ export function registerAiTools(server) {
         'tone: friendly(친근) / professional(정중) / empathetic(공감) / brief(간결) — 기본: friendly',
         'language: ko / en / ja / zh 등 — 기본: ko',
         '⚠ 생성된 답변은 초안입니다. 게시 전 반드시 검토하세요.',
-        '답변 게시는 playstore_reply_to_review 도구를 사용하세요.',
+        '답변 게시는 playstore_reply_review 도구를 사용하세요.',
     ].join(' '), {
         reviewText: z.string().describe('리뷰 원문'),
         rating: z.number().min(1).max(5).optional().describe('별점 (1~5)'),

package/dist/registers/appstore.js

@@ -10,6 +10,31 @@ export function registerAppstoreTools(server) {
         const apps = await appstore.listApps();
         return { content: [{ type: 'text', text: JSON.stringify(apps, null, 2) }] };
     });
+    server.tool('appstore_verify_credentials', 'App Store Connect API 키(appstore.json) 유효성 검증 — JWT 서명 + GET /apps 호출로 creds/sign/auth/api 단계별 진단. 첫 도구 호출에서 401로 늦게 터지기 전에 setup 직후 확인용. 인자 없음.', {}, async () => {
+        const r = await appstore.verifyAppStoreCredentials();
+        if (r.ok) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            '✓ App Store Connect 인증 유효',
+                            r.appCount != null ? `   접근 가능 앱: ${r.appCount}개` : '',
+                            r.firstApp ? `   예: ${r.firstApp.name ?? r.firstApp.id}` : '',
+                        ].filter(Boolean).join('\n'),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✗ 검증 실패 (stage: ${r.stage}${r.httpStatus ? `, HTTP ${r.httpStatus}` : ''})`,
+                        '',
+                        r.message,
+                    ].join('\n'),
+                }],
+        };
+    });
     server.tool('appstore_get_app', 'App Store Connect 앱 상세 정보', { appId: z.string().describe('앱 ID (숫자)') }, async ({ appId }) => {
         const app = await appstore.getApp(appId);
         return { content: [{ type: 'text', text: JSON.stringify(app, null, 2) }] };

package/dist/resources.js

@@ -44,7 +44,7 @@ export function registerResources(server) {
                     '',
                     '- `playstore_submit_release(status=completed)` — 비가역, 반드시 명시 동의 필요',
                     '- `appstore_submit_for_review` — 비가역, 반드시 명시 동의 필요',
-                    '- `playstore_reply_to_review` — 공개 게시, 반드시 검토 후 동의 필요',
+                    '- `playstore_reply_review` — 공개 게시, 반드시 검토 후 동의 필요',
                 ].join('\n'),
             }],
     }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.31",
+  "version": "0.3.33",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {