aiakiv 0.3.1 → 0.3.2

package/README.md

@@ -6,7 +6,7 @@ Gemini CLI 와 Antigravity 는 전역 설치도 합니다. 설계는 K2G `docs/2
 ```
 npx aiakiv bind   --client codex|claude|gemini|cursor --project <이름> [--dir <폴더>] [--expires-days N] [--no-browser] [--no-skills]
 npx aiakiv setup  --client gemini|antigravity[,...] [--expires-days N] [--no-browser] [--no-skills] [--new-key]
-npx aiakiv doctor [--client <클라이언트>[,...]] [--dir <폴더>] [--out aiakiv-verification-test.md] [--no-probe]
+npx aiakiv doctor [--client <클라이언트>[,...]] [--dir <폴더>] [--out aiakiv-verification-test.md] [--no-probe] [--allow-url <주소>]
 npx aiakiv local export <팀> --to <파일|폴더> [--domain <이름>] [--yes] [--container <이름>]
 npx aiakiv local import <파일|폴더> --team <팀> [--as <사용자>] [--domain <이름>] [--dry-run] [--resume] [--yes] [--container <이름>]
 npx aiakiv enterprise precheck [--config <toml>] [--image <참조> | --image-tar <파일>] [--device] [--no-browser] [--no-login]
@@ -40,23 +40,27 @@ bind 는 웹 콘솔의 "폴더 ZIP 받기" 와 같은 한 벌을 그 폴더에
 
 ### 폴더 스킬
 
