edu-workspace-mcp 0.1.0 → 1.0.0

package/README.md

@@ -2,18 +2,21 @@
 
 자연어로 Google Docs, Sheets, Slides, Forms, Drive와 Classroom을 사용하는 교육 특화 Model Context Protocol(MCP) 서버입니다. Apps Script 없이 Google 공식 API를 직접 호출합니다.
 
-[공식 홈페이지](https://edu.jeld.kr/) · [개인정보처리방침](https://edu.jeld.kr/privacy.html) · [이용약관](https://edu.jeld.kr/terms.html)
+[공식 홈페이지](https://edu.jeld.kr/) · [복사 가능한 예시 프롬프트](https://edu.jeld.kr/#prompts) · [개인정보처리방침](https://edu.jeld.kr/privacy.html) · [이용약관](https://edu.jeld.kr/terms.html)
 
-> 현재 버전은 로컬 stdio MCP 베타입니다. 공용 Google 데스크톱 OAuth 클라이언트가 포함되어 있어 최종 사용자가 Google Cloud 프로젝트를 만들 필요가 없습니다. 앱은 제품 전체 범위 대신 앱이 사용하는 파일에 한정된 `drive.file` 권한을 요청합니다.
+> `1.0.0`은 로컬 stdio MCP 정식 안정 버전입니다. 공용 Google 데스크톱 OAuth 클라이언트가 포함되어 있어 최종 사용자가 Google Cloud 프로젝트를 만들 필요가 없습니다. 기본 모드는 앱이 다루는 파일에 한정된 `drive.file`을 사용하며, 기존 자료 읽기는 사용자가 `--read`로 선택합니다.
 
 ## 할 수 있는 일
 
 - 수업 자료용 Google Docs 문서 생성
-- 학생 명단·루브릭·성적표 형태의 Google Sheets 생성
+- 학생 명단·평가계획·평가기록·제출현황·관찰기록·대시보드가 연결된 Google Sheets 생성
+- 셀 값과 수식 본문을 노출하지 않는 기존 Sheets 구조·수식 오류 진단
+- Classroom 명단·제출 상태를 개인정보 최소화 시트로 변환
 - 차시별 Google Slides 프레젠테이션 생성
 - 정답·배점이 포함된 Google Forms 퀴즈 생성
+- 기존 Docs·Sheets·Slides·Forms 내용과 Forms 응답 읽기
 - Google Drive 파일 검색, 폴더 생성, 승인 후 공유
-- 교사가 담당하는 Google Classroom 수업 조회
+- 교사가 담당하는 Classroom 수업·과제·학생 명단·제출 현황 조회
 - Classroom 과제 초안 생성, 사용자 승인 후 게시
 
 예시 요청:
@@ -36,22 +39,25 @@
 
 대표 데모 프롬프트:
 
-> 5학년 과학 ‘소화와 순환’ 수업 패키지를 만들어줘. Drive에 전용 폴더를 만들고, 교사용 수업안과 학생용 학습지는 Docs로, 6장 수업 자료는 Slides로, 5문항 형성평가는 Forms 퀴즈로 만들어줘. ‘5학년 3반 과학’ Classroom에는 과제 초안까지만 만들고 게시 전에 나에게 확인받아줘.
+> 5학년 과학 ‘소화와 순환’ 40분 수업 패키지를 만들어줘. Drive에 전용 폴더를 만들고, 교사용 수업안과 학생용 학습지는 제목·소제목·본문의 위계와 충분한 답안 공간이 보이게 Docs로 만들어줘. Slides는 한 장에 핵심 메시지 하나씩 7장으로, Forms는 정답·배점을 포함한 5문항으로 구성해줘. 모든 자료에서 학습 목표와 용어를 동일하게 쓰고 정보량을 점검해줘. ‘5학년 3반 과학’ Classroom에는 학생용 자료만 과제 초안으로 연결하고 수업·마감·배점·첨부를 보여준 뒤 게시 전에 확인받아줘.
 
 | 교육 업무 | 만들어지는 결과 | 사용하는 도구 |
 | --- | --- | --- |
 | 한 차시 수업 패키지 | 수업안, 학습지, 슬라이드, 퀴즈, Classroom 초안 | Drive + Docs + Slides + Forms + Classroom |
-| 과정중심평가 관리 | 평가입력·학생별현황·항목별현황 시트 | Sheets |
+| 과정중심평가 관리 | 9개 연결 탭, 드롭다운, 체크박스, 조건부 서식, 차트 | Sheets |
+| Classroom 제출 관리 | 명단·제출 상태·점수·대시보드 스냅샷 | Classroom + Sheets |
+| 복잡한 업무 시트 점검 | 탭·수식 함수·의존성·오류·차트 구조 진단 | Sheets |
 | 수행평가 설계 | 4수준 루브릭 문서와 학생 자기평가지 | Docs + Forms |
 | 형성평가 배포 | 정답·배점이 있는 퀴즈와 과제 초안 | Forms + Classroom |
 | 학기 자료 정리 | 검색 결과와 교과·단원별 Drive 폴더 | Drive |
 | 동료 교사 협업 | 확인 절차를 거친 댓글·읽기·편집 권한 | Drive 공유 |
 
-- [교육자를 위한 실제 활용 예시와 복사 가능한 프롬프트](docs/EDUCATOR_USE_CASES.md)
+- [서비스별로 복사 가능한 예시 프롬프트](https://edu.jeld.kr/#prompts)
+- [교육자를 위한 실제 활용 예시와 도구 흐름](docs/EDUCATOR_USE_CASES.md)
 - [예제 모음과 추천 첫 데모](examples/README.md)
 - [실제로 실행되는 수업 패키지 통합 테스트](src/tests/education-demo.test.ts)
 
-> v0.1은 새 파일 생성과 Classroom 초안·게시 흐름에 집중합니다. 기존 문서의 부분 편집, Sheets 차트·드롭다운·조건부 서식, Forms 응답과 학생 제출물 분석은 아직 지원하지 않습니다. 자세한 지원 범위는 [활용 예시 문서](docs/EDUCATOR_USE_CASES.md#현재-버전에서-가능한-범위)를 확인하세요.
+> 읽기 확장 모드에서는 기존 자료를 조회·분석할 수 있습니다. 교육용 평가·제출 템플릿에는 차트·드롭다운·조건부 서식이 포함됩니다. 기존 문서나 임의 범위의 범용 부분 편집은 아직 지원하지 않습니다. 자세한 지원 범위는 [활용 예시 문서](docs/EDUCATOR_USE_CASES.md#현재-버전에서-가능한-범위)를 확인하세요.
 
 ## MCP 도구
 
@@ -59,12 +65,25 @@
 | --- | --- | --- |
 | `workspace_get_auth_status` | Google 연결 상태와 범위 확인 | 읽기 |
 | `classroom_list_courses` | 교사가 담당하는 활성 수업 조회 | 읽기 |
-| `drive_search_files` | 이름·유형·폴더로 Drive 검색 | 읽기 |
+| `classroom_list_coursework` | 수업의 과제·자료·마감·배점 조회 | 읽기 |
+| `classroom_list_students` | 수업 학생 명단 조회 | 읽기 |
+| `classroom_list_student_submissions` | 과제별 제출 상태·점수·답변 조회 | 읽기 |
+| `drive_search_files` | 앱이 접근 가능한 파일을 이름·유형·폴더로 검색 | 읽기 |
+| `drive_get_file_metadata` | Drive 파일 정보와 권한 상태 조회 | 읽기 |
 | `drive_create_folder` | Drive 폴더 생성 | 생성 |
 | `docs_create_document` | Docs 문서 생성 | 생성 |
+| `docs_read_document` | Docs 본문·표·모든 문서 탭 읽기 | 읽기 |
 | `sheets_create_workbook` | 여러 탭과 초기 데이터가 있는 Sheets 생성 | 생성 |
+| `sheets_list_sheets` | 스프레드시트의 탭 목록과 크기 확인 | 읽기 |
+| `sheets_read_values` | 스프레드시트 값 읽기 (범위 지정, 행 수 제한) | 읽기 |
+| `sheets_inspect_workbook` | 셀 값을 반환하지 않고 구조·수식·오류·의존성 진단 | 읽기 |
+| `education_create_assessment_tracker` | 9개 탭이 연결된 과정중심평가 시스템 생성 | 생성 |
+| `education_create_classroom_submission_tracker` | Classroom 과제 제출 현황 대시보드 시트 생성 | 생성 |
 | `slides_create_presentation` | 제목·본문 슬라이드 생성 | 생성 |
+| `slides_read_presentation` | 슬라이드별 텍스트·표·발표자 노트 읽기 | 읽기 |
 | `forms_create_quiz` | 문항·정답·배점이 있는 퀴즈 생성 | 생성 |
+| `forms_read_form` | 설문 구조·문항·선택지·정답 읽기 | 읽기 |
+| `forms_list_responses` | 제출된 설문 응답·점수 읽기 | 읽기 |
 | `classroom_create_assignment_draft` | 학생에게 보이지 않는 과제 초안 생성 | 생성 |
 | `classroom_publish_assignment` | 승인된 과제 초안을 학생에게 게시 | 외부 변경 |
 | `drive_prepare_share` | 공유 대상·권한 승인 준비 | 승인 준비 |
@@ -72,6 +91,52 @@
 
 게시와 공유 도구에는 MCP 안전 메타데이터가 포함되어 있습니다. 승인 ID는 15분 동안 유효하고 한 번만 사용할 수 있습니다.
 
+### 기존 Google 자료를 읽으려면 (선택)
+
+기본 범위인 `drive.file` 은 **이 앱이 만들었거나 사용자가 이 앱으로 연 파일만** 다룹니다.
+그래서 예전부터 쓰던 Docs·Sheets·Slides·Forms는 기본 설정으로는 읽히지 않을 수 있습니다.
+
+기존 자료와 Classroom 학생 정보를 읽으려면 설치와 로그인에 `--read`를 붙이세요. 서비스별 읽기 전용 범위는 Google에서 민감 범위로 분류하므로 기본으로 요청하지 않습니다.
+
+```bash
+npx -y edu-workspace-mcp@1.0.0 install claude --read
+npx -y edu-workspace-mcp@1.0.0 login --read
+```
+
+MCP 클라이언트 설정에 넣을 때는 `env` 에 적습니다.
+
+```json
+{
+  "mcpServers": {
+    "edu-workspace": {
+      "command": "npx",
+      "args": ["-y", "edu-workspace-mcp"],
+      "env": { "EDU_WORKSPACE_READ_ACCESS": "1" }
+    }
+  }
+}
+```
+
+껐다 켰다 하면 요청 범위가 달라지므로, 바꾼 뒤에는 **반드시 다시 로그인**해야 합니다.
+`workspace_get_auth_status` 로 지금 허용된 범위를 확인할 수 있습니다.
+
+`claude`는 Claude Code의 사용자 범위에 등록되어 모든 프로젝트에서 동작합니다. Claude Desktop은 `install claude-desktop --read`를 사용하세요. 사용 예:
+
+```
+sheets_list_sheets  { "spreadsheet": "https://docs.google.com/spreadsheets/d/<ID>/edit" }
+sheets_read_values  { "spreadsheet": "<ID>", "range": "'AI 피드백'!A1:J40", "maxRows": 40 }
+sheets_inspect_workbook { "spreadsheet": "<ID>", "includeHidden": true }
+education_create_assessment_tracker { "title": "5학년 평가 관리", "className": "5학년 3반", "schoolYear": 2026, "semester": "2학기", "students": [{ "number": 1, "name": "학생01" }] }
+docs_read_document  { "document": "https://docs.google.com/document/d/<ID>/edit" }
+forms_list_responses { "form": "https://docs.google.com/forms/d/<ID>/edit", "maxResponses": 100 }
+```
+
+- `spreadsheet` 는 ID 와 전체 URL 을 모두 받습니다.
+- `range` 를 비우면 첫 시트를 읽습니다.
+- 값은 화면에 보이는 대로 읽으므로 수식과 `IMPORTRANGE` 결과도 그대로 들어옵니다. 원본 값이 필요하면 `raw: true`.
+- 기본 200행까지만 돌려주고(`maxRows` 로 최대 2,000), 잘렸으면 `truncated: true` 로 알려 줍니다.
+- 개인정보가 있는 복잡한 시트의 설계만 점검할 때는 `sheets_inspect_workbook`을 사용하세요. 셀 값과 수식 본문은 반환하지 않고 함수명 통계·시트 의존성·오류 위치만 알려 줍니다.
+
 ## 요구 사항
 
 - Node.js 20 이상
@@ -80,23 +145,33 @@
 
 ## 빠른 설치 — 최종 사용자
 
-정식 npm 배포 후 macOS, Windows, Linux에서 다음 두 단계만 진행합니다. Google Cloud Console 설정은 필요하지 않습니다.
+macOS, Windows, Linux에서 사용할 AI 클라이언트를 한 번만 전체 프로젝트 설정에 등록합니다. Google Cloud Console 설정은 필요하지 않습니다.
 
 ```bash
-npx -y edu-workspace-mcp setup
-npx -y edu-workspace-mcp login
+# 하나만 선택
+npx -y edu-workspace-mcp@1.0.0 install codex
+npx -y edu-workspace-mcp@1.0.0 install claude          # Claude Code, 사용자 범위
+npx -y edu-workspace-mcp@1.0.0 install claude-desktop
+npx -y edu-workspace-mcp@1.0.0 install cursor
+
+# 사용자별·컴퓨터별 최초 1회 Google 연결
+npx -y edu-workspace-mcp@1.0.0 login
 ```
 
-브라우저에서 Google 로그인과 권한 승인을 마치고 MCP 클라이언트에 연결하면 됩니다. 학교 계정에서 기관 관리자가 제3자 앱을 차단한 경우에는 관리자에게 앱 허용을 요청해야 합니다.
+기존 Google 자료까지 읽을 사용자는 두 명령 모두에 `--read`를 붙입니다.
+
+AI 클라이언트를 재시작한 뒤 새 프로젝트에서도 같은 MCP를 사용할 수 있습니다. 브라우저에서 Google 로그인과 권한 승인을 마치면 됩니다. 학교 계정에서 기관 관리자가 제3자 앱을 차단한 경우에는 관리자에게 앱 허용을 요청해야 합니다.
+
+- [학교 Google Workspace 관리자 허용 안내](docs/ADMIN_GUIDE.md)
 
 ```bash
-npx -y edu-workspace-mcp doctor
+npx -y edu-workspace-mcp@1.0.0 doctor
 ```
 
-Google 토큰은 `~/.edu-workspace-mcp/token.json`에 사용자 전용 권한으로 저장됩니다. 연결을 해제하려면 다음을 실행합니다.
+Google 토큰은 `~/.edu-workspace-mcp/token.json`에 사용자 전용 권한으로 저장됩니다. 연결을 해제하면 Google 측 권한 철회와 로컬 토큰 삭제를 함께 수행합니다.
 
 ```bash
-npx -y edu-workspace-mcp disconnect
+npx -y edu-workspace-mcp@1.0.0 disconnect
 ```
 
 ## MCP 클라이언트 연결
@@ -108,7 +183,7 @@ Claude Desktop과 Cursor 계열 JSON 설정:
   "mcpServers": {
     "edu-workspace": {
       "command": "npx",
-      "args": ["-y", "edu-workspace-mcp"]
+      "args": ["-y", "edu-workspace-mcp@1.0.0"]
     }
   }
 }
@@ -117,9 +192,9 @@ Claude Desktop과 Cursor 계열 JSON 설정:
 Codex·ChatGPT Desktop 계열 TOML 설정:
 
 ```toml
-[mcp_servers.edu_workspace]
+[mcp_servers.edu-workspace]
 command = "npx"
-args = ["-y", "edu-workspace-mcp"]
+args = ["-y", "edu-workspace-mcp@1.0.0"]
 default_tools_approval_mode = "writes"
 ```
 
@@ -143,13 +218,16 @@ node dist/cli.js login
 ## 보안 모델
 
 - 필요한 Google OAuth 범위만 요청합니다.
+- OAuth 로그인에 PKCE(S256), 무작위 `state`, 5분 만료와 loopback 콜백 검증을 적용합니다.
 - 사용자의 OAuth 액세스·갱신 토큰은 Git에 포함되지 않고 로컬 사용자 폴더에만 저장됩니다.
 - 설치형 앱은 비밀을 유지할 수 없는 공개 클라이언트이므로 배포용 데스크톱 client ID와 client secret은 앱에 포함됩니다.
+- 기존 자료 읽기 범위는 기본으로 요청하지 않고 `--read` 또는 `EDU_WORKSPACE_READ_ACCESS=1`로 켠 사람에게만 추가합니다.
 - 검색·조회 도구에는 `readOnlyHint`를 표시합니다.
 - Classroom 게시와 Drive 공유에는 `destructiveHint`를 표시합니다.
 - Classroom 과제는 먼저 `DRAFT`로 만들고 별도 게시 도구에서 일회성 승인을 검증합니다.
 - Drive 공유도 준비와 확정 단계를 분리합니다.
 - 실제 학생 데이터가 아닌 별도 테스트 수업에서 먼저 검증하세요.
+- Google API 할당량 오류에는 제한적 지수 백오프를 적용하고, 중복 생성 위험이 있는 모호한 오류는 자동 재시도하지 않습니다.
 
 Google OAuth 브랜딩과 개인정보처리방침을 공개해야 하며, Google Workspace for Education 관리자가 제3자 앱을 허용해야 할 수 있습니다.
 
@@ -170,16 +248,21 @@ Google API 실계정 테스트에는 별도 테스트 계정을 사용하세요.
 
 - [x] OAuth 로그인·토큰 저장·연결 해제
 - [x] Drive 검색·폴더 생성·승인 공유
-- [x] Docs·Sheets·Slides·Forms 생성
+- [x] Docs·Sheets·Slides·Forms 생성 및 내용 읽기
+- [x] 과정중심평가·Classroom 제출 대시보드 교육 템플릿
+- [x] 개인정보 비노출 Sheets 구조·수식 오류 진단
 - [x] Classroom 수업 조회·과제 초안·승인 게시
 - [x] macOS·Windows·Linux 공통 npm 실행 구조
 - [x] 단위·MCP 통합·stdio 스모크 테스트
 - [x] 실계정 OAuth·Classroom 조회·Sheets 생성 E2E 테스트
-- [ ] Google OAuth 공개 앱 검증
+- [x] Google OAuth 브랜딩 검증·프로덕션 게시·비민감 범위 판정
+- [x] PKCE·state·토큰 파일 보호·할당량 재시도 정책
+- [x] Codex·Claude Code·Claude Desktop·Cursor 전역 자동 설치
 - [ ] 호스팅형 Streamable HTTP MCP
 - [ ] Calendar·Gmail·Tasks 확장
 
 전체 제품 계획은 [docs/IMPLEMENTATION_PLAN.md](docs/IMPLEMENTATION_PLAN.md)를 참고하세요.
+정식판 출시 기준과 운영 정책은 [정식 배포 운영 기준](docs/PRODUCTION_READINESS.md), 버전별 변경 사항은 [CHANGELOG](CHANGELOG.md)를 참고하세요.
 
 ## 라이선스
 

package/dist/auth/google-auth.d.ts

@@ -5,8 +5,19 @@ export type AuthStatus = {
     credentialsPath: string;
     tokenPath: string;
     grantedScopes: string[];
+    missingScopes?: string[];
+    unexpectedScopes?: string[];
+    tokenFileProtected?: boolean;
+    readAccessEnabled: boolean;
     message: string;
 };
+export declare function validateOAuthCallback(callbackUrl: URL, expectedState: string): string;
 export declare function getAuthStatus(): Promise<AuthStatus>;
 export declare function login(): Promise<AuthStatus>;
 export declare function getAuthorizedClient(): Promise<import("googleapis-common").OAuth2Client>;
+export declare function disconnectGoogleAccount(options?: {
+    localOnly?: boolean;
+}): Promise<{
+    revoked: boolean;
+    tokenPath: string;
+}>;

package/dist/auth/google-auth.js

@@ -1,9 +1,64 @@
 import { createServer } from "node:http";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { randomBytes, randomUUID } from "node:crypto";
+import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { google } from "googleapis";
-import { credentialsPath, GOOGLE_SCOPES, tokenPath } from "../config.js";
+import { CodeChallengeMethod } from "google-auth-library";
+import { credentialsPath, googleScopes, readAccessEnabled, tokenPath } from "../config.js";
 import { BUNDLED_GOOGLE_OAUTH_CLIENT } from "./bundled-oauth-client.js";
+const LOGIN_TIMEOUT_MS = 5 * 60_000;
+function createState() {
+    return randomBytes(32).toString("base64url");
+}
+export function validateOAuthCallback(callbackUrl, expectedState) {
+    const error = callbackUrl.searchParams.get("error");
+    if (error)
+        throw new Error(`Google OAuth 오류: ${error}`);
+    if (callbackUrl.searchParams.get("state") !== expectedState) {
+        throw new Error("OAuth state가 일치하지 않습니다. 로그인을 다시 시도하세요.");
+    }
+    const code = callbackUrl.searchParams.get("code");
+    if (!code)
+        throw new Error("OAuth 콜백에 인증 코드가 없습니다.");
+    return code;
+}
+async function openSystemBrowser(url) {
+    const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32" : "xdg-open";
+    const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { detached: true, stdio: "ignore" });
+        child.once("error", () => resolve(false));
+        child.once("spawn", () => {
+            child.unref();
+            resolve(true);
+        });
+    });
+}
+async function protectTokenFile(filePath) {
+    if (process.platform === "win32")
+        return true;
+    try {
+        await chmod(filePath, 0o600);
+        return ((await stat(filePath)).mode & 0o077) === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeTokenAtomically(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    const temporaryPath = `${filePath}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporaryPath, JSON.stringify(value, null, 2), { mode: 0o600 });
+        await rename(temporaryPath, filePath);
+        if (!(await protectTokenFile(filePath)))
+            throw new Error("OAuth 토큰 파일 권한을 안전하게 설정하지 못했습니다.");
+    }
+    finally {
+        await rm(temporaryPath, { force: true });
+    }
+}
 async function readJson(filePath) {
     return JSON.parse(await readFile(filePath, "utf8"));
 }
@@ -57,14 +112,29 @@ export async function getAuthStatus() {
         if (oauthClientSource === "missing")
             throw new Error("OAuth client missing");
         const token = (await readJson(tokenFile));
+        const grantedScopes = token.scope?.split(" ").filter(Boolean) ?? [];
+        const expectedScopes = googleScopes();
+        const missingScopes = expectedScopes.filter((scope) => !grantedScopes.includes(scope));
+        const unexpectedScopes = grantedScopes.filter((scope) => !expectedScopes.includes(scope));
+        const tokenFileProtected = await protectTokenFile(tokenFile);
         return {
             authenticated: true,
             oauthClientConfigured: true,
             oauthClientSource,
             credentialsPath: credentialFile,
             tokenPath: tokenFile,
-            grantedScopes: token.scope?.split(" ").filter(Boolean) ?? [],
-            message: "Google 계정이 연결되어 있습니다."
+            grantedScopes,
+            missingScopes,
+            unexpectedScopes,
+            tokenFileProtected,
+            readAccessEnabled: readAccessEnabled(),
+            message: missingScopes.length
+                ? "Google 토큰에 필요한 권한이 없습니다. disconnect 후 다시 로그인하세요."
+                : unexpectedScopes.length
+                    ? "Google 계정은 연결되어 있지만 이전의 추가 권한이 남아 있습니다. 최소 권한으로 다시 로그인하는 것을 권장합니다."
+                    : readAccessEnabled()
+                        ? "Google 계정이 읽기 확장 권한으로 안전하게 연결되어 있습니다."
+                        : "Google 계정이 기본 권한으로 안전하게 연결되어 있습니다."
         };
     }
     catch {
@@ -75,6 +145,7 @@ export async function getAuthStatus() {
             credentialsPath: credentialFile,
             tokenPath: tokenFile,
             grantedScopes: [],
+            readAccessEnabled: readAccessEnabled(),
             message: oauthClientSource === "missing"
                 ? "공용 Google OAuth 앱이 아직 구성되지 않았습니다. 개발용 credentials.json 또는 환경 변수가 필요합니다."
                 : "Google 계정이 연결되지 않았습니다. edu-workspace-mcp login을 실행하세요."
@@ -82,24 +153,32 @@ export async function getAuthStatus() {
     }
 }
 export async function login() {
-    const credentialFile = credentialsPath();
     const tokenFile = tokenPath();
     const { config } = await loadClientConfig();
+    const expectedState = createState();
     const callbackServer = createServer();
     const authorizationCode = new Promise((resolve, reject) => {
-        callbackServer.once("request", (request, response) => {
+        const timeout = setTimeout(() => reject(new Error("Google 로그인 대기 시간이 만료되었습니다. 다시 시도하세요.")), LOGIN_TIMEOUT_MS);
+        callbackServer.on("request", (request, response) => {
             const callbackUrl = new URL(request.url ?? "/", "http://127.0.0.1");
-            const error = callbackUrl.searchParams.get("error");
-            const code = callbackUrl.searchParams.get("code");
-            if (error || !code) {
+            if (callbackUrl.pathname !== "/oauth2callback") {
+                response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+                response.end("Not found");
+                return;
+            }
+            try {
+                const code = validateOAuthCallback(callbackUrl, expectedState);
+                clearTimeout(timeout);
+                response.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store" });
+                response.end("로그인이 완료되었습니다. 이 창을 닫고 터미널로 돌아가세요.");
+                resolve(code);
+            }
+            catch (error) {
+                clearTimeout(timeout);
                 response.writeHead(400, { "content-type": "text/html; charset=utf-8" });
                 response.end("Google 로그인을 완료하지 못했습니다. 터미널에서 다시 시도하세요.");
-                reject(new Error(error ? `Google OAuth 오류: ${error}` : "OAuth 콜백에 인증 코드가 없습니다."));
-                return;
+                reject(error);
             }
-            response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
-            response.end("로그인이 완료되었습니다. 이 창을 닫고 터미널로 돌아가세요.");
-            resolve(code);
         });
     });
     await new Promise((resolve, reject) => {
@@ -113,12 +192,17 @@ export async function login() {
     }
     const redirectUri = `http://127.0.0.1:${address.port}/oauth2callback`;
     const client = createOAuthClient(config, redirectUri);
+    const { codeVerifier, codeChallenge } = await client.generateCodeVerifierAsync();
     const authUrl = client.generateAuthUrl({
         access_type: "offline",
         prompt: "consent",
-        scope: [...GOOGLE_SCOPES]
+        scope: googleScopes(),
+        state: expectedState,
+        code_challenge: codeChallenge,
+        code_challenge_method: CodeChallengeMethod.S256
     });
-    console.log("브라우저에서 아래 URL을 열어 Google 로그인을 완료하세요:\n");
+    const browserOpened = await openSystemBrowser(authUrl);
+    console.log(browserOpened ? "기본 브라우저에서 Google 로그인을 완료하세요.\n" : "브라우저에서 아래 URL을 열어 Google 로그인을 완료하세요:\n");
     console.log(authUrl);
     let code;
     try {
@@ -127,12 +211,11 @@ export async function login() {
     finally {
         callbackServer.close();
     }
-    const { tokens } = await client.getToken(code);
+    const { tokens } = await client.getToken({ code, codeVerifier, redirect_uri: redirectUri });
     if (!tokens.refresh_token) {
         throw new Error("갱신 토큰을 받지 못했습니다. Google 계정에서 기존 앱 권한을 해제한 뒤 다시 로그인하세요.");
     }
-    await mkdir(path.dirname(tokenFile), { recursive: true });
-    await writeFile(tokenFile, JSON.stringify(tokens, null, 2), { mode: 0o600 });
+    await writeTokenAtomically(tokenFile, tokens);
     return getAuthStatus();
 }
 export async function getAuthorizedClient() {
@@ -142,4 +225,20 @@ export async function getAuthorizedClient() {
     client.setCredentials((await readJson(tokenFile)));
     return client;
 }
+export async function disconnectGoogleAccount(options = {}) {
+    const tokenFile = tokenPath();
+    let revoked = false;
+    if (!options.localOnly) {
+        const token = (await readJson(tokenFile));
+        const credential = token.refresh_token ?? token.access_token;
+        if (!credential)
+            throw new Error("철회할 Google OAuth 토큰을 찾지 못했습니다. --local-only로 로컬 파일만 삭제할 수 있습니다.");
+        const { config } = await loadClientConfig();
+        const client = createOAuthClient(config);
+        await client.revokeToken(credential);
+        revoked = true;
+    }
+    await rm(tokenFile, { force: true });
+    return { revoked, tokenPath: tokenFile };
+}
 //# sourceMappingURL=google-auth.js.map

package/dist/auth/google-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-auth.js","sourceRoot":"","sources":["../../src/auth/google-auth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"google-auth.js","sourceRoot":"","sources":["../../src/auth/google-auth.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -1,17 +1,31 @@
 #!/usr/bin/env node
-import { mkdir, rm } from "node:fs/promises";
-import { APP_DIRECTORY, credentialsPath, tokenPath } from "./config.js";
-import { getAuthStatus, getAuthorizedClient, login } from "./auth/google-auth.js";
+import { mkdir } from "node:fs/promises";
+import { APP_DIRECTORY, credentialsPath } from "./config.js";
+import { disconnectGoogleAccount, getAuthStatus, getAuthorizedClient, login } from "./auth/google-auth.js";
+import { installClient } from "./install/configure-client.js";
+import { APP_VERSION, PACKAGE_SPEC } from "./version.js";
 function printHelp() {
     console.log(`
 edu-workspace-mcp
 
 명령어:
   setup       초기 폴더와 MCP 설정 예시를 보여줍니다.
+  install     AI 클라이언트 전체 프로젝트 설정에 MCP를 등록합니다.
   login       Google OAuth 로그인 후 토큰을 안전한 로컬 경로에 저장합니다.
   doctor      OAuth 자격 증명·토큰 상태를 확인합니다.
-  disconnect  연결 해제 방법을 안내합니다.
+  disconnect  Google 권한을 철회하고 로컬 토큰을 삭제합니다.
   serve       stdio MCP 서버를 시작합니다. 명령이 없을 때의 기본 동작입니다.
+  version     설치된 버전을 표시합니다.
+
+설치 예시:
+  npx -y ${PACKAGE_SPEC} install codex
+  npx -y ${PACKAGE_SPEC} install claude --read
+  npx -y ${PACKAGE_SPEC} install claude-desktop --read
+  npx -y ${PACKAGE_SPEC} install cursor
+
+읽기 확장:
+  install과 login에 --read를 붙이면 기존 Docs·Sheets·Slides·Forms와
+  Classroom 학생 명단을 읽을 수 있는 읽기 전용 범위를 요청합니다.
 `);
 }
 async function main() {
@@ -25,33 +39,60 @@ async function main() {
         const status = await getAuthStatus();
         console.log(`\n설정 폴더: ${APP_DIRECTORY}`);
         console.log(`OAuth 클라이언트: ${status.oauthClientConfigured ? `${status.oauthClientSource} 설정 사용` : "아직 구성되지 않음"}`);
-        console.log(`\nCodex/ChatGPT Desktop 예시:\n[mcp_servers.edu_workspace]\ncommand = "npx"\nargs = ["-y", "edu-workspace-mcp"]`);
-        console.log(`\nClaude Desktop/Cursor 예시:\n{\n  "mcpServers": {\n    "edu-workspace": {\n      "command": "npx",\n      "args": ["-y", "edu-workspace-mcp"]\n    }\n  }\n}`);
+        console.log(`\n권장 자동 설치:\n  npx -y ${PACKAGE_SPEC} install codex --read\n  npx -y ${PACKAGE_SPEC} install claude --read\n  npx -y ${PACKAGE_SPEC} install claude-desktop --read\n  npx -y ${PACKAGE_SPEC} install cursor --read`);
+        console.log(`\nCodex/ChatGPT Desktop 예시:\n[mcp_servers.edu-workspace]\ncommand = "npx"\nargs = ["-y", "${PACKAGE_SPEC}"]`);
+        console.log(`\nClaude Desktop/Cursor 예시:\n{\n  "mcpServers": {\n    "edu-workspace": {\n      "command": "npx",\n      "args": ["-y", "${PACKAGE_SPEC}"]\n    }\n  }\n}`);
         console.log(status.oauthClientConfigured
-            ? "\n`npx edu-workspace-mcp login`으로 Google 계정을 연결하세요."
+            ? `\n\`npx -y ${PACKAGE_SPEC} login\`으로 Google 계정을 연결하세요.`
             : `\n공개 배포 전에는 배포자가 공용 OAuth 앱을 설정해야 합니다. 개발 중에는 ${credentialsPath()}에 credentials.json을 둘 수 있습니다.`);
         return;
     }
+    if (command === "install") {
+        const client = process.argv[3];
+        if (!client || !["codex", "claude", "claude-desktop", "cursor"].includes(client)) {
+            throw new Error("설치 대상을 지정하세요: codex, claude, claude-desktop, cursor");
+        }
+        const readAccess = process.argv.includes("--read");
+        console.log(await installClient(client, { readAccess }));
+        console.log(`다음 단계: npx -y ${PACKAGE_SPEC} login${readAccess ? " --read" : ""}`);
+        return;
+    }
     if (command === "login") {
+        if (process.argv.includes("--read"))
+            process.env.EDU_WORKSPACE_READ_ACCESS = "1";
         const status = await login();
         console.log(status.message);
         console.log(`토큰 저장 위치: ${status.tokenPath}`);
         return;
     }
     if (command === "doctor") {
+        if (process.argv.includes("--read"))
+            process.env.EDU_WORKSPACE_READ_ACCESS = "1";
         const status = await getAuthStatus();
-        console.log(JSON.stringify(status, null, 2));
+        console.log(JSON.stringify({ version: APP_VERSION, node: process.version, ...status }, null, 2));
+        if (Number(process.versions.node.split(".")[0]) < 20)
+            throw new Error("Node.js 20 이상이 필요합니다.");
         if (status.authenticated) {
             const client = await getAuthorizedClient();
             await client.getAccessToken();
             console.log("Google OAuth 토큰 갱신: 정상");
+            if (status.missingScopes?.length)
+                throw new Error("필수 OAuth 범위가 누락되었습니다. disconnect 후 다시 로그인하세요.");
+            if (status.unexpectedScopes?.length)
+                console.warn("경고: 이전의 추가 OAuth 권한이 남아 있습니다. 최소 권한 재로그인을 권장합니다.");
+            if (status.tokenFileProtected === false)
+                throw new Error("OAuth 토큰 파일 권한이 안전하지 않습니다.");
         }
         return;
     }
+    if (command === "version" || command === "--version" || command === "-v") {
+        console.log(APP_VERSION);
+        return;
+    }
     if (command === "disconnect") {
-        await rm(tokenPath(), { force: true });
-        console.log(`로컬 Google 토큰을 제거했습니다: ${tokenPath()}`);
-        console.log("Google 계정의 제3자 앱 액세스 페이지에서도 이 앱의 권한을 철회할 수 있습니다.");
+        const localOnly = process.argv.includes("--local-only");
+        const result = await disconnectGoogleAccount({ localOnly });
+        console.log(`${result.revoked ? "Google OAuth 권한을 철회하고 " : ""}로컬 토큰을 제거했습니다: ${result.tokenPath}`);
         return;
     }
     printHelp();

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}