@dongsik/ga4-mcp 0.1.1 → 0.1.3

package/README.md

@@ -59,8 +59,15 @@ npx -y @dongsik/ga4-mcp
 1. Create or select a project in [Google Cloud Console](https://console.cloud.google.com/)
 2. **APIs & Services → Library** → Enable "Google Analytics Data API"
 3. **APIs & Services → Library** → Enable "Google Analytics Admin API"
-4. **APIs & Services → Credentials** → Create **OAuth 2.0 Client ID** (type: Desktop app)
-5. Download the JSON file and save as `client_secret.json`
+4. **APIs & Services → OAuth consent screen** → Set User Type to **External**, add your Google account as a test user
+5. **APIs & Services → Credentials** → Create **OAuth 2.0 Client ID** (type: Desktop app)
+6. Download the JSON file → this is your `client_secret.json`
+
+### Find your GA4 Property ID
+
+1. Go to [Google Analytics](https://analytics.google.com)
+2. Bottom left **Admin (gear icon)** → **Property Settings**
+3. Your **Property ID** is the numeric ID shown at the top (e.g. `417304962`)
 
 ## Installation
 
@@ -73,7 +80,7 @@ Add to your `claude_desktop_config.json`:
   "mcpServers": {
     "ga": {
       "command": "npx",
-      "args": ["-y", "@dongsik/ga4-mcp"],
+      "args": ["--package=@dongsik/ga4-mcp", "ga4-mcp"],
       "env": {
         "GA_CLIENT_SECRET_PATH": "/path/to/client_secret.json",
         "GA4_PROPERTY_ID": "123456789"
@@ -88,13 +95,13 @@ Add to your `claude_desktop_config.json`:
 ### Claude Code (CLI)
 
 ```bash
-claude mcp add ga4 -- npx -y @dongsik/ga4-mcp
+claude mcp add ga4 -- npx --package=@dongsik/ga4-mcp ga4-mcp
 ```
 
 Set environment variables:
 
 ```bash
-claude mcp add ga4 -e GA_CLIENT_SECRET_PATH=/path/to/client_secret.json -e GA4_PROPERTY_ID=123456789 -- npx -y @dongsik/ga4-mcp
+claude mcp add ga4 -e GA_CLIENT_SECRET_PATH=/path/to/client_secret.json -e GA4_PROPERTY_ID=123456789 -- npx --package=@dongsik/ga4-mcp ga4-mcp
 ```
 
 ### Environment Variables

package/docs/README.ko.md

@@ -59,8 +59,15 @@ npx -y @dongsik/ga4-mcp
 1. [Google Cloud Console](https://console.cloud.google.com/)에서 프로젝트 생성 또는 선택
 2. **APIs & Services → Library** → "Google Analytics Data API" 활성화
 3. **APIs & Services → Library** → "Google Analytics Admin API" 활성화
-4. **APIs & Services → Credentials** → **OAuth 2.0 Client ID** 생성 (유형: Desktop app)
-5. JSON 다운로드 → `client_secret.json`으로 저장
+4. **APIs & Services → OAuth 동의 화면** → 사용자 유형 **외부** 선택, 테스트 사용자에 본인 Google 계정 추가
+5. **APIs & Services → Credentials** → **OAuth 2.0 Client ID** 생성 (유형: Desktop app)
+6. JSON 다운로드 → 이 파일이 `client_secret.json`
+
+### GA4 속성 ID 확인
+
+1. [Google Analytics](https://analytics.google.com) 접속
+2. 왼쪽 하단 **관리(톱니바퀴)** → **속성 설정**
+3. 상단에 표시된 숫자가 **속성 ID** (예: `417304962`)
 
 ## 설치 및 실행
 
@@ -73,7 +80,7 @@ npx -y @dongsik/ga4-mcp
   "mcpServers": {
     "ga": {
       "command": "npx",
-      "args": ["-y", "@dongsik/ga4-mcp"],
+      "args": ["--package=@dongsik/ga4-mcp", "ga4-mcp"],
       "env": {
         "GA_CLIENT_SECRET_PATH": "/path/to/client_secret.json",
         "GA4_PROPERTY_ID": "123456789"
@@ -88,13 +95,13 @@ npx -y @dongsik/ga4-mcp
 ### Claude Code (CLI)
 
 ```bash
-claude mcp add ga4 -- npx -y @dongsik/ga4-mcp
+claude mcp add ga4 -- npx --package=@dongsik/ga4-mcp ga4-mcp
 ```
 
 환경변수 설정:
 
 ```bash
-claude mcp add ga4 -e GA_CLIENT_SECRET_PATH=/path/to/client_secret.json -e GA4_PROPERTY_ID=123456789 -- npx -y @dongsik/ga4-mcp
+claude mcp add ga4 -e GA_CLIENT_SECRET_PATH=/path/to/client_secret.json -e GA4_PROPERTY_ID=123456789 -- npx --package=@dongsik/ga4-mcp ga4-mcp
 ```
 
 ### 환경변수

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@dongsik/ga4-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Google Analytics 4 MCP Server",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "ga4-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x dist/index.js",
     "start": "node dist/index.js"
   },
   "dependencies": {