coupon-moa-mcp 0.1.0 → 0.2.0

package/README.md

@@ -40,9 +40,40 @@ Coupon Moa 어드민 MCP Server. Claude Desktop 또는 Claude Code에서 어드
 }
 ```
 
+### Codex
+
+CLI로 추가:
+
+```bash
+codex mcp add coupon-moa -- npx -y coupon-moa-mcp
+```
+
+또는 `~/.codex/config.toml` (또는 프로젝트 루트 `.codex/config.toml`)에 직접 추가:
+
+```toml
+[mcp_servers.coupon-moa]
+command = "npx"
+args = ["-y", "coupon-moa-mcp"]
+
+[mcp_servers.coupon-moa.env]
+ADMIN_API_URL = "https://your-api-url.com"
+```
+
 ## 인증
 
-처음 실행 시 브라우저가 열리면서 Google 로그인을 요청합니다. 로그인 완료 후 토큰이 `~/.coupon-moa-mcp/token.json`에 저장되며, 이후 자동으로 사용됩니다.
+MCP를 사용하기 전에 먼저 로그인이 필요합니다:
+
+```bash
+ADMIN_API_URL=https://your-api-url.com npx coupon-moa-mcp login
+```
+
+브라우저가 열리면 Google 로그인 후 토큰이 `~/.coupon-moa-mcp/token.json`에 저장됩니다. 이후 MCP 실행 시 자동으로 사용됩니다.
+
+로그아웃:
+
+```bash
+npx coupon-moa-mcp logout
+```
 
 ## Tools
 

package/bin/coupon-moa-mcp.mjs

@@ -4,4 +4,12 @@ import { pathToFileURL } from 'node:url';
 
 register('tsx/esm', pathToFileURL('./'));
 
-const { default: _ } = await import('../src/index.ts');
+const command = process.argv[2];
+
+if (command === 'login') {
+  await import('../src/cli-login.ts');
+} else if (command === 'logout') {
+  await import('../src/cli-logout.ts');
+} else {
+  await import('../src/index.ts');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coupon-moa-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Coupon Moa admin — push store data, query brands/cities/stores via Claude",
   "private": false,
   "type": "module",

package/src/auth.ts

@@ -14,16 +14,20 @@ interface StoredTokens {
   savedAt: number;
 }
 
+export async function loadStoredToken(): Promise<string | null> {
+  const stored = await loadTokens();
+  return stored?.accessToken ?? null;
+}
+
 export async function getAccessToken(apiUrl: string): Promise<string> {
   // 저장된 토큰 확인
   const stored = await loadTokens();
   if (stored) {
-    // accessToken 유효성은 API 호출 시 확인 — 여기서는 일단 반환
     return stored.accessToken;
   }
 
-  // 토큰 없으면 OAuth 로그인
-  console.error('[MCP] 로그인이 필요합니다. 브라우저가 열립니다...');
+  // 토큰 없으면 OAuth 로그인 (CLI login 명령에서만 호출)
+  console.log('브라우저에서 로그인해주세요...');
   const tokens = await startOAuthFlow(apiUrl);
   await saveTokens(tokens);
   return tokens.accessToken;

package/src/cli-login.ts

@@ -0,0 +1,24 @@
+import { getAccessToken, clearTokens } from './auth.js';
+
+const apiUrl = process.env.ADMIN_API_URL || 'http://localhost:8080';
+
+console.log('=== coupon-moa-mcp 로그인 ===');
+console.log(`API URL: ${apiUrl}`);
+console.log('');
+
+try {
+  // 기존 토큰 삭제 후 새로 로그인
+  await clearTokens();
+  const token = await getAccessToken(apiUrl);
+  console.log('');
+  console.log('로그인 성공! 토큰이 저장되었습니다.');
+  console.log(`토큰 미리보기: ${token.slice(0, 20)}...`);
+  console.log('');
+  console.log('이제 Claude Desktop/Code/Codex에서 coupon-moa MCP를 사용할 수 있습니다.');
+} catch (error) {
+  const message = error instanceof Error ? error.message : 'Unknown error';
+  console.error(`로그인 실패: ${message}`);
+  process.exit(1);
+}
+
+process.exit(0);

package/src/cli-logout.ts

@@ -0,0 +1,12 @@
+import { clearTokens } from './auth.js';
+
+try {
+  await clearTokens();
+  console.log('로그아웃 완료. 저장된 토큰이 삭제되었습니다.');
+} catch (error) {
+  const message = error instanceof Error ? error.message : 'Unknown error';
+  console.error(`로그아웃 실패: ${message}`);
+  process.exit(1);
+}
+
+process.exit(0);

package/src/index.ts

@@ -8,7 +8,11 @@ import {
 } from './tools/list-queries.js';
 
 const api = new AdminApiClient();
-await api.initialize();
+try {
+  await api.initialize();
+} catch (error) {
+  console.error(`[MCP] ${error instanceof Error ? error.message : error}`);
+}
 
 const server = new McpServer({
   name: 'coupon-moa-admin',

package/src/ws/ws-server.ts

@@ -1,4 +1,4 @@
-import { getAccessToken, refreshAccessToken, clearTokens } from '../auth.js';
+import { loadStoredToken, refreshAccessToken, clearTokens } from '../auth.js';
 
 const DEFAULT_API_URL = 'http://localhost:8080';
 
@@ -11,12 +11,20 @@ export class AdminApiClient {
   }
 
   async initialize(): Promise<void> {
-    this.token = await getAccessToken(this.apiUrl);
+    const stored = await loadStoredToken();
+    if (stored) {
+      this.token = stored;
+      return;
+    }
+
+    throw new Error(
+      '로그인이 필요합니다. 먼저 `npx coupon-moa-mcp login` 을 실행해주세요.'
+    );
   }
 
   async send(method: string, params: unknown): Promise<unknown> {
     if (!this.token) {
-      await this.initialize();
+      throw new Error('로그인이 필요합니다. `npx coupon-moa-mcp login` 을 실행해주세요.');
     }
 
     let response = await this.fetchApi(method, params);
@@ -28,10 +36,8 @@ export class AdminApiClient {
         this.token = newToken;
         response = await this.fetchApi(method, params);
       } else {
-        // refresh 실패 → 재로그인
         await clearTokens();
-        this.token = await getAccessToken(this.apiUrl);
-        response = await this.fetchApi(method, params);
+        throw new Error('토큰이 만료되었습니다. `npx coupon-moa-mcp login` 으로 다시 로그인해주세요.');
       }
     }