@yoonion/mimi-seed-mcp 0.3.39 → 0.4.0

package/dist/helpers.js

@@ -1,4 +1,4 @@
-import { getAuthenticatedClient, ensureFreshAccessToken } from './auth/google-auth.js';
+import { getAuthenticatedClient, ensureFreshAccessToken, getStoredTokens } from './auth/google-auth.js';
 import { getServiceAccountClient, getServiceAccountJson } from './auth/playstore-auth.js';
 import { getAppStoreCredentials } from './appstore/auth.js';
 export { ensureFreshAccessToken };
@@ -22,7 +22,7 @@ function formatAuthError(p) {
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export async function requireAuth() {
+export async function requireAuth(requiredScope) {
     const result = await ensureFreshAccessToken();
     if (result.status === 'unauthenticated' || result.status === 'expired_refresh_failed') {
         throw new Error(formatAuthError(result.error));
@@ -37,6 +37,22 @@ export async function requireAuth() {
             needsReauth: true,
         }));
     }
+    // 신규 스코프(GA4 analytics.edit 등)는 변경 전 발급된 토큰엔 없다. expiry 만 보는
+    // ensureFreshAccessToken 은 이를 못 걸러내므로(런타임 ACCESS_TOKEN_SCOPE_INSUFFICIENT),
+    // 저장된 scope 로 pre-flight 검사해 결정적인 재로그인 안내를 던진다.
+    // (scope 가 undefined 인 구 토큰은 미보유로 간주 → 재로그인 유도.)
+    if (requiredScope) {
+        const granted = (getStoredTokens()?.scope ?? '').split(' ').filter(Boolean);
+        if (!granted.includes(requiredScope)) {
+            throw new Error(formatAuthError({
+                code: 'INSUFFICIENT_SCOPE',
+                message: `이 도구는 추가 권한이 필요해 (${requiredScope}). 기존 로그인에 없어서 1회 재로그인이 필요해.`,
+                hint: 'mimi-seed-auth 로 재로그인하면 새 권한이 부여돼.',
+                retriable: false,
+                needsReauth: true,
+            }));
+        }
+    }
     return client;
 }
 export const PLAY_AUTH_HINT = [

package/dist/index.js

@@ -16,6 +16,7 @@ import { registerInstagramTools } from './registers/instagram.js';
 import { registerFacebookTools } from './registers/facebook.js';
 import { registerGoogleAdsTools } from './registers/googleads.js';
 import { registerGscTools } from './registers/gsc.js';
+import { registerGa4Tools } from './registers/ga4.js';
 import { registerJenkinsTools } from './registers/jenkins.js';
 import { registerAndroidTools } from './registers/android.js';
 import { registerPrompts } from './prompts.js';
@@ -41,6 +42,7 @@ registerInstagramTools(server);
 registerFacebookTools(server);
 registerGoogleAdsTools(server);
 registerGscTools(server);
+registerGa4Tools(server);
 registerJenkinsTools(server);
 registerAndroidTools(server);
 registerPrompts(server);
@@ -54,6 +56,9 @@ const SUBCOMMANDS = {
     'mimi-seed-playstore-auth': () => import('./auth/playstore-setup-cli.js'),
     'mimi-seed-appstore-auth': () => import('./appstore/setup-cli.js'),
     'mimi-seed-bigquery-auth': () => import('./auth/bigquery-setup-cli.js'),
+    'mimi-seed-firebase': () => import('./firebase/cli.js'),
+    'mimi-seed-admob': () => import('./admob/cli.js'),
+    'mimi-seed-ga4': () => import('./ga4/cli.js'),
 };
 async function main() {
     const sub = process.argv[2];

package/dist/jenkins/credentials.d.ts

@@ -6,5 +6,9 @@ export interface JenkinsCredentialSummary {
 }
 export declare function listCredentials(cfg: JenkinsConfig): Promise<JenkinsCredentialSummary[]>;
 export declare function upsertSecretText(cfg: JenkinsConfig, id: string, secret: string, description?: string): Promise<'created' | 'updated'>;
+/**
+ * Secret File credential 생성/교체. Jenkins는 파일을 multipart 로 받고
+ * json 본문이 "file": "<필드명>" 으로 참조한다 (secretBytes JSON 직접 입력은 불가).
+ */
 export declare function upsertSecretFile(cfg: JenkinsConfig, id: string, fileBase64: string, fileName: string, description?: string): Promise<'created' | 'updated'>;
 export declare function deleteCredential(cfg: JenkinsConfig, id: string): Promise<void>;

package/dist/jenkins/credentials.js

@@ -1,17 +1,45 @@
+const FILE_CLASS = 'org.jenkinsci.plugins.plaincredentials.impl.FileCredentialsImpl';
+const TEXT_CLASS = 'org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl';
 function basicAuth(username, token) {
     return 'Basic ' + Buffer.from(`${username}:${token}`).toString('base64');
 }
-function credentialsBase(url) {
+// 도메인(_ = 전역) 레벨 — 목록 조회 / createCredentials 의 베이스
+function storeBase(url) {
     return `${url.replace(/\/$/, '')}/credentials/store/system/domain/_`;
 }
+// 개별 credential 레벨 — 반드시 /credential/<id> 세그먼트 필요 (조회/업데이트/삭제)
+function credentialBase(url, id) {
+    return `${storeBase(url)}/credential/${encodeURIComponent(id)}`;
+}
+/**
+ * CSRF crumb (best-effort). crumb issuer 비활성이거나 API 토큰으로 면제되면 빈 객체.
+ * 구버전 Jenkins / 비밀번호 인증 환경에서 POST 403 방지.
+ */
+async function getCrumb(cfg) {
+    try {
+        const res = await fetch(`${cfg.url.replace(/\/$/, '')}/crumbIssuer/api/json`, {
+            headers: { Authorization: basicAuth(cfg.username, cfg.token) },
+        });
+        if (!res.ok)
+            return {};
+        const data = (await res.json());
+        if (data.crumbRequestField && data.crumb) {
+            return { [data.crumbRequestField]: data.crumb };
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
 async function credentialExists(cfg, id) {
-    const res = await fetch(`${credentialsBase(cfg.url)}/${encodeURIComponent(id)}/api/json`, {
+    const res = await fetch(`${credentialBase(cfg.url, id)}/api/json`, {
         headers: { Authorization: basicAuth(cfg.username, cfg.token) },
     });
     return res.ok;
 }
 export async function listCredentials(cfg) {
-    const res = await fetch(`${credentialsBase(cfg.url)}/api/json?depth=1`, {
+    const res = await fetch(`${storeBase(cfg.url)}/api/json?depth=1`, {
         headers: { Authorization: basicAuth(cfg.username, cfg.token) },
     });
     if (!res.ok)
@@ -24,60 +52,67 @@ export async function listCredentials(cfg) {
     }));
 }
 export async function upsertSecretText(cfg, id, secret, description = '') {
-    const payload = JSON.stringify({
-        '': '0',
+    const exists = await credentialExists(cfg, id);
+    const payload = {
         credentials: {
             scope: 'GLOBAL',
             id,
             description,
             secret,
-            'stapler-class': 'org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl',
-            '$class': 'org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl',
+            $class: TEXT_CLASS,
+            'stapler-class': TEXT_CLASS,
         },
-    });
-    const base = credentialsBase(cfg.url);
-    const exists = await credentialExists(cfg, id);
+    };
     const endpoint = exists
-        ? `${base}/${encodeURIComponent(id)}/updateSubmit`
-        : `${base}/createCredentials`;
+        ? `${credentialBase(cfg.url, id)}/updateSubmit`
+        : `${storeBase(cfg.url)}/createCredentials`;
+    const crumb = await getCrumb(cfg);
     const res = await fetch(endpoint, {
         method: 'POST',
         headers: {
             Authorization: basicAuth(cfg.username, cfg.token),
             'Content-Type': 'application/x-www-form-urlencoded',
+            ...crumb,
         },
-        body: new URLSearchParams({ json: payload }).toString(),
+        body: new URLSearchParams({ json: JSON.stringify(payload) }).toString(),
     });
     if (!res.ok && res.status !== 302) {
         throw new Error(`Jenkins credential ${exists ? 'update' : 'create'} 실패 (${res.status})`);
     }
     return exists ? 'updated' : 'created';
 }
+/**
+ * Secret File credential 생성/교체. Jenkins는 파일을 multipart 로 받고
+ * json 본문이 "file": "<필드명>" 으로 참조한다 (secretBytes JSON 직접 입력은 불가).
+ */
 export async function upsertSecretFile(cfg, id, fileBase64, fileName, description = '') {
-    const payload = JSON.stringify({
-        '': '0',
+    const exists = await credentialExists(cfg, id);
+    const payload = {
         credentials: {
             scope: 'GLOBAL',
             id,
             description,
-            fileName,
-            secretBytes: fileBase64,
-            'stapler-class': 'org.jenkinsci.plugins.plaincredentials.impl.FileCredentialsImpl',
-            '$class': 'org.jenkinsci.plugins.plaincredentials.impl.FileCredentialsImpl',
+            file: 'file0',
+            $class: FILE_CLASS,
+            'stapler-class': FILE_CLASS,
         },
-    });
-    const base = credentialsBase(cfg.url);
-    const exists = await credentialExists(cfg, id);
+    };
+    const form = new FormData();
+    form.append('json', JSON.stringify(payload));
+    const bytes = Buffer.from(fileBase64, 'base64');
+    form.append('file0', new Blob([bytes]), fileName);
     const endpoint = exists
-        ? `${base}/${encodeURIComponent(id)}/updateSubmit`
-        : `${base}/createCredentials`;
+        ? `${credentialBase(cfg.url, id)}/updateSubmit`
+        : `${storeBase(cfg.url)}/createCredentials`;
+    const crumb = await getCrumb(cfg);
+    // Content-Type 은 fetch 가 multipart boundary 와 함께 자동 설정 — 수동 지정 금지
     const res = await fetch(endpoint, {
         method: 'POST',
         headers: {
             Authorization: basicAuth(cfg.username, cfg.token),
-            'Content-Type': 'application/x-www-form-urlencoded',
+            ...crumb,
         },
-        body: new URLSearchParams({ json: payload }).toString(),
+        body: form,
     });
     if (!res.ok && res.status !== 302) {
         throw new Error(`Jenkins secret file credential ${exists ? 'update' : 'create'} 실패 (${res.status})`);
@@ -85,9 +120,13 @@ export async function upsertSecretFile(cfg, id, fileBase64, fileName, descriptio
     return exists ? 'updated' : 'created';
 }
 export async function deleteCredential(cfg, id) {
-    const res = await fetch(`${credentialsBase(cfg.url)}/${encodeURIComponent(id)}/doDelete`, {
+    const crumb = await getCrumb(cfg);
+    const res = await fetch(`${credentialBase(cfg.url, id)}/doDelete`, {
         method: 'POST',
-        headers: { Authorization: basicAuth(cfg.username, cfg.token) },
+        headers: {
+            Authorization: basicAuth(cfg.username, cfg.token),
+            ...crumb,
+        },
     });
     if (!res.ok && res.status !== 302) {
         throw new Error(`Jenkins credential 삭제 실패 (${res.status})`);

package/dist/lib/cli-args.d.ts

@@ -0,0 +1,31 @@
+export interface ParsedArgs {
+    /** 첫 위치 인자 — 서브커맨드 (예: 'create-property') */
+    command: string | undefined;
+    /** --name value 형태의 값 플래그 */
+    flags: Record<string, string>;
+    /** --force 형태의 불리언 플래그 */
+    bools: Set<string>;
+}
+/** process.argv.slice(2) 같은 토큰 배열을 파싱. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** 값 플래그 조회 — 없으면 fallback. */
+export declare function flag(p: ParsedArgs, name: string, fallback?: string): string | undefined;
+/** 필수 값 플래그 — 없으면 친절 에러 throw. */
+export declare function requireFlag(p: ParsedArgs, name: string): string;
+/** 쉼표 구분 값 → 배열 ('a, b ,c' → ['a','b','c']). 없으면 undefined. */
+export declare function flagList(p: ParsedArgs, name: string): string[] | undefined;
+/** 사용법 위반 — main()에서 잡아 도움말과 함께 exit 1. */
+export declare class CliUsageError extends Error {
+}
+/** 결과 JSON 을 stdout 으로 출력 (stderr 는 진행/안내용). */
+export declare function printJson(data: unknown): void;
+/**
+ * 도메인 sub-CLI 공통 러너. requireAuth → 핸들러 매핑 실행 → JSON 출력 → exit code.
+ * 핸들러는 ParsedArgs 를 받아 출력할 데이터를 반환한다.
+ */
+export declare function runDomainCli(opts: {
+    binName: string;
+    argv: string[];
+    help: string;
+    handlers: Record<string, (p: ParsedArgs) => Promise<unknown>>;
+}): Promise<void>;

package/dist/lib/cli-args.js

@@ -0,0 +1,96 @@
+// 도메인별 sub-CLI(mimi-seed-firebase / -admob / -ga4)가 공유하는 최소 argv 파서.
+// `mimi-seed <domain> <subcommand> [--flag value] [--bool]` 형태를 파싱한다.
+// 실제 사용자 진입점은 cli 패키지의 `mimi-seed <domain> ...` 이고, 그게 npx 로
+// 이 bin 들을 stdio 그대로 호출한다(auth.ts:runMcpBin 패턴과 동일).
+/** process.argv.slice(2) 같은 토큰 배열을 파싱. */
+export function parseArgs(argv) {
+    const flags = {};
+    const bools = new Set();
+    let command;
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok.startsWith('--')) {
+            const eq = tok.indexOf('=');
+            if (eq !== -1) {
+                // --key=value — 값이 '--'로 시작해도 안전하게 전달.
+                flags[tok.slice(2, eq)] = tok.slice(eq + 1);
+                continue;
+            }
+            const key = tok.slice(2);
+            const next = argv[i + 1];
+            // 다음 토큰이 또 다른 플래그(--)면 값으로 소비하지 않는다 → 값 누락을 bool 로 기록.
+            if (next !== undefined && !next.startsWith('--')) {
+                flags[key] = next;
+                i++;
+            }
+            else {
+                bools.add(key);
+            }
+        }
+        else if (command === undefined) {
+            command = tok;
+        }
+    }
+    return { command, flags, bools };
+}
+/** 값 플래그 조회 — 없으면 fallback. */
+export function flag(p, name, fallback) {
+    return p.flags[name] ?? fallback;
+}
+/** 필수 값 플래그 — 없으면 친절 에러 throw. */
+export function requireFlag(p, name) {
+    const v = p.flags[name];
+    if (v === undefined || v === '') {
+        if (p.bools.has(name)) {
+            throw new CliUsageError(`--${name} 에 값이 필요합니다 (값 없이 단독으로 쓰였습니다). 값이 '--'로 시작하면 --${name}=값 형태로 쓰세요.`);
+        }
+        throw new CliUsageError(`--${name} 가 필요합니다.`);
+    }
+    return v;
+}
+/** 쉼표 구분 값 → 배열 ('a, b ,c' → ['a','b','c']). 없으면 undefined. */
+export function flagList(p, name) {
+    const v = p.flags[name];
+    if (!v)
+        return undefined;
+    return v.split(',').map((s) => s.trim()).filter(Boolean);
+}
+/** 사용법 위반 — main()에서 잡아 도움말과 함께 exit 1. */
+export class CliUsageError extends Error {
+}
+/** 결과 JSON 을 stdout 으로 출력 (stderr 는 진행/안내용). */
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+/**
+ * 도메인 sub-CLI 공통 러너. requireAuth → 핸들러 매핑 실행 → JSON 출력 → exit code.
+ * 핸들러는 ParsedArgs 를 받아 출력할 데이터를 반환한다.
+ */
+export async function runDomainCli(opts) {
+    const p = parseArgs(opts.argv);
+    if (!p.command || p.command === 'help' || p.bools.has('help') || p.bools.has('h')) {
+        process.stderr.write(opts.help + '\n');
+        process.exit(p.command ? 0 : 1);
+    }
+    const handler = opts.handlers[p.command];
+    if (!handler) {
+        process.stderr.write(`❌ 알 수 없는 서브커맨드: ${p.command}\n\n` + opts.help + '\n');
+        process.exit(1);
+    }
+    try {
+        const result = await handler(p);
+        printJson(result);
+        process.exit(0);
+    }
+    catch (e) {
+        if (e instanceof CliUsageError) {
+            process.stderr.write(`❌ ${e.message}\n\n` + opts.help + '\n');
+        }
+        else {
+            process.stderr.write(`❌ ${e instanceof Error ? e.message : String(e)}\n`);
+            if (process.env.DEBUG && e instanceof Error)
+                process.stderr.write((e.stack ?? '') + '\n');
+        }
+        process.exit(1);
+    }
+}

package/dist/lib/google-errors.d.ts

@@ -1,5 +1,13 @@
 export declare function extractHttpStatus(e: unknown): number | undefined;
 export declare function rawMessage(e: unknown): string;
+/**
+ * Google API 에러에서 구조화된 실제 사유를 추출한다. GaxiosError는
+ * `response.data.error.{message,errors[].reason}` 에 진짜 원인을 담는데,
+ * 친절화 레이어가 이를 버리고 일반 메시지("권한 없음")로 덮으면, 권한이 멀쩡한데도
+ * 권한 문제로 오진하게 된다 (예: 같은 SA로 이미지 업로드는 되는데 listings.update만 403).
+ * 추출 실패 시 undefined.
+ */
+export declare function googleErrorDetail(e: unknown): string | undefined;
 /** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
 export declare function authReauthMessage(text: string): string | null;
 export declare function withCause(err: Error, cause: unknown): Error;

package/dist/lib/google-errors.js

@@ -26,6 +26,32 @@ export function rawMessage(e) {
         return String(e);
     }
 }
+/**
+ * Google API 에러에서 구조화된 실제 사유를 추출한다. GaxiosError는
+ * `response.data.error.{message,errors[].reason}` 에 진짜 원인을 담는데,
+ * 친절화 레이어가 이를 버리고 일반 메시지("권한 없음")로 덮으면, 권한이 멀쩡한데도
+ * 권한 문제로 오진하게 된다 (예: 같은 SA로 이미지 업로드는 되는데 listings.update만 403).
+ * 추출 실패 시 undefined.
+ */
+export function googleErrorDetail(e) {
+    if (!e || typeof e !== 'object')
+        return undefined;
+    const any = e;
+    const apiErr = any.response?.data?.error;
+    const parts = [];
+    if (apiErr?.message)
+        parts.push(String(apiErr.message));
+    const reasons = apiErr?.errors ?? any.errors;
+    if (Array.isArray(reasons)) {
+        for (const r of reasons) {
+            const bit = [r?.reason, r?.message].filter(Boolean).join(': ');
+            if (bit && !parts.some((p) => p.includes(bit)))
+                parts.push(bit);
+        }
+    }
+    const joined = parts.join(' | ').trim();
+    return joined.length ? joined : undefined;
+}
 /** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
 export function authReauthMessage(text) {
     if (/invalid_grant|invalid_rapt|rapt_required|unauthorized_client|ACCESS_TOKEN_SCOPE_INSUFFICIENT|insufficient.*scope/i.test(text)) {

package/dist/playstore/errors.js

@@ -2,17 +2,23 @@
 // App Store 의 friendlyAppStoreError 와 대칭 — Play 쪽엔 없던 친절화 레이어.
 // 신규 사용자가 가장 자주 막히는 두 케이스(서비스 계정 권한 403, edit 세션 충돌)에
 // 구체적 복구 단계를 붙인다. 인식 못 한 에러(도메인 에러 포함)는 원본 보존.
-import { extractHttpStatus, authReauthMessage, withCause } from '../lib/google-errors.js';
-// playstore_verify_service_account 의 403 안내와 동일한 체크리스트.
-const PERMISSION_403 = [
-    '❌ Google Play 권한 부족 (403).',
-    '원인: 인증은 됐지만 Play Console에서 이 계정/서비스 계정에 권한이 없어요.',
-    '',
-    '1. Play Console → 사용자 및 권한(Users and permissions)',
-    '2. 이 Google 계정(또는 서비스 계정 이메일)을 초대 / 권한 부여',
-    '3. 앱 권한에 "앱 정보 관리" (재무 데이터 필요 시 "재무 데이터 보기") 부여',
-    '4. 권한 적용까지 ~5분 대기 후 재시도 (너무 빨리 시도하면 계속 403)',
-].join('\n');
+import { extractHttpStatus, authReauthMessage, withCause, googleErrorDetail } from '../lib/google-errors.js';
+// 403 안내. raw Google 사유를 먼저 보여주고, 권한이 멀쩡한데 특정 작업만 거부되는
+// 케이스(같은 SA로 이미지 업로드는 되는데 listings.update만 403 등)를 위해
+// "다른 쓰기가 되면 권한 문제가 아니다"라는 단서를 붙인다. detail 은 googleErrorDetail() 결과.
+function permission403Message(detail) {
+    return [
+        '❌ Google Play 403 — 요청이 거부됐어요.',
+        detail ? `Google 사유: ${detail}` : '',
+        '⚠️ 같은 계정/서비스 계정으로 다른 쓰기(예: 이미지 업로드)가 된다면 권한 문제가 아닐 수 있어요 — 위 Google 사유 또는 앱 상태·정책·작업별 제한을 먼저 확인하세요.',
+        '',
+        '정말 권한 문제라면:',
+        '1. Play Console → 사용자 및 권한(Users and permissions)',
+        '2. 이 Google 계정(또는 서비스 계정 이메일)을 초대 / 권한 부여',
+        '3. 앱 권한에 "앱 정보 관리"(Manage store presence) 부여',
+        '4. 권한 적용까지 ~5분 대기 후 재시도',
+    ].filter((l) => l !== '').join('\n');
+}
 export function friendlyPlayError(e, packageName) {
     const text = e instanceof Error ? e.message : String(e);
     const status = extractHttpStatus(e);
@@ -20,7 +26,7 @@ export function friendlyPlayError(e, packageName) {
     if (reauth)
         return withCause(new Error(reauth), e);
     if (status === 403 || /PERMISSION_DENIED|insufficient permission|forbidden/i.test(text)) {
-        return withCause(new Error(PERMISSION_403), e);
+        return withCause(new Error(permission403Message(googleErrorDetail(e))), e);
     }
     if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
         return withCause(new Error(`❌ 패키지${packageName ? ` (${packageName})` : ''}를 이 개발자 계정에서 찾을 수 없어요.\n→ packageName 철자와 계정 권한을 확인하세요.`), e);

package/dist/registers/admob.js

@@ -35,14 +35,15 @@ export function registerAdmobTools(server) {
         const report = await admob.getNetworkReport(auth, accountId, { year: startYear, month: startMonth, day: startDay }, { year: endYear, month: endMonth, day: endDay });
         return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
     });
-    server.tool('admob_create_app', 'AdMob에 새 앱 등록 (v1beta — Limited Access)', {
+    server.tool('admob_create_app', 'AdMob에 새 앱 등록 (v1beta — Limited Access). appStoreId 를 주면 스토어 게시 앱과 링크(Android=패키지명, iOS=App Store 숫자 ID), 없으면 manual(unlinked) 앱.', {
         accountId: z.string().describe('AdMob 계정 ID'),
         platform: z.enum(['ANDROID', 'IOS']).describe('플랫폼'),
         displayName: z.string().describe('앱 이름'),
-    }, async ({ accountId, platform, displayName }) => {
+        appStoreId: z.string().optional().describe('스토어 링크용 ID — Android는 패키지명(com.x.y), iOS는 App Store 숫자 ID'),
+    }, async ({ accountId, platform, displayName, appStoreId }) => {
         const auth = await requireAuth();
         try {
-            const result = await admob.createApp(auth, accountId, platform, displayName);
+            const result = await admob.createApp(auth, accountId, platform, displayName, appStoreId);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
         catch (err) {

package/dist/registers/android.js

@@ -152,6 +152,10 @@ export function registerAndroidTools(server) {
                     text: [
                         '✅ Android upload keystore 생성 완료',
                         '',
+                        '🔒 아래 비밀번호는 채팅 기록에 평문으로 남습니다.',
+                        '   Jenkins 등록을 마친 뒤에는 이 대화/세션을 삭제하는 것을 권장합니다.',
+                        '   keystore 파일과 비밀번호는 분실 시 앱 서명을 영구히 잃으니 별도 안전한 곳에도 백업하세요.',
+                        '',
                         '── 생성된 값 (지금 바로 Jenkins에 등록하세요) ────',
                         `keyAlias:      ${ks.keyAlias}`,
                         `storePassword: ${ks.storePassword}`,

package/dist/registers/firebase.js

@@ -144,4 +144,18 @@ export function registerFirebaseTools(server) {
         const services = await firebase.listEnabledServices(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(services, null, 2) }] };
     });
+    server.tool('firebase_link_analytics', 'Firebase 프로젝트에 Google Analytics(GA4) 링크 → 앱별 measurement 자동 활성화. analyticsAccountId(그 계정에 GA4 property 신규 생성) 또는 analyticsPropertyId(기존 property 링크) 중 하나 필수. 먼저 firebase_enable_common_services 로 firebaseanalytics 활성화 권장. property 이름/web stream 까지 직접 제어하려면 ga4_create_property/ga4_create_data_stream 사용.', {
+        projectId: z.string().describe('Firebase 프로젝트 ID'),
+        analyticsAccountId: z.string().optional().describe('GA 계정 ID (신규 property 생성 위치) — 예: 123456'),
+        analyticsPropertyId: z.string().optional().describe('기존 GA4 property ID 에 링크할 경우'),
+    }, async ({ projectId, analyticsAccountId, analyticsPropertyId }) => {
+        const auth = await requireAuth();
+        const result = await firebase.linkAnalytics(auth, projectId, { analyticsAccountId, analyticsPropertyId });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool('firebase_get_analytics_details', '프로젝트의 GA4 링크 상세 — 연결된 analyticsProperty + 앱↔data stream 매핑 조회.', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
+        const auth = await requireAuth();
+        const details = await firebase.getAnalyticsDetails(auth, projectId);
+        return { content: [{ type: 'text', text: JSON.stringify(details, null, 2) }] };
+    });
 }

package/dist/registers/ga4.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGa4Tools(server: McpServer): void;

package/dist/registers/ga4.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import * as ga4Raw from '../ga4/tools.js';
+import { requireAuth } from '../helpers.js';
+import { friendlyGoogleError } from '../lib/google-errors.js';
+// firebase register 와 동일한 프록시 — raw GaxiosError(SERVICE_DISABLED / 403 /
+// ACCESS_TOKEN_SCOPE_INSUFFICIENT)를 "다음에 뭘 할지" 메시지로 변환. 특히 GA4 는
+// analytics.edit 스코프를 새로 추가했으므로 기존 사용자는 재로그인 안내가 필수.
+const ga4 = new Proxy(ga4Raw, {
+    get(target, prop, receiver) {
+        const orig = Reflect.get(target, prop, receiver);
+        if (typeof orig !== 'function')
+            return orig;
+        return (...args) => {
+            try {
+                const out = orig(...args);
+                if (out && typeof out.then === 'function') {
+                    return out.catch((err) => {
+                        throw friendlyGoogleError(err);
+                    });
+                }
+                return out;
+            }
+            catch (err) {
+                throw friendlyGoogleError(err);
+            }
+        };
+    },
+});
+const PROPERTY_DESC = "GA4 property ID — '123456789' 또는 'properties/123456789'";
+export function registerGa4Tools(server) {
+    server.tool('ga4_list_account_summaries', '접근 가능한 Google Analytics 계정 + 각 계정의 GA4 property 요약. accountId / propertyId 를 확인할 때 먼저 호출. analytics.edit 스코프 필요(없으면 재로그인 안내).', {}, async () => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const summaries = await ga4.listAccountSummaries(auth);
+        return { content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }] };
+    });
+    server.tool('ga4_list_properties', '특정 GA 계정 하위 GA4 property 목록.', { accountId: z.string().describe("GA 계정 ID — '123' 또는 'accounts/123'") }, async ({ accountId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const properties = await ga4.listProperties(auth, accountId);
+        return { content: [{ type: 'text', text: JSON.stringify(properties, null, 2) }] };
+    });
+    server.tool('ga4_create_property', '새 GA4 property 생성. 생성 후 ga4_create_data_stream 으로 플랫폼별 stream(웹=measurement ID, 앱=firebaseAppId)을 붙인다.', {
+        accountId: z.string().describe("GA 계정 ID — '123' 또는 'accounts/123'"),
+        displayName: z.string().describe('property 표시 이름 (예: SpeakReward)'),
+        timeZone: z.string().optional().describe("IANA 타임존 (기본 'America/Los_Angeles', 예: 'Asia/Seoul')"),
+        currencyCode: z.string().optional().describe("ISO 4217 통화코드 (기본 'USD', 예: 'KRW')"),
+    }, async ({ accountId, displayName, timeZone, currencyCode }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const property = await ga4.createProperty(auth, { accountId, displayName, timeZone, currencyCode });
+        return { content: [{ type: 'text', text: JSON.stringify(property, null, 2) }] };
+    });
+    server.tool('ga4_create_data_stream', 'GA4 property 에 data stream 생성. web → measurementId(G-XXXX) 반환, android/ios → firebaseAppId 반환(Firebase 링크 시). RN 앱은 android/ios 스트림 사용.', {
+        propertyId: z.string().describe(PROPERTY_DESC),
+        platform: z.enum(['web', 'android', 'ios']).describe('스트림 플랫폼'),
+        displayName: z.string().describe('스트림 표시 이름'),
+        defaultUri: z.string().optional().describe('web 전용 — 사이트 URL (예: https://example.com)'),
+        packageName: z.string().optional().describe('android 전용 — 패키지명 (예: com.example.app)'),
+        bundleId: z.string().optional().describe('ios 전용 — Bundle ID (예: com.example.app)'),
+    }, async ({ propertyId, platform, displayName, defaultUri, packageName, bundleId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const stream = await ga4.createDataStream(auth, propertyId, {
+            platform,
+            displayName,
+            defaultUri,
+            packageName,
+            bundleId,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(stream, null, 2) }] };
+    });
+    server.tool('ga4_list_data_streams', 'GA4 property 의 data stream 목록 (measurementId / firebaseAppId 평탄화).', { propertyId: z.string().describe(PROPERTY_DESC) }, async ({ propertyId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const streams = await ga4.listDataStreams(auth, propertyId);
+        return { content: [{ type: 'text', text: JSON.stringify(streams, null, 2) }] };
+    });
+    server.tool('ga4_run_report', 'GA4 Data API 리포트 (활성 사용자·이벤트 등). dimensions/metrics 는 쉼표 구분 GA4 API 이름.', {
+        propertyId: z.string().describe(PROPERTY_DESC),
+        startDate: z.string().describe("시작일 (YYYY-MM-DD 또는 'NdaysAgo', 'today')"),
+        endDate: z.string().describe("종료일 (YYYY-MM-DD 또는 'today')"),
+        dimensions: z.string().optional().describe('쉼표 구분 dimension (예: date,country). 생략 시 전체 합계'),
+        metrics: z.string().optional().describe('쉼표 구분 metric (기본 activeUsers,eventCount)'),
+    }, async ({ propertyId, startDate, endDate, dimensions, metrics }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const report = await ga4.runReport(auth, propertyId, {
+            startDate,
+            endDate,
+            dimensions: dimensions ? dimensions.split(',').map((d) => d.trim()).filter(Boolean) : undefined,
+            metrics: metrics ? metrics.split(',').map((m) => m.trim()).filter(Boolean) : undefined,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
+    });
+}

package/dist/registers/playstore.js

@@ -46,7 +46,7 @@ export function registerPlaystoreTools(server) {
         const listing = await playstore.getListing(auth, packageName, language);
         return { content: [{ type: 'text', text: JSON.stringify(listing, null, 2) }] };
     });
-    server.tool('playstore_update_listing', 'Google Play 스토어 리스팅 수정 (제목, 설명문 변경)', {
+    server.tool('playstore_update_listing', 'Google Play 스토어 리스팅 수정 (제목, 설명문 변경). ⚠️ Play API 편집과 Console 동시 편집은 충돌 — Console에서 같은 리스팅을 편집·미게시 중이면 그 변경이 덮어써질 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드 (예: ko-KR, en-US)'),
         title: z.string().optional().describe('앱 제목 (30자 이내)'),
@@ -115,7 +115,7 @@ export function registerPlaystoreTools(server) {
         const images = await playstore.listImages(auth, packageName, language, imageType);
         return { content: [{ type: 'text', text: JSON.stringify(images, null, 2) }] };
     });
-    server.tool('playstore_upload_image', 'Google Play 리스팅 이미지 단일 업로드 (기존 이미지 유지). featureGraphic 1024x500 / icon 512x512 / phoneScreenshots 320~3840px', {
+    server.tool('playstore_upload_image', 'Google Play 리스팅 이미지 단일 업로드 (기존 이미지 유지). featureGraphic 1024x500 / icon 512x512 / phoneScreenshots 320~3840px. ⚠️ 이 작업은 edit을 commit하므로 Play Console의 미게시(저장 전) 리스팅 변경을 덮어쓸 수 있음 — Console에서 같은 앱을 편집 중이면 먼저 저장·게시하거나 텍스트도 update_listing으로 처리하세요.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
@@ -125,7 +125,7 @@ export function registerPlaystoreTools(server) {
         const result = await playstore.uploadImage(auth, packageName, language, imageType, filePath);
         return { content: [{ type: 'text', text: `✅ 업로드 완료\n${JSON.stringify(result, null, 2)}` }] };
     });
-    server.tool('playstore_delete_all_images', 'Google Play 리스팅 특정 imageType의 이미지 전체 삭제 (교체 전 정리)', {
+    server.tool('playstore_delete_all_images', 'Google Play 리스팅 특정 imageType의 이미지 전체 삭제 (교체 전 정리). ⚠️ commit이 Play Console의 미게시 리스팅 변경을 덮어쓸 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
@@ -134,7 +134,7 @@ export function registerPlaystoreTools(server) {
         const result = await playstore.deleteAllImages(auth, packageName, language, imageType);
         return { content: [{ type: 'text', text: `✅ 전체 삭제\n${JSON.stringify(result, null, 2)}` }] };
     });
-    server.tool('playstore_replace_images', 'Google Play 리스팅 이미지 일괄 교체 (한 edit 세션: deleteall → 순서대로 upload → commit). 스크린샷 5~8장 한 번에 교체 시 효율적. 업로드 순서가 스토어 노출 순서', {
+    server.tool('playstore_replace_images', 'Google Play 리스팅 이미지 일괄 교체 (한 edit 세션: deleteall → 순서대로 upload → commit). 스크린샷 5~8장 한 번에 교체 시 효율적. 업로드 순서가 스토어 노출 순서. ⚠️ commit이 Play Console의 미게시 리스팅 변경을 덮어쓸 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),