-- 스킬 일곱 개(`aiakiv-onboarding`, `aiakiv-save-and-recall`, `aiakiv-graph-query`, `aiakiv-links`, `aiakiv-cards`,
-  `aiakiv-console`, `aiakiv-contents`)를 공개 저장소 [AiAkiv/aiakiv-plugins](https://github.com/AiAkiv/aiakiv-plugins)
-  에서 받습니다. 받는 주소는 `https://codeload.github.com/AiAkiv/aiakiv-plugins/tar.gz/refs/heads/main` 이고,
-  압축 파일 안의 플러그인 매니페스트(`aiakiv/.claude-plugin/plugin.json`)가 가리키는 `skills/` 아래만 꺼냅니다.
-  각 스킬 폴더의 참고 파일도 모두 복사하고, 판 번호는 그 매니페스트에서 읽어 화면에 냅니다
-  (예: `폴더 스킬 7개: .agents/skills (판 0.4.24)`).
+- 스킬 여덟 개(`aiakiv-onboarding`, `aiakiv-save-and-recall`, `aiakiv-graph-query`, `aiakiv-links`, `aiakiv-cards`,
+  `aiakiv-console`, `aiakiv-contents`, `aiakiv-dashboard`)는 이 CLI 의 npm 묶음 안 `skills/` 에 들어 있습니다.
+  bind 와 setup 은 그것을 쓰고, 네트워크에서 스킬을 받지 않습니다. 받는 곳은 npm 하나이고, 묶음이 바뀌지 않았는지는
+  npm 이 확인합니다(2026-11-10 결정. 0.3.1 까지는 GitHub 저장소 `AiAkiv/aiakiv-plugins` 의 main 가지를 그때그때
+  받았습니다).
+- `skills/bundle.json` 에 파일마다 경로, 크기, sha256 과 스킬 버전(플러그인 매니페스트의 version)이 적혀 있습니다.
+  CLI 는 이 목록에 적힌 파일만 쓰고, 크기나 sha256 이 다르거나, 이름이 아래 여덟 개 밖이거나, 경로가 안전하지 않으면
+  하나도 쓰지 않습니다. 화면에는 스킬 버전을 냅니다(예: `폴더 스킬 8개: .agents/skills (이 CLI 에 든 스킬, 스킬 버전 0.4.40)`).
+  `doctor` 도 이 CLI 에 든 스킬의 버전을 적습니다.
 - 자리는 콘솔 ZIP 과 같습니다. Claude Code 는 `.claude/skills`, Codex 와 Gemini CLI 는 `.agents/skills` 한 벌입니다
   (둘이 같은 자리를 읽어 두 벌 두면 Codex 에서 겹쳐 보입니다).
 - Cursor 도 `.agents/skills` 에 넣습니다. Cursor 문서(cursor.com/docs/context/skills)가 이 자리를 프로젝트 스킬
   자리로 적고 있고, Skills CLI 의 cursor 설정도 같은 자리입니다(2026-10-14 확인). 콘솔 ZIP 에는 Cursor 가 없습니다.
 - 같은 이름의 스킬 폴더는 통째로 바꾸고(그 안의 예전 파일은 사라집니다), 그 밖의 파일과 다른 스킬은 건드리지 않습니다.
   같은 이름 자리가 심볼릭 링크나 정션이면 링크만 지우고 가리키던 곳은 그대로 둡니다.
-- 압축 파일 안에 절대 경로나 `..` 가 든 경로가 하나라도 있거나, 스킬 자리 안에 심볼릭 링크, 하드 링크, Windows 에서
-  쓸 수 없는 이름이 있으면 스킬을 하나도 쓰지 않습니다.
-- 받기에 실패해도 bind 는 멈추지 않습니다(연결 설정은 이미 썼고 종료 코드는 0). 대신 그 폴더에서 칠 명령을 보여 줍니다:
-  `npx -y skills add AiAkiv/aiakiv-plugins -a <claude-code|codex|gemini-cli|cursor> -s '*' -y`
-  (`--all` 과 `-g` 는 쓰지 않습니다. `--all` 은 모든 에이전트 폴더에 퍼지고, `-g` 는 전역에 넣습니다).
+- 쓰는 스킬은 CLI 에 적힌 여덟 이름(`src/skills.ts` 의 `SKILL_NAMES`)뿐입니다. 사용자가 손으로 만든 다른 이름의
+  스킬 폴더는 건드리지 않습니다(2026-11-10 보안 점검 낮음 6). setup 의 전역 스킬도 같습니다.
+- 스킬을 쓰지 못해도 bind 는 멈추지 않습니다(연결 설정은 이미 썼고 종료 코드는 0). 대신 그 폴더에서 손으로 칠 명령을
+  보여 줍니다: `npx -y skills add AiAkiv/aiakiv-plugins -a <claude-code|codex|gemini-cli|cursor> -s '*' -y`
+  (`--all` 과 `-g` 는 쓰지 않습니다. `--all` 은 모든 에이전트 폴더에 퍼지고, `-g` 는 전역에 넣습니다). 이 명령은
+  Skills CLI 가 GitHub 저장소에서 받으므로, 사람이 직접 고를 때만 씁니다.
 - `--no-skills` 면 스킬만 건너뜁니다. 연결 설정, `.claude/settings.json`, `.gitignore` 는 그대로 씁니다.
 
 ### Claude 의 enabledMcpjsonServers
@@ -71,6 +75,11 @@ Codex 와 Gemini 는 설정 파일에 키가 들어갑니다. 그 폴더가 git
 `/.codex/config.toml`, `/.gemini/settings.json` 줄을 그 폴더의 `.gitignore` 에 더합니다(이미 무시되면 더하지 않습니다).
 둘 다 아니면 더하지 않고 경고만 합니다.
 
+`.gemini/settings.json` 에 주석이나 끝 쉼표가 있어 다시 쓰면서 원본을 `.gemini/settings.json.aiakiv-backup` 으로
+남겼을 때는, 그 사본에도 예전 키가 있을 수 있으므로 `/.gemini/settings.json.aiakiv-backup` 줄도 같은 규칙으로 더합니다
+(2026-11-10 보안 점검 낮음 7). 더할 수 없으면 사본에 대해서도 따로 경고합니다. 이 줄을 더하지 않으려면
+`AIAKIV_GITIGNORE_BACKUP=0` 을 줍니다. macOS 와 Linux 에서는 이 사본도 키 파일처럼 주인만 읽게(0600) 둡니다.
+
 ### 연결 설정의 모양
 
 | 클라이언트 | 설정 파일(폴더 기준) | 인증 | 쓰는 내용 |
@@ -140,8 +149,8 @@ CLI 는 폐기된 개수와 키 id 를 알립니다. 그래서 쓸 수 있는
 - MCP 주소는 `AIAKIV_MCP_URL`(기본 `https://mcp.aiakiv.com/mcp`, 물음표 표시 없는 주소)입니다.
 - 서버 이름은 전역이라 `AiAkiv` 입니다. 폴더의 `AiAkiv-<프로젝트>` 와 겹치지 않습니다.
 - Antigravity 는 `serverUrl` 만 받습니다(`url`, `httpUrl`, `type` 은 거부합니다). 파일이 없으면 폴더째 만듭니다.
-- 전역 스킬은 폴더 스킬과 같은 묶음을 한 번 받아 자리마다 씁니다. 같은 이름 스킬 폴더는 통째로 바꾸고 나머지는 둡니다.
-  받기에 실패해도 설정 쓰기는 성공으로 두고, Gemini CLI 는 `npx -y skills add AiAkiv/aiakiv-plugins -a gemini-cli -s '*' -g -y`
+- 전역 스킬은 폴더 스킬과 같은 묶음(이 CLI 에 든 것)을 자리마다 씁니다. 같은 이름 스킬 폴더는 통째로 바꾸고 나머지는 둡니다.
+  쓰기에 실패해도 설정 쓰기는 성공으로 두고, Gemini CLI 는 `npx -y skills add AiAkiv/aiakiv-plugins -a gemini-cli -s '*' -g -y`
   를, Antigravity 는 스킬 폴더를 직접 복사하라고 안내합니다(Skills CLI 의 antigravity 전역 자리는 `~/.gemini/antigravity/skills`
   라 setup 의 자리와 다릅니다. `~/.gemini/antigravity-cli/skills` 는 `-a antigravity-cli` 로 안내합니다).
 - `get_save_target` 은 키 id 를 돌려주지 않으므로, 새로 받을 때 키 id 와 키의 지문(sha256 앞 16자, 평문 아님)을
@@ -167,14 +176,24 @@ CLI 는 폐기된 개수와 키 id 를 알립니다. 그래서 쓸 수 있는
 - 스킬 위치(`~/.claude/skills`, `~/.claude/plugins/cache/aiakiv/aiakiv/*/skills`, `~/.agents/skills`,
   `~/.cursor/skills`, `~/.gemini/skills`, `~/.gemini/config/skills`, `~/.gemini/antigravity-cli/skills`,
   `$CODEX_HOME/skills`, 폴더의 `.claude/skills`, `.agents/skills`)를 봅니다.
-- bind 가 넣는 폴더 스킬 자리(`.claude/skills`, `.agents/skills`)에 일곱 개가 다 있는지 적습니다. 그 자리를 읽는
+- 이 CLI 에 든 스킬의 개수와 스킬 버전을 적습니다(`skills/bundle.json` 과 파일이 맞지 않으면 그 까닭).
+- bind 가 넣는 폴더 스킬 자리(`.claude/skills`, `.agents/skills`)에 여덟 개가 다 있는지 적습니다. 그 자리를 읽는
   클라이언트가 이 폴더에 고정돼 있는데 빠진 스킬이 있으면 다음 단계에 bind 를 다시 하거나 칠 명령을 적습니다.
 - 폴더 `.mcp.json` 의 AiAkiv 항목마다 `.claude/settings.json`(또는 `.claude/settings.local.json`)의
   `enabledMcpjsonServers` 에 그 이름이 있는지 적습니다.
 - 키로 묶인 항목은 MCP `get_save_target` 을 직접 불러 팀, 프로젝트, binding 을 적습니다
   (`initialize`, `notifications/initialized`, `tools/call` 순서, 프로토콜 판 `2025-06-18`, 응답이 SSE 여도 읽음).
   `--no-probe` 면 부르지 않습니다. OAuth 항목은 "클라이언트 안에서 get_save_target 을 부르라" 는 다음 단계를 적습니다.
+- 폴더의 설정 파일은 남이 준 것일 수 있습니다(받은 저장소). 그래서 폴더 파일의 키는 주소의 방식, 호스트, 포트가
+  기본 MCP 주소(`https://mcp.aiakiv.com`)나 `AIAKIV_MCP_URL`, 명령 줄의 `--allow-url <주소>`(여러 번 줄 수 있음)와
+  같을 때만 보냅니다. 폴더 파일의 `bearer_token_env_var` 는 `AIAKIV_API_KEY` 일 때만 읽습니다. 그 밖이면 보내지도
+  읽지도 않고, 어느 파일의 어느 주소나 이름을 왜 건너뛰었는지 적습니다. 홈의 전역 파일은 사용자 자신의 설정이라
+  그대로 봅니다. 서버가 다른 주소로 넘기면(redirect) 따라가지 않고 멈춥니다(같은 주소 안의 307, 308 만 따라감).
 - 결과는 `aiakiv-verification-test.md`(기본은 그 폴더)에 씁니다. 키로 묶인 연결이 실패하면 종료 코드 1 입니다.
+- 결과 파일과 화면은 문의에 그대로 붙여 넣어도 되는 모양으로 씁니다. 키와 토큰은 앞 8자만, 홈 폴더 경로는 `~` 로
+  (경로에 든 계정 이름이 빠집니다), 이메일은 앞 두 글자와 도메인만(`ra…@example.com`) 적습니다. 이메일은 개인 팀 이름에
+  들어 있을 수 있습니다. 계정 id(`get_save_target` 의 `account`)는 적지 않습니다. 가리지 않고 그대로 보려면
+  `AIAKIV_DOCTOR_UNMASKED=1` 을 줍니다(키는 그래도 앞 8자만 적습니다).
 
 ## local export, local import: 자체 설치판 팀 기억 내보내기와 받기
 
@@ -284,7 +303,9 @@ npx aiakiv enterprise precheck --config ./aiakiv-enterprise.toml
   (키 id 만, doctor 는 앞 8자 + `…`).
 - CLI 는 토큰이나 키를 자기 저장소에 두지 않습니다. `login` 명령이 없습니다. setup 이 남기는
   `~/.gemini/aiakiv-setup.json` 에는 키 id 와 지문만 있고 평문은 없습니다.
-- macOS, Linux 에서는 키가 든 설정 파일을 주인만 읽게(0600) 씁니다.
+- macOS, Linux 에서는 키가 든 설정 파일을 주인만 읽게(0600) 씁니다. Windows 는 이 권한을 쓰지 않아 적용되지 않습니다
+  (파일은 사용자 폴더의 기본 권한을 따릅니다). 권한 시험(`tests/fsutil.test.mjs`, `tests/bind.test.mjs` 의 사본 권한)도
+  Windows 에서는 건너뜁니다.
 - 키가 든 설정 파일은 git 저장소이거나 `.gitignore` 가 있는 폴더면 `.gitignore` 에 더하고, 아니면 경고합니다.
   **키가 든 파일을 저장소에 올리지 마세요.**
 
@@ -301,9 +322,10 @@ npx aiakiv enterprise precheck --config ./aiakiv-enterprise.toml
 |---|---|---|
 | `AIAKIV_MCP_URL` | `https://mcp.aiakiv.com/mcp` | MCP 주소. 끝의 `/mcp` 는 빼고 줘도 됩니다. |
 | `AIAKIV_CONTROL_URL` | `https://app.aiakiv.com` | 웹 콘솔 주소(인계 화면과 키 교환). |
-| `AIAKIV_SKILLS_TARBALL_URL` | `https://codeload.github.com/AiAkiv/aiakiv-plugins/tar.gz/refs/heads/main` | 폴더 스킬과 전역 스킬(setup)을 받는 tar.gz 주소(http 나 https). 시험은 로컬 서버로 바꿉니다. |
 | `AIAKIV_ENTERPRISE_MANIFEST_URL` | `https://www.aiakiv.com/download/enterprise/<판>/manifest.json` | `enterprise precheck` 가 이미지를 내려받을 때 읽는 목록 파일 주소(http 나 https). 시험은 로컬 서버로 바꿉니다. |
 | `CODEX_HOME` | `~/.codex` | Codex 설정 위치(플러그인 캐시, 스킬 확인에 씁니다). |
+| `AIAKIV_GITIGNORE_BACKUP` | (없음) | `0` 이면 키 파일의 원본 사본(`<파일>.aiakiv-backup`)을 `.gitignore` 에 더하지 않습니다. |
+| `AIAKIV_DOCTOR_UNMASKED` | (없음) | `1` 이면 doctor 가 홈 폴더 경로와 이메일을 가리지 않습니다. |
 
 ## 개발
 
@@ -314,9 +336,28 @@ npm test         # build 뒤 node --test (외부 시험 도구 없음)
 ```
 
 의존성은 TOML 파서 `smol-toml` 하나입니다. 인자 해석은 `node:util` 의 `parseArgs`, HTTP 는 내장 `http` 와 `fetch`,
-폴더 스킬의 tar.gz 는 내장 `zlib` 와 작은 tar 읽기(`src/tar.ts`, ustar 와 pax 긴 이름),
 브라우저 열기는 운영체제 명령(Windows `cmd /c start`, macOS `open`, Linux `xdg-open`)을 씁니다.
 
+### 스킬 옮겨 적기
+
+스킬의 정본은 K2G 저장소의 `packaging/plugins/aiakiv/skills/` 이고, 플러그인 저장소 `AiAkiv/aiakiv-plugins` 는 그것을
+게시한 것입니다. 이 저장소의 `skills/` 는 정본을 옮겨 적은 것이라 손으로 고치지 않습니다.
+
+```
+npm run build
+node scripts/sync-skills.mjs <K2G>/packaging/plugins           # 옮겨 적기
+node scripts/sync-skills.mjs <K2G>/packaging/plugins --check   # 같은지만 보기(다르면 종료 코드 1)
+AIAKIV_SKILLS_SOURCE=<K2G>/packaging/plugins npm test           # 시험에서도 정본과 같은지 보기
+```
+
+- 스크립트는 플러그인 버전 네 곳(Claude 와 Cursor 의 `plugin.json`, 두 `marketplace.json` 의 aiakiv 항목)이 같지
+  않거나, 정본의 스킬 폴더 이름이 `SKILL_NAMES` 와 다르거나, 스킬 폴더에 링크가 있으면 아무것도 쓰지 않고 멈춥니다.
+- 텍스트 파일은 CRLF 를 LF 로 바꿔 적습니다. 정본 저장소가 git 에 LF 로 두므로, Windows 에서 CRLF 로 풀린 폴더에서
+  돌려도 git 에 든 것과 같은 바이트가 됩니다.
+- 스킬이 바뀌면 순서는 이렇습니다. K2G 에서 스킬을 고치고 플러그인 버전 네 곳을 올립니다. 이 스크립트로 옮겨 적고
+  `npm test` 를 돌립니다. CLI 버전(`package.json`, `src/version.ts`)을 올려 npm 에 냅니다. 새 스킬을 더할 때는
+  `src/skills.ts` 의 `SKILL_NAMES` 에 먼저 이름을 넣습니다.
+
 ## 라이선스
 
 MIT

package/dist/bind.js

@@ -9,14 +9,15 @@
 //
 // 연결 설정 뒤에 웹 콘솔 "폴더 ZIP 받기" 와 같은 나머지를 더한다(정본 k2g-console-web
 // `src/lib/folderBundle.ts`):
-//   - 폴더 스킬(skills.ts). `--no-skills` 면 건너뛴다. 받기에 실패해도 bind 는 성공으로 끝난다.
+//   - 폴더 스킬(skills.ts, 이 CLI 의 npm 묶음에 든 것). `--no-skills` 면 건너뛴다. 쓰기에 실패해도 bind 는
+//     성공으로 끝난다.
 //   - claude: `.claude/settings.json` 의 enabledMcpjsonServers 에 서버 이름(폴더를 신뢰한 뒤 묻지 않고 켠다).
 //   - codex, gemini: 키가 든 설정 파일을 `.gitignore` 에 더한다(git 저장소이거나 `.gitignore` 가 있을 때).
 // ZIP 의 README.md 는 쓰지 않는다(안내는 화면에 낸다).
 import { appendFileSync, existsSync, readFileSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { CLAUDE_FOLDER_SETTINGS, FOLDER_CONFIG } from "./clients/types.js";
-import { addToJsonArray, jsonServers, readJsonObject, upsertJsonServer } from "./config/json.js";
+import { addToJsonArray, BACKUP_SUFFIX, jsonServers, readJsonObject, upsertJsonServer } from "./config/json.js";
 import { upsertCodexServer } from "./config/toml.js";
 import { exchangeCode, handoffUrl, HANDOFF_TIMEOUT_MS, newState, oldKeysKeptNotice, scopeList, startLoopback, supersededNotice, } from "./handoff.js";
 import { installFolderSkills } from "./skills.js";
@@ -169,6 +170,8 @@ export async function ensureGitIgnored(ctx, dir, rel, line = `/${rel}`) {
     appendFileSync(gi, `${lead}${line}${eol}`, "utf8");
     return "added";
 }
+/** 키 파일의 원본 사본(`<파일>.aiakiv-backup`)을 .gitignore 에 더하는 것을 끄는 환경 변수. 값이 `0` 일 때만 끈다. */
+export const BACKUP_GITIGNORE_ENV = "AIAKIV_GITIGNORE_BACKUP";
 function safeMcpUrl(ctx, given) {
     if (typeof given === "string") {
         try {
@@ -268,6 +271,22 @@ async function bindKey(ctx, client, project, dir, opts) {
     if (ignore === "warn") {
         ctx.err(`주의: ${rel} 이 .gitignore 에 없습니다. 키가 든 파일이니 저장소에 올리지 마세요(.gitignore 에 /${rel} 을 더하세요).`);
     }
+    // 원본 사본에도 예전 키가 있을 수 있다(2026-11-10 보안 점검 낮음 7). 원래 파일과 같이 .gitignore 에 더한다.
+    if (backup && (ctx.env[BACKUP_GITIGNORE_ENV] ?? "").trim() !== "0") {
+        const backupRel = `${rel}${BACKUP_SUFFIX}`;
+        let b;
+        try {
+            b = await ensureGitIgnored(ctx, dir, backupRel);
+        }
+        catch (e) {
+            ctx.err(`.gitignore 를 고치지 못했습니다(${e.message}).`);
+            b = "warn";
+        }
+        if (b === "added")
+            ctx.out(`더했습니다: ${join(dir, ".gitignore")} 에 /${backupRel}`);
+        if (b === "warn")
+            ctx.err(`주의: ${backupRel} 이 .gitignore 에 없습니다. 예전 키가 든 사본이니 확인한 뒤 지우세요.`);
+    }
     if (opts.skills !== false)
         await installFolderSkills(ctx, client, dir);
     else

package/dist/config/json.js

@@ -5,11 +5,16 @@
 // 클라이언트가 JSONC(주석, 끝 쉼표)를 받아 주는 파일이 실제로 있다(이 PC 의 ~/.cursor/mcp.json 에
 // 끝 쉼표가 있었다, 2026-10-14). 그래서 읽기는 JSONC 까지 받아 주고, 그런 파일을 다시 쓸 때는
 // 주석과 끝 쉼표가 사라지므로 원본을 `<파일>.aiakiv-backup` 으로 남기고 알린다.
-import { copyFileSync } from "node:fs";
+import { chmodSync, copyFileSync } from "node:fs";
 import { readTextIfExists, writeFileAtomic } from "../fsutil.js";
 const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 export class ConfigError extends Error {
 }
+/** 주석이나 끝 쉼표가 있던 원본을 다시 쓰기 전에 남기는 사본의 이름 끝. */
+export const BACKUP_SUFFIX = ".aiakiv-backup";
+export function backupPath(file) {
+    return `${file}${BACKUP_SUFFIX}`;
+}
 // 문자열 끝 찾기(백슬래시 이스케이프를 건너뛴다). 닫는 따옴표의 위치를 돌려준다.
 function stringEnd(s, start) {
     let j = start + 1;
@@ -114,8 +119,11 @@ export function upsertJsonServer(file, name, entry, opts = {}) {
     doc.mcpServers = servers;
     let backup;
     if (read?.lossy) {
-        backup = `${file}.aiakiv-backup`;
+        backup = backupPath(file);
         copyFileSync(file, backup);
+        // 원본에 예전 키가 있을 수 있다. 키 파일과 같이 주인만 읽게 둔다(POSIX). copyFileSync 는 원본의 권한을 따른다.
+        if (opts.secret && process.platform !== "win32")
+            chmodSync(backup, 0o600);
     }
     writeFileAtomic(file, `${JSON.stringify(doc, null, 2)}\n`, opts);
     return { createdFile: read === null, replaced, ...(backup ? { backup } : {}) };
@@ -143,7 +151,7 @@ export function addToJsonArray(file, key, value) {
     doc[key] = [...(cur ?? []), value];
     let backup;
     if (read?.lossy) {
-        backup = `${file}.aiakiv-backup`;
+        backup = backupPath(file);
         copyFileSync(file, backup);
     }
     writeFileAtomic(file, `${JSON.stringify(doc, null, 2)}\n`);

package/dist/doctor.js

@@ -7,6 +7,13 @@
 //
 // 키와 토큰 평문은 화면에도 파일에도 쓰지 않는다(앞 8자 + …). 클라이언트 목록은 다른 서비스의
 // 주소(키가 든 주소가 있을 수 있다)를 옮기지 않도록 AiAkiv 항목만 고른다.
+//
+// 폴더의 설정 파일은 남이 준 것일 수 있다(받은 저장소). 그래서 폴더 파일이 고른 것은 그대로 믿지 않는다.
+// - 키를 실어 보내는 주소는 AiAkiv 의 알려진 주소(기본 MCP 주소, AIAKIV_MCP_URL)와 명령 줄의 --allow-url 과
+//   출처(방식, 호스트, 포트)가 같을 때만 쓴다. 홈의 전역 파일(setup 이 쓰는 곳)은 사용자 자신의 설정이라 그대로 본다.
+// - bearer_token_env_var 는 CLI 가 AiAkiv 키 이름으로 정한 환경 변수(KEY_ENV_VARS)만 읽는다.
+// 다른 것은 보내지도 읽지도 않고, 어느 파일의 무엇을 왜 건너뛰었는지 적는다(2026-11-10 보안 점검 중간 2).
+// .aiakiv/console.json 의 control_url 을 믿지 않는 것(consoleKeyFile.ts)과 같은 원칙이다.
 import { existsSync, readdirSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { classifyClaudeName, CLAUDE_KIND_LABEL, findClaude, installedPluginIds, parseClaudeMcpList, } from "./clients/claude.js";
@@ -19,8 +26,8 @@ import { readTomlObject, tomlServers } from "./config/toml.js";
 import { CONSOLE_KEY_FILE, expiryText, LEGACY_KEY_FILE_MESSAGE, readConsoleKeyFile } from "./consoleKeyFile.js";
 import { probeSaveTarget } from "./mcpProbe.js";
 import { failReason } from "./proc.js";
-import { FOLDER_SKILLS_DIR, SKILL_NAMES, SKILLS_AGENT, skillsManualCommand } from "./skills.js";
-import { controlBase, mcpBase } from "./urls.js";
+import { bundledSkillsLine, FOLDER_SKILLS_DIR, SKILL_NAMES, SKILLS_AGENT, skillsManualCommand } from "./skills.js";
+import { controlBase, DEFAULT_MCP_URL, mcpBase } from "./urls.js";
 import { VERSION } from "./version.js";
 export const DEFAULT_REPORT = "aiakiv-verification-test.md";
 export const DOCTOR_CLIENT_IDS = [...CLIENT_IDS, "antigravity"];
@@ -32,10 +39,83 @@ export function isFolderClient(c) {
 function isSetupClient(c) {
     return GLOBAL_CLIENT_IDS.includes(c);
 }
+/** 폴더 설정 파일의 bearer_token_env_var 로 읽어도 되는 환경 변수. CLI 가 AiAkiv 키 이름으로 정한 것뿐이다
+ * (도움말의 "환경 변수" 단락). 다른 이름은 다른 서비스의 키일 수 있어 읽지 않는다. */
+export const KEY_ENV_VARS = ["AIAKIV_API_KEY"];
+/** 키를 보내도 되는 주소의 출처(`https://host[:port]`). 주소가 아니거나, http, https 가 아니거나,
+ * 사용자 정보(`user:pass@`)가 들었으면 null. 글자 앞부분이 아니라 풀어 낸 방식, 호스트, 포트로 비교하려고 쓴다. */
+export function keyOrigin(raw) {
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        return null;
+    }
+    if (u.protocol !== "https:" && u.protocol !== "http:")
+        return null;
+    if (u.username || u.password)
+        return null;
+    return u.origin;
+}
+/** 폴더 파일의 키를 보내도 되는 출처: 기본 MCP 주소, AIAKIV_MCP_URL, 명령 줄의 --allow-url. */
+export function allowedKeyOrigins(env, allowUrls = []) {
+    const out = [];
+    for (const u of [DEFAULT_MCP_URL, `${mcpBase(env)}/mcp`, ...allowUrls]) {
+        const o = keyOrigin(u);
+        if (o && !out.includes(o))
+            out.push(o);
+    }
+    return out;
+}
+/** 이 항목의 키를 보내지 않을 까닭(보내도 되면 null). 전역 파일은 사용자 자신의 설정이라 보지 않는다. */
+export function keySendRefusal(e, allowed) {
+    if (e.scope !== "폴더")
+        return null;
+    if (e.envRefused)
+        return e.envRefused;
+    const origin = keyOrigin(e.url);
+    if (origin && allowed.includes(origin))
+        return null;
+    let why;
+    try {
+        const u = new URL(e.url);
+        why = u.username || u.password
+            ? "주소에 사용자 정보(…@)가 들어 있어"
+            : u.protocol !== "https:" && u.protocol !== "http:"
+                ? "http, https 주소가 아니라"
+                : `AiAkiv 주소(${allowed.join(", ")})가 아니라`;
+    }
+    catch {
+        why = "주소로 읽을 수 없어";
+    }
+    // 사용자 정보에는 비밀번호가 들 수 있어 가리고 적는다.
+    const shown = maskUrl(e.url.replace(/^([^:/?#]+:\/\/)[^/?#]*@/, "$1…@")) || "(비어 있음)";
+    return (`${e.file} 의 주소 ${shown} 는 ${why} 키를 보내지 않았습니다. 남이 준 폴더라면 이 설정 파일부터 확인하세요.` +
+        (origin ? ` 내 서버가 맞다면 npx aiakiv doctor --allow-url ${origin} 로 다시 확인하세요.` : ""));
+}
 /** 키 가리기: 앞 8자 + …(짧으면 전부 가린다). */
 export function maskSecret(v) {
     return v.length > 12 ? `${v.slice(0, 8)}…` : "…";
 }
+/** 가리기를 끄는 환경 변수. 값이 `1` 일 때만 끈다(예전처럼 홈 폴더 경로와 이메일을 그대로 적는다). */
+export const DOCTOR_UNMASKED_ENV = "AIAKIV_DOCTOR_UNMASKED";
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** 결과 파일과 화면에서 사람을 알아볼 수 있는 값을 가린다. 사용자가 이 기록을 문의에 붙여 넣으므로
+ * 붙여 넣어도 되는 모양으로 만든다(2026-11-10 보안 점검 후속).
+ * - 홈 폴더 경로는 `~`(경로에 든 계정 이름이 빠진다). 홈이 드라이브나 `/` 그 자체면 건드리지 않는다.
+ * - 이메일은 앞 두 글자와 도메인만(`ra…@example.com`). 개인 팀 이름이 `<이름> personal` 이라 이메일이 들 수 있다.
+ * 키와 토큰은 따로 앞 8자만 적는다(maskSecret). */
+export function maskPersonal(text, home, platform = process.platform) {
+    let out = text;
+    const h = (home ?? "").replace(/[\\/]+$/, "");
+    if (h && !/^[A-Za-z]:$/.test(h)) {
+        const forms = [...new Set([h, h.replace(/\\/g, "/"), h.replace(/\//g, "\\")])].sort((a, b) => b.length - a.length);
+        const re = new RegExp(`(?<![\\w.-])(?:${forms.map(escapeRe).join("|")})(?![\\w.-])`, platform === "win32" ? "gi" : "g");
+        out = out.replace(re, "~");
+    }
+    return out.replace(/([A-Za-z0-9._%+-]+)@([A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,})/g, (_m, local, domain) => `${local.slice(0, 2)}…@${domain}`);
+}
 /** 주소의 키처럼 보이는 쿼리 값을 가린다. */
 export function maskUrl(url) {
     return url.replace(/([?&][^=&#]*(?:key|token|secret|auth)[^=&#]*=)([^&#]*)/gi, (_m, k) => `${k}…`);
@@ -60,7 +140,18 @@ export function classifyEntry(base, raw, env) {
     if (bearer)
         return { ...base, url, auth: "apikey", key: bearer, keyMasked: maskSecret(bearer) };
     if (typeof raw.bearer_token_env_var === "string") {
-        const v = env[raw.bearer_token_env_var];
+        const name = raw.bearer_token_env_var;
+        if (base.scope === "폴더" && !KEY_ENV_VARS.includes(name)) {
+            return {
+                ...base,
+                url,
+                auth: "apikey-env",
+                envVar: name,
+                envRefused: `${base.file} 이 고른 환경 변수 ${name} 은 AiAkiv 키 이름(${KEY_ENV_VARS.join(", ")})이 아니라 읽지 않았습니다. ` +
+                    "남이 준 폴더라면 이 설정 파일부터 확인하세요.",
+            };
+        }
+        const v = env[name];
         return {
             ...base,
             url,
@@ -306,6 +397,8 @@ function howLabel(e) {
     if (e.auth === "apikey")
         return `${AUTH_LABEL[e.auth]} ${e.keyMasked}`;
     if (e.auth === "apikey-env") {
+        if (e.envRefused)
+            return `${AUTH_LABEL[e.auth]} ${e.envVar} (읽지 않음)`;
         return `${AUTH_LABEL[e.auth]} ${e.envVar}${e.keyMasked ? ` = ${e.keyMasked}` : " (비어 있음)"}`;
     }
     if (e.auth === "oauth-folder")
@@ -322,10 +415,14 @@ export async function runDoctor(ctx, opts) {
     const outFile = opts.out ? resolve(ctx.cwd, opts.out) : join(dir, DEFAULT_REPORT);
     const scan = scanConfigs(ctx, dir, clients);
     const probes = new Map();
+    const allowed = allowedKeyOrigins(ctx.env, opts.allowUrls);
     for (const e of scan.entries) {
         if (e.auth !== "apikey" && e.auth !== "apikey-env")
             continue;
-        if (!e.key)
+        const refused = keySendRefusal(e, allowed);
+        if (refused)
+            probes.set(e, refused);
+        else if (!e.key)
             probes.set(e, `환경 변수 ${e.envVar} 가 비어 있어 부르지 않았습니다`);
         else if (opts.noProbe)
             probes.set(e, "--no-probe 라 부르지 않았습니다");
@@ -337,13 +434,21 @@ export async function runDoctor(ctx, opts) {
     const folderSkills = folderSkillChecks(dir, clients);
     const enabled = claudeEnabledChecks(dir, scan.entries);
     const consoleKey = consoleKeyLine(dir);
+    const bundled = bundledSkillsLine();
+    const unmasked = (ctx.env[DOCTOR_UNMASKED_ENV] ?? "").trim() === "1";
+    const mask = (s) => (unmasked ? s : maskPersonal(s, ctx.home));
     const md = [];
     md.push("# AiAkiv 확인 기록", "");
     md.push(`- 일시: ${new Date().toISOString()}`);
     md.push(`- 폴더: ${dir}`);
     md.push(`- 확인한 클라이언트: ${clients.join(", ")}`);
     md.push(`- aiakiv CLI ${VERSION}, MCP 기준 주소 ${mcpBase(ctx.env)}/mcp, 웹 콘솔 ${controlBase(ctx.env)}`);
-    md.push("- 키와 토큰은 앞 8자만 적었습니다.", "");
+    md.push(`- ${bundled}(bind 와 setup 이 쓰는 스킬)`);
+    md.push(`- 폴더 설정 파일의 키를 보내는 주소: ${allowed.join(", ")}(그 밖의 주소에는 보내지 않습니다)`);
+    md.push("- 키와 토큰은 앞 8자만 적었습니다.");
+    if (!unmasked)
+        md.push("- 홈 폴더는 ~ 로, 이메일은 앞 두 글자와 도메인만 적었습니다. 문의에 그대로 붙여 넣어도 됩니다.");
+    md.push("");
     md.push("## 설정 파일의 AiAkiv 연결", "");
     if (scan.entries.length) {
         md.push("| 범위 | 클라이언트 | 파일 | 서버 이름 | 주소 | 인증 방식 |", "|---|---|---|---|---|---|");
@@ -469,37 +574,39 @@ export async function runDoctor(ctx, opts) {
     md.push("");
     let wrote = true;
     try {
-        writeFileSync(outFile, md.join("\n"), "utf8");
+        writeFileSync(outFile, mask(md.join("\n")), "utf8");
     }
     catch (e) {
         wrote = false;
-        ctx.err(`결과 파일을 쓰지 못했습니다(${e.message}).`);
+        ctx.err(mask(`결과 파일을 쓰지 못했습니다(${e.message}).`));
     }
-    // 화면 요약.
-    ctx.out(`AiAkiv 확인: ${dir}`);
+    // 화면 요약. 결과 파일과 같이 가린다(화면을 복사해 붙여 넣는 사람도 있다).
+    const say = (s) => ctx.out(mask(s));
+    say(`AiAkiv 확인: ${dir}`);
     if (!scan.entries.length)
-        ctx.out("  설정 파일에 AiAkiv 연결 없음");
+        say("  설정 파일에 AiAkiv 연결 없음");
     for (const e of scan.entries) {
         const p = probes.get(e);
         const tail = p === undefined ? "" : `, 확인 결과 ${typeof p === "string" ? p : probeLine(p, e)}`;
-        ctx.out(`  [${e.scope} ${e.client}] ${e.name}: ${howLabel(e)}${tail}`);
+        say(`  [${e.scope} ${e.client}] ${e.name}: ${howLabel(e)}${tail}`);
     }
     for (const n of scan.notes)
-        ctx.out(`  ${n}`);
+        say(`  ${n}`);
     for (const s of lists)
-        ctx.out(`  ${s.title}: ${s.lines.join(" / ")}`);
-    ctx.out(`  스킬: ${skills.length ? skills.map((s) => `${s.root}(${s.names.length})`).join(", ") : "찾지 못함"}`);
+        say(`  ${s.title}: ${s.lines.join(" / ")}`);
+    say(`  스킬: ${skills.length ? skills.map((s) => `${s.root}(${s.names.length})`).join(", ") : "찾지 못함"}`);
     if (folderSkills.length)
-        ctx.out(`  폴더 스킬: ${folderSkills.map((s) => `${s.rel} ${skillState(s)}`).join(", ")}`);
+        say(`  폴더 스킬: ${folderSkills.map((s) => `${s.rel} ${skillState(s)}`).join(", ")}`);
+    say(`  ${bundled}`);
     if (consoleKey)
-        ctx.out(`  ${consoleKey}`);
+        say(`  ${consoleKey}`);
     for (const c of enabled.checks) {
-        ctx.out(`  enabledMcpjsonServers ${c.name}: ${c.in.length ? c.in.join(", ") : "없음"}`);
+        say(`  enabledMcpjsonServers ${c.name}: ${c.in.length ? c.in.join(", ") : "없음"}`);
     }
     for (const n of next)
-        ctx.out(`  다음: ${n}`);
+        say(`  다음: ${n}`);
     if (wrote)
-        ctx.out(`결과 파일: ${outFile}`);
+        say(`결과 파일: ${outFile}`);
     const failed = [...probes.values()].some((p) => typeof p !== "string" && !p.ok);
     return failed || !wrote ? 1 : 0;
 }

package/dist/main.js

@@ -5,13 +5,12 @@ import { CLIENT_IDS } from "./clients/types.js";
 import { runBind } from "./bind.js";
 import { ConsoleUsageError, runConsole, runConsoleKey } from "./console.js";
 import { runDashboard } from "./dashboard.js";
-import { DEFAULT_REPORT, DOCTOR_CLIENT_IDS, runDoctor } from "./doctor.js";
+import { DEFAULT_REPORT, DOCTOR_CLIENT_IDS, keyOrigin, runDoctor } from "./doctor.js";
 import { DEFAULT_PRECHECK_CONFIG, DEFAULT_PRECHECK_OUT, runEnterprisePrecheck } from "./enterprise/precheck.js";
 import { realHost } from "./local/checks.js";
 import { DEFAULT_ENGINE_PORT, runLocalDoctor } from "./local/doctor.js";
 import { CONTAINER_EXPORT_DIR, CONTAINER_IMPORT_DIR, runLocalExport, runLocalImport } from "./local/portable.js";
 import { runSetup } from "./setup.js";
-import { DEFAULT_SKILLS_TARBALL_URL } from "./skills.js";
 import { DEFAULT_CONTROL_URL, DEFAULT_MCP_URL } from "./urls.js";
 import { ENTERPRISE_ENGINE_VERSION, VERSION } from "./version.js";
 export const HELP = `aiakiv ${VERSION}: 폴더에 AiAkiv 프로젝트를 고정하고 확인하고, 전역 설치와 콘솔 작업을 하는 명령
@@ -21,6 +20,7 @@ export const HELP = `aiakiv ${VERSION}: 폴더에 AiAkiv 프로젝트를 고정
                     [--expires-days N] [--no-browser] [--no-skills]
   npx aiakiv setup  --client gemini|antigravity[,…] [--expires-days N] [--no-browser] [--no-skills] [--new-key]
   npx aiakiv doctor [--client <클라이언트>[,…]] [--dir <폴더>] [--out ${DEFAULT_REPORT}] [--no-probe]
+                    [--allow-url <주소>]
   npx aiakiv console <액션> [--data '<json>' | --data @파일.json] [--json] [--dir <폴더>] [--yes]
   npx aiakiv console describe [--json] [--dir <폴더>]
   npx aiakiv console key [--expires-days N] [--dir <폴더>] [--no-browser]
@@ -35,22 +35,24 @@ export const HELP = `aiakiv ${VERSION}: 폴더에 AiAkiv 프로젝트를 고정
 bind    폴더에 프로젝트를 고정합니다. 웹 콘솔의 "폴더 ZIP 받기" 와 같은 한 벌을 그 폴더에 직접 씁니다.
         claude, cursor 는 ?project= 주소(OAuth)를 쓰고, codex, gemini 는 브라우저에서 확인 버튼을 눌러
         프로젝트 키를 받아 씁니다. 키 평문은 화면에 내지 않고 그 폴더의 설정 파일에만 씁니다.
-        함께 쓰는 것: 폴더 스킬 여덟 개(claude 는 .claude/skills, 나머지는 .agents/skills,
-        --no-skills 면 건너뜀), claude 는 .claude/settings.json 의 enabledMcpjsonServers,
+        함께 쓰는 것: 폴더 스킬 여덟 개(이 CLI 에 든 것이라 내려받지 않습니다. claude 는 .claude/skills,
+        나머지는 .agents/skills, --no-skills 면 건너뜀), claude 는 .claude/settings.json 의 enabledMcpjsonServers,
         codex, gemini 는 키가 든 설정 파일을 .gitignore 에(git 저장소이거나 .gitignore 가 있을 때).
         Antigravity 는 앱 전체에 설정 하나라 폴더 고정이 없습니다(setup 을 쓰세요).
 setup   Gemini CLI 와 Antigravity 의 전역 설치를 합니다. 브라우저에서 확인 버튼을 눌러 Main(저장 대상)을
         따라가는 계정 전체 기억 키를 받고, 고른 클라이언트 모두의 전역 설정에 서버 이름 AiAkiv 로 씁니다.
         Gemini CLI 는 ~/.gemini/settings.json(httpUrl), Antigravity 는 ~/.gemini/config/mcp_config.json
-        (serverUrl). 전역 스킬도 씁니다(Gemini CLI 는 ~/.gemini/skills, Antigravity 는 ~/.gemini/config/skills
+        (serverUrl). 전역 스킬도 씁니다(이 CLI 에 든 것. Gemini CLI 는 ~/.gemini/skills, Antigravity 는 ~/.gemini/config/skills
         와, ~/.gemini/antigravity-cli 가 있으면 그 아래 skills. --no-skills 면 건너뜀).
         계정 전체 키는 한 사람에게 하나만 살아 있어, 새로 받으면 앞선 키(다른 PC 것 포함)는 폐기됩니다.
         그래서 두 전역 파일에 쓸 수 있는 키(binding main)가 이미 있으면 브라우저를 열지 않고 그 키를
         다시 씁니다. --new-key 면 새로 받습니다. --expires-days 가 없으면 만료가 없습니다.
-doctor  설정 파일, 클라이언트 등록 목록, 스킬 위치를 확인하고 결과를 마크다운 파일로 씁니다.
+doctor  설정 파일, 클라이언트 등록 목록, 스킬 위치, 이 CLI 에 든 스킬의 버전을 확인하고 결과를 마크다운 파일로 씁니다.
         키로 묶인 연결은 get_save_target 을 직접 불러 팀, 프로젝트, binding 을 적습니다.
         --client 는 bind 의 넷과 antigravity 를 받습니다(기본은 모두). setup 이 쓴 전역 키는 binding 이
-        main 이어야 합니다.
+        main 이어야 합니다. 폴더 설정 파일은 남이 준 것일 수 있어, 그 파일의 키는 AiAkiv 주소(기본 MCP 주소나
+        AIAKIV_MCP_URL)에만 보내고 환경 변수는 AIAKIV_API_KEY 만 읽습니다. 자체 서버를 점검할 때는
+        --allow-url <주소> 로 그 주소를 직접 주세요(여러 번 줄 수 있습니다).
 console 웹 콘솔의 작업(팀, 초대, 프로젝트, Main 전환, 연결, 카드 등)을 실행합니다. 액션 이름과
         인자는 console describe 가 보여 줍니다. 별칭: teams, projects, links, permissions.
         읽기는 bind 가 받은 프로젝트 키(그 키의 팀만)나 계정 키로 됩니다. 쓰기는 계정 키와, 콘솔
@@ -127,7 +129,6 @@ console 과 dashboard 의 종료 코드:
   AIAKIV_MCP_URL             MCP 주소(기본 ${DEFAULT_MCP_URL})
   AIAKIV_CONTROL_URL         웹 콘솔 주소(기본 ${DEFAULT_CONTROL_URL})
   AIAKIV_API_KEY             console, dashboard 가 먼저 쓰는 키
-  AIAKIV_SKILLS_TARBALL_URL  폴더 스킬과 전역 스킬을 받는 주소(기본 ${DEFAULT_SKILLS_TARBALL_URL})
   AIAKIV_ENTERPRISE_MANIFEST_URL  enterprise precheck 가 이미지를 내려받을 때 읽는 목록 파일 주소
 
 공통: -h, --help   -v, --version`;
@@ -196,6 +197,15 @@ function parseDoctorClients(values) {
         return c;
     });
 }
+/** doctor 의 --allow-url. 사용자가 직접 준 주소라 받되, 키를 보낼 수 있는 주소(http, https, 사용자 정보 없음)만. */
+function parseAllowUrls(values) {
+    return (values ?? []).map((v) => {
+        if (!keyOrigin(v.trim())) {
+            throw new UsageError(`--allow-url 은 http 나 https 주소이고 사용자 정보(…@)가 없어야 합니다(받은 값: ${v}).`);
+        }
+        return v.trim();
+    });
+}
 export async function main(argv, ctx) {
     const [cmd, ...rest] = argv;
     try {
@@ -283,6 +293,7 @@ export async function main(argv, ctx) {
                     dir: { type: "string" },
                     out: { type: "string" },
                     "no-probe": { type: "boolean", default: false },
+                    "allow-url": { type: "string", multiple: true },
                     help: { type: "boolean", short: "h" },
                 },
                 strict: true,
@@ -290,7 +301,13 @@ export async function main(argv, ctx) {
             if (values.help)
                 return (ctx.out(HELP), 0);
             const clients = parseDoctorClients(values.client);
-            return await runDoctor(ctx, { clients, dir: values.dir, out: values.out, noProbe: values["no-probe"] });
+            return await runDoctor(ctx, {
+                clients,
+                dir: values.dir,
+                out: values.out,
+                noProbe: values["no-probe"],
+                allowUrls: parseAllowUrls(values["allow-url"]),
+            });
         }
         if (cmd === "console" && rest[0] === "key") {
             const dropped = rest.slice(1).map((a) => /^--(project|manage|team)(=|$)/.exec(a)?.[1]).find(Boolean);

package/dist/mcpProbe.js

@@ -56,6 +56,29 @@ export function saveTargetFromResult(result) {
     return null;
 }
 const str = (v) => (typeof v === "string" ? v : v == null ? undefined : String(v));
+const REDIRECTS = [301, 302, 303, 307, 308];
+const MAX_REDIRECTS = 5;
+/** 넘겨주기(redirect)는 같은 출처(방식, 호스트, 포트) 안의 307, 308 만 따라간다(서버의 `/` → `/mcp` 308 같은 것).
+ * 다른 출처로 넘기면 키를 싣지 않고 멈춘다. fetch 에 맡기면 Node 18 초기 판은 다른 호스트로 넘어갈 때도
+ * Authorization 을 그대로 실었다. 301, 302, 303 은 POST 를 GET 으로 바꾸는 응답이라 따라가지 않고 그대로 돌려준다. */
+async function fetchSameOrigin(fetchImpl, url, init) {
+    let current = url;
+    for (let hop = 0;; hop += 1) {
+        const res = await fetchImpl(current, { ...init, redirect: "manual" });
+        if (!REDIRECTS.includes(res.status))
+            return res;
+        const location = res.headers.get("location");
+        if (!location || hop >= MAX_REDIRECTS || (res.status !== 307 && res.status !== 308))
+            return res;
+        const next = new URL(location, current);
+        if (next.origin !== new URL(current).origin) {
+            await res.text().catch(() => "");
+            throw new Error(`서버가 다른 주소(${next.origin})로 넘기려 해서 키를 보내지 않고 멈췄습니다`);
+        }
+        await res.text().catch(() => "");
+        current = next.href;
+    }
+}
 export async function probeSaveTarget(fetchImpl, url, key, opts = {}) {
     const timeoutMs = opts.timeoutMs ?? 20_000;
     let session = null;
@@ -67,7 +90,7 @@ export async function probeSaveTarget(fetchImpl, url, key, opts = {}) {
         "MCP-Protocol-Version": protocol,
         ...(session ? { "Mcp-Session-Id": session } : {}),
     });
-    const post = async (msg) => fetchImpl(url, {
+    const post = async (msg) => fetchSameOrigin(fetchImpl, url, {
         method: "POST",
         headers: headers(),
         body: JSON.stringify(msg),
@@ -127,7 +150,7 @@ export async function probeSaveTarget(fetchImpl, url, key, opts = {}) {
     }
     finally {
         if (session) {
-            await fetchImpl(url, { method: "DELETE", headers: headers(), signal: AbortSignal.timeout(5_000) }).catch(() => undefined);
+            await fetchSameOrigin(fetchImpl, url, { method: "DELETE", headers: headers(), signal: AbortSignal.timeout(5_000) }).catch(() => undefined);
         }
     }
 }