@modootoday/datalab-extension-mcp 1.8.23 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md CHANGED
@@ -24,14 +24,14 @@ Set this up once per computer.
24
24
 
25
25
  ## Four steps
26
26
 
27
- | Step | What | Where |
28
- | ----------------- | -------------------------------------------- | ------------------ |
29
- | **1. Turn it on** | Flip a switch and copy the **install key** | Extension settings |
30
- | **2. Install** | Run one command and paste the key | Terminal |
31
- | **3. Connect** | Register **this browser** on the same screen | Extension settings |
32
- | **4. Verify** | Ask a test question in your AI app | Your AI app |
27
+ | Step | What | Where |
28
+ | ----------------- | --------------------------------------------- | ------------------ |
29
+ | **1. Turn it on** | Flip a switch and copy the **connection key** | Extension settings |
30
+ | **2. Install** | Run one command and paste the key | Terminal |
31
+ | **3. Connect** | Open the side panel | Extension |
32
+ | **4. Verify** | Ask a test question in your AI app | Your AI app |
33
33
 
34
- Steps 1 and 3 are the same screen, which tells you how far along you are — leave it open and follow it down.
34
+ Steps 1 and 2 are driven from the same screen, which tells you how far along you are — leave it open and follow it down.
35
35
 
36
36
  Feel free to read [Safety](#safety) first if you'd like reassurance before starting.
37
37
 
@@ -45,13 +45,13 @@ Feel free to read [Safety](#safety) first if you'd like reassurance before start
45
45
  >
46
46
  > _(When a connected AI app asks, your Naver data is sent to that app and its AI provider's servers.)_
47
47
 
48
- 4. A **numbered 1 · 2 · 3 walkthrough** unfolds below. In box **1 [설치 인증키]** (install key), press **[복사]** (copy) to put the value on the clipboard. ([보기] reveals it if you want to see it.)
48
+ 4. A **numbered 1 · 2 · 3 walkthrough** unfolds below. In box **1 [연결 키]** (connection key), press **[복사]** (copy) to put the value on the clipboard. ([보기] reveals it if you want to see it.)
49
49
 
50
50
  > "이 값은 이 컴퓨터 전용 비밀번호예요. 다른 사람에게 보내지 마세요."
51
51
  >
52
52
  > _(This value is a password for this computer only. Don't send it to anyone.)_
53
53
 
54
- Avoid sharing a screenshot or the copied setup. The install key belongs only in AI host configuration and workbench management. It is **not** the registration code from step 3 — browser registration uses separate codes, each shown once and never again.
54
+ Avoid sharing a screenshot or the copied setup. This one key is what goes into the AI app's configuration and into every other browser on this computer.
55
55
 
56
56
  ## Step 2 — Install
57
57
 
@@ -61,18 +61,18 @@ One command finds **every** AI app on your computer and connects them automatica
61
61
  2. **Paste this command and press Enter.** The saved command names an exact bootstrap version. At startup and while idle, the connector checks the canonical release and promotes itself to the current secure, compatible version. Diagnostic environments can opt out with `--no-self-update`.
62
62
 
63
63
  ```
64
- npx -y @modootoday/datalab-extension-mcp@1.8.23 install
64
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 install
65
65
  ```
66
66
 
67
67
  Lines of English scrolling by is normal. This only downloads and runs the connector — it touches nothing else.
68
68
 
69
- The helper runs in four chapters — `[1/4]` check the install key, `[2/4]` find AI programs, `[3/4]` connect, `[4/4] 결과` (results).
69
+ The helper runs in four chapters — `[1/4]` check the connection key, `[2/4]` find AI programs, `[3/4]` connect, `[4/4] 결과` (results).
70
70
 
71
- 3. **Paste the install key.** The helper asks:
71
+ 3. **Paste the connection key.** The helper asks:
72
72
 
73
- > "복사한 설치 인증키를 붙여넣어 주세요:"
73
+ > "복사한 연결 키를 붙여넣어 주세요:"
74
74
  >
75
- > _(Paste the install key you copied here:)_
75
+ > _(Paste the connection key you copied here:)_
76
76
 
77
77
  Paste the value from step 1 and press Enter. A malformed paste is asked for once more.
78
78
 
@@ -110,7 +110,7 @@ If the command errors with `'npx' is not recognized`, Node.js isn't installed. T
110
110
  curl -fsSL https://app.datalab.tools/install/mcp.sh | sh
111
111
  ```
112
112
 
113
- When it asks for the install key, paste the one from step 1. If you have no AI app yet, you can also pick one to install right there (choosing is optional).
113
+ When it asks for the connection key, paste the one from step 1. If you have no AI app yet, you can also pick one to install right there (choosing is optional).
114
114
 
115
115
  > Want to see what it does before running it? Open that URL in a browser — it serves the script itself, in plain text.
116
116
 
@@ -121,13 +121,16 @@ Apps it **only prints instructions for** (follow the on-screen guide): VS Code,
121
121
 
122
122
  ## Step 3 — Connect
123
123
 
124
- Once the install finishes, **box 3 on the extension settings screen** changes on its own. No reload needed.
124
+ If you installed from this browser, there is nothing to do. **Open the side
125
+ panel** and this browser attaches with its own key.
125
126
 
126
- - If a **[이 브라우저 연결하기]** (connect this browser) button is there, press it and you're done — the screen mints the registration code and redeems it for you.
127
- - If it already reads **"등록됨"** (registered), there is nothing to do.
128
- - If you **already installed from another browser on this computer**, you get a code box instead of the button. Paste the code made in that browser (see [Putting another Chrome on the workbench](#putting-another-chrome-on-the-workbench)).
127
+ If you **already installed from another browser on this computer**, copy the
128
+ connection key from box 1 in that browser and paste it here, under box 1 →
129
+ **[이 컴퓨터의 다른 브라우저에서 이미 설치했어요]** (already installed from
130
+ another browser on this computer). See [Putting another browser on this
131
+ computer](#putting-another-browser-on-this-computer).
129
132
 
130
- Registration is once per browser. The connection itself lives only while the side panel is open.
133
+ The connection itself lives only while the side panel is open.
131
134
 
132
135
  ## Step 4 — Verify
133
136
 
@@ -145,10 +148,10 @@ Registration is once per browser. The connection itself lives only while the sid
145
148
  Installing also places the bundled **writing skills**. An AI app reads the name and description of every installed skill on every start, so the more are installed the less room the conversation has. The default therefore places only the ones that work right away.
146
149
 
147
150
  ```
148
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills list
149
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills status
150
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills attach <name>
151
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills detach <name>
151
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills list
152
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills status
153
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills attach <name>
154
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills detach <name>
152
155
  ```
153
156
 
154
157
  - `list` shows everything in this version, name and description.
@@ -160,36 +163,20 @@ npx -y @modootoday/datalab-extension-mcp@1.8.23 skills detach <name>
160
163
 
161
164
  If another tool installed a skill of the same name, it is left alone and said so. Removal deletes only the files we wrote.
162
165
 
163
- ## Putting another Chrome on the workbench
166
+ ## Putting another browser on this computer
164
167
 
165
- The **workbench** is this computer, where the connector runs. If you use more than one Chrome profile, each gets a registration code of its own and joins the same workbench. This is one computer only — the connector listens on 127.0.0.1, so no other machine can reach it, and a code is never something to send to another person.
168
+ There is **one connection key per computer**. To add a browser, copy the key
169
+ from an already connected browser (extension settings → **다른 AI 앱에 연결
170
+ (MCP)** → box 1 → `복사`) and paste it in the new browser under box 1 →
171
+ **[이 컴퓨터의 다른 브라우저에서 이미 설치했어요]**. No registration codes, no
172
+ issuing, no roster.
166
173
 
167
- Make the code in extension settings → **다른 AI 앱에 연결 (MCP)** → expand **[다른 브라우저 추가 (선택)]** (add another browser, optional) below box 3 → [등록 코드 만들기]. Or from the terminal.
174
+ This is one computer only — the connector listens on 127.0.0.1, so no other
175
+ machine can reach it, and the key is never something to send to another person.
168
176
 
169
- ```
170
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers add "Work Chrome"
171
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers list
172
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers revoke <handle>
173
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers repair
174
- ```
175
-
176
- `add` **asks you to paste the install key** — the same value you used to
177
- install, copied from box 1 in settings. It then prints a code **once**. The
178
- connector keeps only a fingerprint of it, so it cannot show it to you again.
179
-
180
- Open the other browser → extension settings → **다른 AI 앱에 연결 (MCP)** → paste
181
- that code into **3. 이 브라우저 등록** (register this browser). That browser does
182
- not make a code of its own.
183
-
184
- - `list` separates `코드 대기` (a code exists, nobody has used it),
185
- `연결됨` (connected) and `연결 끊김` (detached). The CLI speaks Korean —
186
- this file is the derived English guide.
187
- - After `revoke`, that browser cannot rejoin. To let it back in, **revoke and
188
- then `add` again** — handing the same browser a new code alone is refused.
189
- - If `list` asks for registry repair, run `repair`, then issue a fresh registration
190
- code only for the affected browser. Healthy browser rows remain in place.
191
- - With the connector stopped, these commands do nothing and say so. Opening the
192
- AI app you paired brings it back.
177
+ To see which browsers an AI app can reach right now, ask for `datalab_browsers`.
178
+ It answers with the browsers currently attached, named by what each one reported
179
+ about itself.
193
180
 
194
181
  ## Troubleshooting
195
182
 
@@ -215,17 +202,26 @@ _(The connector is an older version. Paste the new setup into your AI app, then
215
202
 
216
203
  Press **[새 설정 복사]** (copy new setup) on the card, paste as instructed, then fully quit and restart your AI app.
217
204
 
218
- ### "AI 앱이 예전 설치 인증키를 쓰고 있어요…"
205
+ ### "연결 프로그램이 이 브라우저의 키를 받지 않아요…"
206
+
207
+ _(The connector will not take this browser's key.)_
208
+
209
+ Two causes, and the connector does not say which.
219
210
 
220
- _(Your AI app is using an old install key.)_
211
+ **If you installed from another browser on this computer**, put that browser's
212
+ key into this one and you are done (see [Putting another browser on this
213
+ computer](#putting-another-browser-on-this-computer)). Pasting a new setup here
214
+ instead **disconnects that browser.**
221
215
 
222
- The connector is running with the code its AI app handed it at startup. **[다시 연결하기] (reconnect) will not help here** — the other side keeps presenting that same old code.
216
+ **If you did not**, the connector is running with the key its AI app handed it
217
+ at startup. **[다시 연결하기] (reconnect) will not help** — the other side keeps
218
+ presenting that same old key.
223
219
 
224
220
  1. Press **[새 설정 복사]** (copy new setup) on the card
225
221
  2. Paste it into the AI app's settings
226
222
  3. **Fully quit that AI app and start it again** — not just close the window (Windows: tray icon → quit; Mac: `⌘+Q`; Linux: Quit from the app menu)
227
223
 
228
- Item 3 is what brings the connector back with the install key stored in the AI app. Browser registration codes are not changed by this procedure.
224
+ Item 3 is what brings the connector back with the key stored in the AI app.
229
225
 
230
226
  ### "연결 통로(포트)를 다른 프로그램이 쓰고 있어요."
231
227
 
@@ -272,7 +268,7 @@ Start it again after a full quit and it picks the tools up. If they still aren't
272
268
  - **When the connection disappears** — run the very command you used at the start once more; it safely re-registers. (Some AI apps clean up their settings file and drop the connection.)
273
269
 
274
270
  ```
275
- npx -y @modootoday/datalab-extension-mcp@1.8.23 install
271
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 install
276
272
  ```
277
273
 
278
274
  - **`'npx' is not recognized...`** — Node.js isn't installed. The "No Node.js?" one-liner in Step 2 is the simplest fix.
@@ -302,7 +298,7 @@ Start it again after a full quit and it picks the tools up. If they still aren't
302
298
  1. Run this in a terminal (it removes the entries registered in your AI apps).
303
299
 
304
300
  ```
305
- npx -y @modootoday/datalab-extension-mcp@1.8.23 uninstall
301
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 uninstall
306
302
  ```
307
303
 
308
304
  2. Turn **MCP 연결** off in the extension settings. The panel is the bridge, so with it off a leftover config line can look nothing up.
@@ -318,7 +314,7 @@ Deleting the extension also renders any leftover connector inert. A leftover lin
318
314
  - **Does the ChatGPT website work?** No. Only the installed desktop app connects.
319
315
  - **Do I keep it always on?** No. It connects only while the panel is open.
320
316
  - **What data does it read?** Blog stats, keywords, ads — what DataLab Tools shows. Scoped to the Naver account you're logged into in Chrome.
321
- - **Other computers?** Yes, but set it up once per computer; the install key is per-computer too.
317
+ - **Other computers?** Yes, but set it up once per computer; the connection key is per-computer too.
322
318
  </details>
323
319
 
324
320
  ## Developer appendix
package/README.md CHANGED
@@ -22,14 +22,14 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
22
22
 
23
23
  ## 네 단계예요
24
24
 
25
- | 단계 | 하는 일 | 어디서 |
26
- | ----------- | ----------------------------------------- | --------- |
27
- | **1. 켜기** | 스위치를 켜고 **설치 인증키**를 복사해요 | 확장 설정 |
28
- | **2. 설치** | 명령 한 줄을 실행하고 인증키를 붙여넣어요 | 터미널 |
29
- | **3. 연결** | 설정 화면에서 **이 브라우저**를 등록해요 | 확장 설정 |
30
- | **4. 확인** | AI 앱에서 시험 질문을 해 봐요 | AI 앱 |
25
+ | 단계 | 하는 일 | 어디서 |
26
+ | ----------- | ------------------------------------- | --------- |
27
+ | **1. 켜기** | 스위치를 켜고 **연결 키**를 복사해요 | 확장 설정 |
28
+ | **2. 설치** | 명령 한 줄을 실행하고 키를 붙여넣어요 | 터미널 |
29
+ | **3. 연결** | 사이드 패널을 열어요 | 확장 |
30
+ | **4. 확인** | AI 앱에서 시험 질문을 해 봐요 | AI 앱 |
31
31
 
32
- 1·3단계는 같은 화면에서 이어집니다. 설정 화면이 지금 어디까지 됐는지 알려 주니, 화면을 열어 둔 채로 따라오시면 돼요.
32
+ 1·2단계는 같은 화면에서 이어집니다. 설정 화면이 지금 어디까지 됐는지 알려 주니, 화면을 열어 둔 채로 따라오시면 돼요.
33
33
 
34
34
  시작 전에 안심하고 싶다면 아래 [안전](#안전)을 먼저 읽으셔도 좋아요.
35
35
 
@@ -41,11 +41,11 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
41
41
 
42
42
  > "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요."
43
43
 
44
- 4. 아래에 **1 · 2 · 3 번호가 붙은 안내**가 펼쳐져요. **1번 [설치 인증키]** 칸의 **[복사]** 버튼을 누르세요(눈으로 확인하고 싶으면 [보기]).
44
+ 4. 아래에 **1 · 2 · 3 번호가 붙은 안내**가 펼쳐져요. **1번 [연결 키]** 칸의 **[복사]** 버튼을 누르세요(눈으로 확인하고 싶으면 [보기]).
45
45
 
46
46
  > "이 값은 이 컴퓨터 전용 비밀번호예요. 다른 사람에게 보내지 마세요."
47
47
 
48
- 캡처 공유·채팅 전송은 피해 주세요. 인증키는 AI 앱 설정과 등록된 브라우저 관리에만 씁니다. **3번의 등록 코드와는 다른 값**이라 등록 코드 칸에 붙여넣으면 안 돼요 — 브라우저마다 별도 등록 코드가 발급되고, 그 코드는 만든 직후 한 번만 보여요.
48
+ 캡처 공유·채팅 전송은 피해 주세요. 이 키 하나가 AI 앱 설정에도, 이 컴퓨터의 다른 브라우저에도 그대로 쓰입니다.
49
49
 
50
50
  ## 2단계 — 설치
51
51
 
@@ -55,16 +55,16 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
55
55
  2. **아래 명령을 붙여넣고 Enter를 눌러요.** 저장되는 명령은 정확한 시작 버전을 적습니다. 연결 프로그램은 시작할 때와 유휴 상태에서 정본 릴리스를 확인해 현재의 안전하고 호환되는 버전으로 승격합니다. 진단 환경에서는 `--no-self-update`로 승격을 끌 수 있어요.
56
56
 
57
57
  ```
58
- npx -y @modootoday/datalab-extension-mcp@1.8.23 install
58
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 install
59
59
  ```
60
60
 
61
61
  영어 글자가 여러 줄 올라오는 건 정상이에요. 이 명령은 연결 프로그램을 다운로드해 실행할 뿐, 다른 건 건드리지 않아요.
62
62
 
63
- 도우미는 네 대목으로 진행돼요 — `[1/4] 설치 인증키 확인`, `[2/4] 연결할 AI 프로그램 찾기`, `[3/4] 연결하는 중`, `[4/4] 결과`.
63
+ 도우미는 네 대목으로 진행돼요 — `[1/4] 연결 키 확인`, `[2/4] 연결할 AI 프로그램 찾기`, `[3/4] 연결하는 중`, `[4/4] 결과`.
64
64
 
65
- 3. **설치 인증키를 붙여넣어요.** 도우미가 이렇게 물어봐요.
65
+ 3. **연결 키를 붙여넣어요.** 도우미가 이렇게 물어봐요.
66
66
 
67
- > "복사한 설치 인증키를 붙여넣어 주세요:"
67
+ > "복사한 연결 키를 붙여넣어 주세요:"
68
68
 
69
69
  1단계에서 복사한 값을 붙여넣고 Enter를 눌러요. 형식이 어긋나면 한 번 더 물어봐요.
70
70
 
@@ -98,7 +98,7 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
98
98
  curl -fsSL https://app.datalab.tools/install/mcp.sh | sh
99
99
  ```
100
100
 
101
- 중간에 설치 인증키를 물어보면 1단계에서 복사한 값을 붙여넣어요. 아직 AI 앱이 하나도 없으면, 원하는 AI 프로그램을 그 자리에서 골라 설치할 수도 있어요(고르는 건 자유예요).
101
+ 중간에 연결 키를 물어보면 1단계에서 복사한 값을 붙여넣어요. 아직 AI 앱이 하나도 없으면, 원하는 AI 프로그램을 그 자리에서 골라 설치할 수도 있어요(고르는 건 자유예요).
102
102
 
103
103
  > 실행 전에 내용을 확인하고 싶으면 위 주소를 브라우저에 그대로 열어 보세요 — 받아서 실행할 스크립트 원문이 그대로 보여요.
104
104
 
@@ -109,13 +109,14 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
109
109
 
110
110
  ## 3단계 — 연결
111
111
 
112
- 설치가 끝나면 **확장 설정 화면의 3번 칸**이 바뀌어 있어요. 새로고침하지 않아도 돼요.
112
+ 설치를 이 브라우저에서 하셨다면 할 일이 없어요. **사이드 패널을 열면** 이 브라우저가
113
+ 자기 키로 붙습니다.
113
114
 
114
- - **[이 브라우저 연결하기]** 버튼이 보이면 그것만 누르면 끝이에요. 등록 코드를 만들어 붙여넣는 과정을 화면이 대신 해 줘요.
115
- - **"등록됨"** 이 이미 떠 있으면 할 일이 없어요.
116
- - 이 컴퓨터의 **다른 브라우저에서 이미 설치**했다면 버튼 대신 등록 코드 칸이 나와요. 그 브라우저에서 만든 코드를 넣으세요(아래 [이 컴퓨터에 크롬 하나 더 올리기](#이-컴퓨터에-크롬-하나-더-올리기)).
115
+ 이 컴퓨터의 **다른 브라우저에서 이미 설치**했다면, 그 브라우저의 1번 **연결 키** 를 복사해
116
+ 이 브라우저 1번 아래의 **[이 컴퓨터의 다른 브라우저에서 이미 설치했어요]** 에 넣으세요
117
+ (아래 [이 컴퓨터에 브라우저 하나 더 올리기](#이-컴퓨터에-브라우저-하나-더-올리기)).
117
118
 
118
- 등록은 브라우저마다 한 번이에요. 실제 연결은 사이드 패널을 열어 둔 동안 이루어져요.
119
+ 실제 연결은 사이드 패널을 열어 둔 동안 이루어져요.
119
120
 
120
121
  ## 4단계 — 확인
121
122
 
@@ -133,10 +134,10 @@ Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프
133
134
  설치할 때 **글쓰기 도움말(스킬)** 도 함께 놓입니다. AI 앱은 켜질 때마다 설치된 도움말의 이름과 설명을 전부 읽기 때문에, 많이 깔수록 대화에 쓸 자리가 줄어들어요. 그래서 기본은 **바로 쓸 수 있는 것만** 놓습니다.
134
135
 
135
136
  ```
136
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills list
137
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills status
138
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills attach <이름>
139
- npx -y @modootoday/datalab-extension-mcp@1.8.23 skills detach <이름>
137
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills list
138
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills status
139
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills attach <이름>
140
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 skills detach <이름>
140
141
  ```
141
142
 
142
143
  - `list` 는 이 버전에 들어 있는 전부를 이름과 설명으로 보여 줘요.
@@ -148,27 +149,18 @@ npx -y @modootoday/datalab-extension-mcp@1.8.23 skills detach <이름>
148
149
 
149
150
  다른 도구로 설치한 같은 이름의 도움말이 있으면 **건드리지 않고 그렇게 말해요.** 뺄 때도 우리가 넣은 파일만 지웁니다.
150
151
 
151
- ## 이 컴퓨터에 크롬 하나 더 올리기
152
+ ## 이 컴퓨터에 브라우저 하나 더 올리기
152
153
 
153
- 등록은 **연결 프로그램이 도는 이 컴퓨터**를 기준으로 해요. 크롬 프로필을 여러 개 쓰신다면 프로필마다 등록 코드를 하나씩 만들어 같은 컴퓨터에 올릴 수 있어요. **한 컴퓨터 안에서만** 됩니다 — 연결 프로그램은 127.0.0.1 에서만 듣기 때문에 다른 컴퓨터는 닿지 못하고, 코드는 남에게 보낼 것이 아니에요.
154
+ 연결 키는 **이 컴퓨터에 하나**예요. 브라우저를 더 올리시려면 이미 연결된 브라우저의
155
+ 확장 설정 → **다른 AI 앱에 연결 (MCP)** → 1번 **연결 키** 의 `복사` 를 누르고, 올릴
156
+ 브라우저의 같은 화면에서 **[이 컴퓨터의 다른 브라우저에서 이미 설치했어요]** 를 펼쳐
157
+ 붙여넣으시면 됩니다. 등록 코드도, 발급도, 목록도 없어요.
154
158
 
155
- 확장 설정 → **다른 AI 앱에 연결 (MCP)** → 3번 아래의 **[다른 브라우저 추가 (선택)]** 를 펼쳐 [등록 코드 만들기]를 눌러도 되고, 터미널을 쓰셔도 돼요.
159
+ **한 컴퓨터 안에서만** 됩니다 — 연결 프로그램은 127.0.0.1 에서만 듣기 때문에 다른
160
+ 컴퓨터는 닿지 못하고, 키는 남에게 보낼 것이 아니에요.
156
161
 
157
- ```
158
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers add "회사 크롬"
159
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers list
160
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers revoke <handle>
161
- npx -y @modootoday/datalab-extension-mcp@1.8.23 browsers repair
162
- ```
163
-
164
- `add` 를 실행하면 **설치 인증키를 붙여넣으라고 물어봐요** — 설치할 때와 같은 값이고, 설정 화면 1번의 `복사` 버튼으로 얻습니다. 그러면 브라우저 등록 코드가 **한 번만** 출력돼요. 연결 프로그램은 그 코드를 저장하지 않고 지문만 남기므로 다시 보여 줄 수 없어요.
165
-
166
- 만든 코드는 올릴 크롬을 열고 → 확장 설정 → **다른 AI 앱에 연결 (MCP)** → **3. 이 브라우저 등록** 칸에 붙여넣습니다. 그 브라우저는 자기 코드를 따로 만들지 않아요.
167
-
168
- - `list` 는 `코드 대기`(코드는 만들었지만 아직 아무도 안 붙음) · `연결됨` · `연결 끊김` 을 구분해서 보여 줘요.
169
- - `revoke` 뒤에는 그 브라우저가 다시 붙지 못해요. 다시 넣으려면 **`revoke` 한 뒤 새로 `add`** 하세요 — 같은 브라우저에 코드만 새로 줘도 거절돼요.
170
- - `list` 가 등록부 복구를 안내하면 `repair`를 실행한 뒤, 영향받은 브라우저에 등록 코드를 새로 발급해 붙여넣으세요. 정상 등록은 유지됩니다.
171
- - 연결 프로그램이 꺼져 있으면 이 명령은 아무것도 하지 않고 그렇게 말해요. 연결해 둔 AI 앱을 켜면 연결 프로그램이 함께 살아납니다.
162
+ AI 앱이 지금 어떤 브라우저에 닿는지는 `datalab_browsers` 로 물어보시면 돼요. 붙어 있는
163
+ 브라우저만 답하고, 이름은 각 브라우저가 스스로 알려 준 것입니다.
172
164
 
173
165
  ## 문제해결
174
166
 
@@ -188,15 +180,22 @@ MCP 를 켜 두었지만 **네이버 페이지가 한 곳도 열려 있지 않
188
180
 
189
181
  카드의 **[새 설정 복사]** 버튼을 누르고 안내대로 붙여넣은 뒤, AI 앱을 완전히 껐다가 다시 켜요.
190
182
 
191
- ### "AI 앱이 예전 설치 인증키를 쓰고 있어요…"
183
+ ### "연결 프로그램이 이 브라우저의 키를 받지 않아요…"
184
+
185
+ 원인은 둘 중 하나이고, 연결 프로그램은 어느 쪽인지 알려 주지 않아요.
186
+
187
+ **이 컴퓨터의 다른 브라우저에서 설치했다면** — 그 브라우저의 연결 키를 이 브라우저에
188
+ 넣으면 끝이에요([이 컴퓨터에 브라우저 하나 더 올리기](#이-컴퓨터에-브라우저-하나-더-올리기)).
189
+ 여기서 새 설정을 붙여넣으면 **그 브라우저가 끊깁니다.**
192
190
 
193
- AI 앱이 켜질 때 받은 옛 설치 인증키로 연결 프로그램이 돌고 있어서 그래요. **여기서 [다시 연결하기]는 도움이 안 돼요** — 상대가 계속 같은 옛 코드를 내밀거든요.
191
+ **그런 적이 없다면** AI 앱이 켜질 때 받은 옛 키로 연결 프로그램이 돌고 있는 거예요.
192
+ **[다시 연결하기]는 도움이 안 돼요** — 상대가 계속 같은 옛 키를 내밀거든요.
194
193
 
195
194
  1. 카드의 **[새 설정 복사]** 를 누르고
196
195
  2. 그 내용을 AI 앱 설정에 붙여넣은 뒤
197
196
  3. **그 AI 앱을 완전히 종료했다가 다시 켜요** (창 닫기 말고 — Windows 트레이 종료 / Mac `⌘+Q` / Linux 앱 메뉴 Quit)
198
197
 
199
- 3번까지 해야 연결 프로그램이 AI 앱 설정에 저장된 설치 인증키로 다시 떠요. 브라우저 등록 코드는 이 과정에서 바꾸지 않습니다.
198
+ 3번까지 해야 연결 프로그램이 AI 앱 설정에 저장된 연결 키로 다시 떠요.
200
199
 
201
200
  ### "연결 통로(포트)를 다른 프로그램이 쓰고 있어요."
202
201
 
@@ -237,7 +236,7 @@ AI가 "그런 기능은 없다" 고 답하면, **"도구 목록을 확인해 보
237
236
  - **연결이 사라졌을 때** — 처음 실행했던 그 명령을 한 번 더 실행하면 안전하게 다시 등록돼요. (일부 AI 앱이 설정 파일을 정리하며 연결을 지우기도 해요.)
238
237
 
239
238
  ```
240
- npx -y @modootoday/datalab-extension-mcp@1.8.23 install
239
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 install
241
240
  ```
242
241
 
243
242
  - **`'npx'을(는) 내부 또는 외부 명령...`** — Node.js가 없는 거예요. 위 2단계의 "Node.js가 없다면" 한 줄 설치가 가장 간단해요.
@@ -257,7 +256,7 @@ AI가 "그런 기능은 없다" 고 답하면, **"도구 목록을 확인해 보
257
256
  - **조회는 그냥 되고, 고치는 건 허락받아요.** 데이터 조회는 바로 돼요. **네이버 글쓰기 창**과 사진·영상 편집기의 내용을 고치려면 사이드패널이나 설정에서 **AI 편집 허용**을 켜야 해요. 두 가지 중에 고르면 됩니다 — 이번 연결에만 켜면 패널을 닫을 때 다시 꺼지고, **항상 허용**으로 저장하면 매번 켜지 않아도 돼요(끄는 것도 같은 자리에서 합니다). 글쓰기 창에서는 제목·본문 넣기와 되돌리기가 열려요. 본문을 통째로 바꾸거나 사진을 넣는 것, 편집기 창을 닫는 것, 지우기는 **항상 허용에 포함되지 않아요** — 그 설정으로는 열리지 않습니다. 요금이 드는 기능은 어떤 설정으로도 열리지 않고, 실행 전에 **매번** 물어봐요.
258
257
  - **발행은 하지 않아요.** 글을 올리거나 공개하는 기능은 연결되지 않습니다 — 고친 내용은 글쓰기 창에 남고, 올릴지는 사용자가 직접 정해요.
259
258
  - **아이디·비밀번호·쿠키를 저장하지 않아요.** 네이버에 직접 접속하지도 않아요. 모든 조회는 내가 로그인해 둔 내 브라우저 안에서 일어나요.
260
- - **내 컴퓨터 안에서만 동작해요.** 밖에서는 접속할 수 없고, 설치 인증키와 확장 확인이라는 이중 잠금이 걸려 있어요.
259
+ - **내 컴퓨터 안에서만 동작해요.** 밖에서는 접속할 수 없고, 연결 키와 확장 확인이라는 이중 잠금이 걸려 있어요.
261
260
  - **데이터가 나가는 방식** — "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요." 이게 AI가 답하는 방식이라 처음 켤 때 미리 동의를 받아요. 전달된 데이터를 얼마나 보관·학습하는지는 각 AI 제공사 정책을 따르니, 쓰시는 AI 앱의 개인정보 정책을 확인해 주세요.
262
261
  - **설정에는 정확한 버전이 기록되고, 실행 시 안전한 최신 버전을 확인해요.** 연결 프로그램은 시작할 때와 유휴 상태에서 정본 버전을 확인해 최신 보안·호환 버전으로 승격합니다. 특정 버전을 유지해야 하는 진단 환경은 `--no-self-update`를 사용할 수 있어요.
263
262
  - **소스가 전부 공개된 오픈소스예요.** 다만 이미 같은 권한으로 실행 중인 악성코드까지 막아 주지는 못해요 — 이 연결 프로그램의 잠금은 원격·타 출처 접근을 막는 장치예요.
@@ -267,7 +266,7 @@ AI가 "그런 기능은 없다" 고 답하면, **"도구 목록을 확인해 보
267
266
  1. 터미널에서 아래 명령을 실행해요(AI 앱에 등록된 설정을 지워 줘요).
268
267
 
269
268
  ```
270
- npx -y @modootoday/datalab-extension-mcp@1.8.23 uninstall
269
+ npx -y @modootoday/datalab-extension-mcp@1.9.0 uninstall
271
270
  ```
272
271
 
273
272
  2. 확장 설정에서 **MCP 연결을 꺼요.** 패널이 브릿지라, 꺼 두면 어딘가 설정 줄이 남아 있어도 AI 앱이 아무것도 조회할 수 없어요.
@@ -283,7 +282,7 @@ AI가 "그런 기능은 없다" 고 답하면, **"도구 목록을 확인해 보
283
282
  - **ChatGPT 웹사이트에서도 되나요?** 아니요. 컴퓨터에 설치한 데스크톱 앱만 연결돼요.
284
283
  - **항상 켜 둬야 하나요?** 아니요. 패널이 열려 있을 때만 연결돼요.
285
284
  - **어떤 데이터를 읽나요?** 블로그 통계·키워드·광고 등 데이터랩툴즈가 보여 주는 것들이에요. 기준은 지금 Chrome에 로그인해 둔 네이버 계정이에요.
286
- - **다른 컴퓨터에서도 되나요?** 네. 컴퓨터마다 한 번씩 설치하고, 설치 인증키도 컴퓨터마다 따로예요.
285
+ - **다른 컴퓨터에서도 되나요?** 네. 컴퓨터마다 한 번씩 설치하고, 연결 키도 컴퓨터마다 따로예요.
287
286
  </details>
288
287
 
289
288
  ## 개발자 부록