@modootoday/datalab-extension-mcp 1.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 modootoday
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,273 @@
+_[한국어](./README.md)_
+
+# DataLab Tools Connector
+
+A small free program that connects an AI app like Claude to DataLab Tools. Once connected, you can ask your AI:
+
+> "How did my blog do last week?"
+
+and it answers with the **real numbers** from your Naver blog, keywords, and ads — not guesses. **Lookups just work; editing is asked for** — changing your draft or an editor needs a separate allow, and it never publishes. A first-timer is usually done in about 10 minutes.
+
+> The extension UI and the setup helper speak Korean; this page mirrors the Korean README ([한국어](./README.md)) for reference. The exact sentences you'll see on screen are shown in Korean below, with an English gloss.
+
+## What you need
+
+Set this up once per computer.
+
+| Need                                 | How                                                                                                                                                                                                                                                                    |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Chrome + the DataLab Tools extension | If you don't have it yet, install from [app.datalab.tools](https://app.datalab.tools/).                                                                                                                                                                                |
+| An AI app                            | The program that answers your questions. It must be an **app installed on your computer** (websites won't work). Claude Desktop is free at [claude.ai](https://claude.ai/download); ChatGPT works as the **desktop app only**, from [openai.com](https://openai.com/). |
+| Node.js                              | The free program that runs the connector. Get it from [nodejs.org](https://nodejs.org/) via the **LTS** button. If that's a hassle, the one-liner in [Step 2](#step-2--install) installs Node.js for you in one go — no admin rights needed.                           |
+
+> A work computer may block installs by policy. Check with your IT team first to avoid wasting time.
+
+## Three steps
+
+| Step              | What                                                            | Where                    |
+| ----------------- | --------------------------------------------------------------- | ------------------------ |
+| **1. Turn it on** | Flip a switch in the extension panel and note the pairing token | DataLab Tools side panel |
+| **2. Install**    | Run one command and paste the token                             | Terminal                 |
+| **3. Verify**     | Ask a test question in your AI app                              | Your AI app              |
+
+Feel free to read [Safety](#safety) first if you'd like reassurance before starting.
+
+## Step 1 — Turn it on
+
+1. Click the DataLab Tools icon at Chrome's top-right to open the **side panel**. (If you don't see it, find it under the puzzle-piece icon.)
+2. In **Settings** on the left, turn on the **"다른 AI 앱에 연결 (MCP)"** (Connect to another AI app) switch.
+3. A consent screen appears. Read it and agree.
+
+   > "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요."
+   >
+   > _(When a connected AI app asks, your Naver data is sent to that app and its AI provider's servers.)_
+
+4. When the **"MCP 연결" (MCP connection) card** shows in the panel, you're set. You'll use the **pairing token** on it in the next step — press **[복사]** (copy) to put it on the clipboard now. ([보기] reveals it if you want to see it.)
+
+> "이 코드는 이 컴퓨터 전용 비밀번호예요. 다른 사람에게 보내지 마세요."
+>
+> _(This code is a password for this computer only. Don't send it to anyone.)_
+
+Avoid sharing a screenshot or the copied setup. If it may have leaked, press **[새 토큰 발급]** (issue a new token) on the card — the old code stops working immediately and a matching setup lands on your clipboard. Paste that into each AI app you had connected.
+
+## Step 2 — Install
+
+One command finds **every** AI app on your computer and connects them automatically. Nothing to do per app.
+
+1. **Open a terminal** — on Windows type `cmd` in the search box → "Command Prompt"; on Mac press `⌘+Space` and type `Terminal`; on Linux open your terminal app (often `Ctrl+Alt+T`).
+2. **Paste this command and press Enter.** (`@1.2.5` is the pinned version, so the connector never changes behind your back.)
+
+   ```
+   npx -y @modootoday/datalab-extension-mcp@1.2.5 install
+   ```
+
+   Lines of English scrolling by is normal. This only downloads and runs the connector — it touches nothing else.
+
+3. **Paste the pairing token.** The helper asks:
+
+   > "복사한 연결 토큰을 여기에 붙여넣어 주세요:"
+   >
+   > _(Paste the connection token you copied here:)_
+
+   Paste the token from the Step 1 card and press Enter.
+
+4. **Confirm.** It asks exactly one question:
+
+   > "위 N개 프로그램에 연결할까요?" (Y/n)
+   >
+   > _(Connect to the N programs above?)_
+
+   Press `Y`. If it found 0 apps, install an AI app first and run the same command again.
+
+5. When you see this, you're done:
+
+   > 마지막 한 단계: AI 앱을 완전히 종료했다가 다시 실행해 주세요.
+   > (Windows: 작업 표시줄 트레이 아이콘에서 종료)
+   >
+   > _(One last step: fully quit your AI app and start it again. Windows: quit from the taskbar tray icon.)_
+
+   Just closing the window can leave it running in the background, so a **full quit** matters (Windows: tray icon → quit; Mac: `⌘+Q`; Linux: Quit from the app menu).
+
+<details>
+<summary><strong>No Node.js? — install it in one go</strong></summary>
+
+If the command errors with `'npx' is not recognized`, Node.js isn't installed. This one command installs Node.js first (no admin rights) and then continues to connect. If Node.js is already there, it skips the install. You can use this instead of the Node.js step in [What you need](#what-you-need).
+
+- **Windows** (open PowerShell and paste):
+
+  ```
+  irm https://app.datalab.tools/install/mcp.ps1 | iex
+  ```
+
+- **Mac · Linux** (open the terminal and paste):
+
+  ```
+  curl -fsSL https://app.datalab.tools/install/mcp.sh | sh
+  ```
+
+When it asks for the pairing token, paste the one from the Step 1 card. If you have no AI app yet, you can also pick one to install right there (choosing is optional).
+
+> Want to see what it does before running it? Open that URL in a browser — it serves the script itself, in plain text.
+
+</details>
+
+Apps it **connects automatically**: Claude Desktop, Claude Code, ChatGPT desktop, Codex CLI, Gemini CLI, Cursor, Windsurf, Amazon Q Developer, JetBrains Junie, Kiro.
+Apps it **only prints instructions for** (follow the on-screen guide): VS Code, Zed, Cline, Roo Code, LM Studio, Warp.
+
+## Step 3 — Verify
+
+- If the card at the top of the side panel is **green** and reads "연결됨" (connected), you're set. If it isn't green, go to [Troubleshooting](#troubleshooting).
+- Ask something like "How did my blog do last week?" in your AI app; if real numbers come back, everything's done.
+
+## Good to know
+
+- **You're connected only while the DataLab Tools side panel is open** — close it and the connection closes too. Reopen and it reconnects automatically.
+- The connector is only a bridge — it stores no logins or passwords and doesn't work outside your computer.
+- When the extension updates, new features appear in your AI app automatically. The connector program itself stays the same.
+
+## Troubleshooting
+
+Whatever happened, the first question is always the same — **is the panel open?** If the card reads "문제 발생" (problem), look for the red sentence under it in the headings below. If it isn't there, the connector is passing an error through verbatim — see "None of the above" further down for the log file.
+
+### "연결을 기다리고 있어요. AI 앱을 켜면 자동으로 연결돼요."
+
+_(Waiting for a connection. It connects automatically when you start your AI app.)_
+
+Not an error — the normal state. Start your AI app and it connects on its own.
+
+### "커넥터가 예전 버전이에요. 버튼 한 번이면 새 버전으로 바뀌어요."
+
+_(The connector is an older version. One button updates it.)_
+
+Press **[새 설정 복사]** (copy new setup) on the card, paste as instructed, then fully quit and restart your AI app.
+
+### "AI 앱이 예전 연결 코드를 쓰고 있어요…"
+
+_(Your AI app is using an old connection code.)_
+
+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.
+
+1. Press **[새 설정 복사]** (copy new setup) on the card
+2. Paste it into the AI app's settings
+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)
+
+Step 3 is what brings the connector back up with the new code. 🔴 **Don't press [새 토큰 발급] (issue a new token) again** — that changes the code once more and puts you right back here.
+
+### "연결 통로(포트)를 다른 프로그램이 쓰고 있어요."
+
+_(Another program is using the connection path (port).)_
+
+Press **[업데이트 명령어 복사]** (copy update command) on the card, paste it into a terminal, and run it — the connector reconnects with new settings.
+
+### "크롬에서 데이터랩툴즈 패널이 닫혀 있어요. 크롬을 열고 데이터랩툴즈 패널을 열어 두면 바로 동작해요."
+
+_(The DataLab Tools panel is closed in Chrome. Open Chrome, keep the panel open, and it works right away.)_
+
+Exactly what it says. Open Chrome, keep the DataLab Tools side panel open, and it works immediately.
+
+### I only see 12 tools
+
+That's expected — **it's deliberate.**
+
+There are 168 tools. Sending all of them as a list runs into the cap each AI app
+sets: some quietly drop whatever doesn't fit, some refuse the connection outright.
+So the common ones go in the list, and **the rest are handed over as an answer when
+the AI asks for them.**
+
+Nothing is out of reach because of it. Ask for something that isn't in the list —
+"show me the reviews for my shop" — and the AI looks it up first, then runs it. The
+only cost is that extra step: **the first call to a given tool can be a second or
+two slower.**
+
+If the AI says a feature doesn't exist, tell it: **"check your tool catalog and
+answer again."**
+
+### The card is green but your AI app can't find the tools
+
+The usual cause: **the AI app was closed, not quit.** Closing the window leaves it running in the background, and in that state it never re-reads the tool list.
+
+- **Windows** — quit from the tray icon at the bottom right
+- **Mac** — `⌘+Q`, not just closing the window
+- **Linux** — Quit from the app menu, or end the process from a terminal
+
+Start it again after a full quit and it picks the tools up. If they still aren't there, run the Step 2 command once more.
+
+<details>
+<summary>The connection disappeared one day / 'npx' is not recognized</summary>
+
+- **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.)
+
+  ```
+  npx -y @modootoday/datalab-extension-mcp@1.2.5 install
+  ```
+
+- **`'npx' is not recognized...`** — Node.js isn't installed. The "No Node.js?" one-liner in Step 2 is the simplest fix.
+
+- **None of the above** — the connector writes down what happened to it. One file:
+
+  ```
+  ~/.datalab-mcp/connector.log
+  ```
+
+  The last lines say what it ran into. It rolls over past a size cap, so at most two files ever exist. Sending the tail of this file along with a question makes it far quicker to answer. (Nothing you looked up and nothing you wrote goes into it.)
+
+</details>
+
+## Safety
+
+- **Lookups just work; editing is asked for.** Looking data up is immediate. Changing your **Naver draft** or a photo/video editor needs you to allow it in the side panel for that connection only, and closing the panel turns it back off. In the draft, that covers setting the title, inserting text, and undo. Replacing the whole body, inserting a photo, deleting anything, and anything that costs money are asked about **every single time**, even while the allow is on.
+- **It never publishes.** Posting or making a draft public is not connected — edits stay in the draft window, and publishing is yours to do.
+- **The connector stores no logins, passwords, or cookies.** It never contacts Naver directly. Every lookup happens inside your own logged-in browser.
+- **It works only inside your computer.** Nothing outside can connect, and it's double-locked: the connection token plus a check that the caller really is your extension.
+- **How data moves** — "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요." When the AI app asks, the result goes to that AI provider (e.g. Anthropic) — exactly what you agreed to when turning this on. Retention and training are governed by each provider's policy, so check the privacy policy of the AI app you use.
+- **The version is pinned and never changes behind your back.** When a new version ships, the panel tells you and the choice is yours.
+- **The full source is open.** That said, it can't stop malware already running under your own account — this connector's locks control remote and cross-origin access, not an already-compromised host.
+
+## Removing it
+
+1. Run this in a terminal (it removes the entries registered in your AI apps).
+
+   ```
+   npx -y @modootoday/datalab-extension-mcp@1.2.5 uninstall
+   ```
+
+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.
+
+Deleting the extension also renders any leftover connector inert. A leftover line can be removed with the command above, and does nothing if left.
+
+## FAQ
+
+<details>
+<summary>Free? / ChatGPT web / always on / what data / other computers</summary>
+
+- **Is it free?** The connector is, and it's fully open-source. A few features do cost money — generating a photo with AI, putting a voice on a video — and each one asks before it runs, with the amount where we can work it out. Nothing is ever charged without asking first.
+- **Does the ChatGPT website work?** No. Only the installed desktop app connects.
+- **Do I keep it always on?** No. It connects only while the panel is open.
+- **What data does it read?** Blog stats, keywords, ads — what DataLab Tools shows. Scoped to the Naver account you're logged into in Chrome.
+- **Other computers?** Yes, but set it up once per computer; the pairing token is per-computer too.
+</details>
+
+## Developer appendix
+
+<details>
+<summary>Technical summary for source verification / integration</summary>
+
+- Repo: <https://github.com/modootoday/datalab-extension-mcp>
+- npm: <https://www.npmjs.com/package/@modootoday/datalab-extension-mcp>
+
+**Environment variables**
+
+| Variable                   | Required | Default     | Description                                                |
+| -------------------------- | -------- | ----------- | ---------------------------------------------------------- |
+| `DATALAB_MCP_TOKEN`        | required | —           | Pairing token. Issued and replaced in the extension panel. |
+| `DATALAB_MCP_EXTENSION_ID` | required | —           | The extension ID allowed to connect.                       |
+| `DATALAB_MCP_PORT`         | optional | `8765`      | Listen port.                                               |
+| `DATALAB_MCP_HOST`         | optional | `127.0.0.1` | Bind address. Non-loopback values are rejected.            |
+
+**Architecture** — the connector is a relay with no credentials and no egress. The tool list is served by the extension; the canonical catalog is the store-reviewed extension code. Transport is loopback HTTP+SSE with dual auth (Origin check + token check), and the allowlist — both the read-only half and the tier table that gates every write — is enforced by the extension. Canonical allowlist (with per-item exclusion reasons): <https://github.com/modootoday/datalab-extension-mcp/blob/main/mcp-core/src/allowlist.ts>
+
+**Supply chain** — the public repo is the entire source. npm publishing uses OIDC trusted publishing + provenance, with no long-lived token (`npm audit signatures` verifies). Every install surface pins an exact version, so a compromised distribution path can't push new code to installed users; upgrades always go through the user's explicit choice.
+
+**License** — MIT ([LICENSE](./LICENSE)).
+
+</details>

package/README.md

@@ -0,0 +1,249 @@
+_[English](./README.en.md)_
+
+# 데이터랩툴즈 커넥터
+
+Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프로그램이에요. 연결되면 AI에게 이렇게 물어볼 수 있어요.
+
+> "지난주 내 블로그 어땠어?"
+
+그러면 짐작이 아니라 내 네이버 블로그·키워드·광고의 **실제 수치**로 답해요. **조회는 바로 되고, 고치는 건 물어봐요** — 글쓰기 창이나 편집기를 고치려면 따로 허용해야 하고, 발행은 하지 않아요. 처음이어도 보통 10분이면 끝나요.
+
+## 준비물
+
+컴퓨터마다 한 번씩만 준비하면 돼요.
+
+| 준비물                     | 어떻게                                                                                                                                                                                                                               |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Chrome + 데이터랩툴즈 확장 | 아직 없다면 [app.datalab.tools](https://app.datalab.tools/)에서 설치해요.                                                                                                                                                            |
+| AI 앱                      | 질문을 받을 프로그램이에요. **컴퓨터에 설치하는 앱**만 돼요(웹사이트는 안 돼요). Claude Desktop은 [claude.ai](https://claude.ai/download)에서 무료로, ChatGPT는 **데스크톱 앱만** 되고 [openai.com](https://openai.com/)에서 받아요. |
+| Node.js                    | 커넥터를 실행하는 무료 프로그램이에요. [nodejs.org](https://nodejs.org/)의 **LTS** 버튼으로 받아요. 번거로우면 아래 [2단계](#2단계--설치)의 한 줄 설치가 Node.js까지 한 번에 깔아 줘요(관리자 권한도 필요 없어요).                   |
+
+> 회사 컴퓨터는 보안 정책 때문에 설치가 막혀 있을 수 있어요. 시작 전에 회사 IT 담당자와 먼저 상의하면 시간을 아낄 수 있어요.
+
+## 세 단계예요
+
+| 단계        | 하는 일                                          | 어디서                   |
+| ----------- | ------------------------------------------------ | ------------------------ |
+| **1. 켜기** | 확장 패널에서 스위치를 켜고 연결 토큰을 확인해요 | 데이터랩툴즈 사이드 패널 |
+| **2. 설치** | 명령 한 줄을 실행하고 토큰을 붙여넣어요          | 터미널                   |
+| **3. 확인** | AI 앱에서 시험 질문을 해 봐요                    | AI 앱                    |
+
+시작 전에 안심하고 싶다면 아래 [안전](#안전)을 먼저 읽으셔도 좋아요.
+
+## 1단계 — 켜기
+
+1. Chrome 오른쪽 위의 데이터랩툴즈 아이콘을 눌러 **사이드 패널**을 열어요. (안 보이면 퍼즐 조각 아이콘에서 찾을 수 있어요.)
+2. 왼쪽 **설정**에서 **"다른 AI 앱에 연결 (MCP)"** 스위치를 켜요.
+3. 동의 화면이 나오면 내용을 읽고 동의해요.
+
+   > "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요."
+
+4. 패널에 **"MCP 연결" 카드**가 보이면 성공이에요. 다음 단계에서 여기 있는 **연결 토큰**을 씁니다. **[복사]** 버튼을 눌러 복사해 두세요(눈으로 확인하고 싶으면 [보기]).
+
+> "이 코드는 이 컴퓨터 전용 비밀번호예요. 다른 사람에게 보내지 마세요."
+
+캡처 공유·채팅 전송은 피해 주세요. 혹시 새어 나간 것 같으면 카드의 **[새 토큰 발급]** 을 누르세요 — 옛 코드가 그 자리에서 무효가 되고, 새 설정이 클립보드에 담겨요. 연결해 둔 AI 앱마다 그 설정을 다시 넣어 주면 됩니다.
+
+## 2단계 — 설치
+
+명령 한 줄이면 컴퓨터에 있는 AI 앱을 **모두 자동으로** 찾아 연결해 줘요. 앱마다 따로 할 일은 없어요.
+
+1. **터미널을 열어요** — Windows는 검색창에 `cmd` → "명령 프롬프트", Mac은 `⌘+스페이스`로 `터미널`, Linux는 터미널 앱(보통 `Ctrl+Alt+T`)이에요.
+2. **아래 명령을 붙여넣고 Enter를 눌러요.** (`@1.2.5`은 커넥터가 나도 모르게 바뀌지 않도록 고정한 버전이에요.)
+
+   ```
+   npx -y @modootoday/datalab-extension-mcp@1.2.5 install
+   ```
+
+   영어 글자가 여러 줄 올라오는 건 정상이에요. 이 명령은 커넥터를 내려받아 실행할 뿐, 다른 건 건드리지 않아요.
+
+3. **연결 토큰을 붙여넣어요.** 도우미가 이렇게 물어봐요.
+
+   > "복사한 연결 토큰을 여기에 붙여넣어 주세요:"
+
+   1단계 카드에서 복사한 토큰을 붙여넣고 Enter를 눌러요.
+
+4. **연결할지 확인해요.** 딱 하나만 물어봐요.
+
+   > "위 N개 프로그램에 연결할까요?" (Y/n)
+
+   `Y`를 누르면 앱별 결과가 나와요. 찾은 앱이 0개면 AI 앱을 먼저 설치한 뒤 같은 명령을 다시 실행하면 돼요.
+
+5. 마지막에 이 안내가 보이면 성공이에요.
+
+   > 마지막 한 단계: AI 앱을 완전히 종료했다가 다시 실행해 주세요.
+   > (Windows: 작업 표시줄 트레이 아이콘에서 종료)
+
+   창만 닫으면 뒤에서 계속 돌 수 있어요. **완전히 종료** 후 다시 켜세요 — Windows는 트레이 아이콘에서 종료, Mac은 `⌘+Q`, Linux는 앱 메뉴의 Quit.
+
+<details>
+<summary><strong>Node.js가 없다면 — 한 줄로 한 번에 설치</strong></summary>
+
+위 명령이 `'npx'을(를) 찾을 수 없습니다` 오류를 내면 Node.js가 없는 거예요. 아래 명령 하나면 Node.js까지 설치(관리자 권한 없이)한 뒤 연결까지 이어 줘요. 이미 있으면 설치는 건너뛰어요. 이 방법을 [준비물](#준비물)의 Node.js 설치 대신 바로 써도 돼요.
+
+- **Windows** (PowerShell을 열고 붙여넣어요):
+
+  ```
+  irm https://app.datalab.tools/install/mcp.ps1 | iex
+  ```
+
+- **Mac · Linux** (터미널을 열고 붙여넣어요):
+
+  ```
+  curl -fsSL https://app.datalab.tools/install/mcp.sh | sh
+  ```
+
+중간에 연결 토큰을 물어보면 1단계 카드에서 복사한 토큰을 붙여넣어요. 아직 AI 앱이 하나도 없으면, 원하는 AI 프로그램을 그 자리에서 골라 설치할 수도 있어요(고르는 건 자유예요).
+
+> 실행 전에 내용을 확인하고 싶으면 위 주소를 브라우저에 그대로 열어 보세요 — 받아서 실행할 스크립트 원문이 그대로 보여요.
+
+</details>
+
+**자동으로 연결되는 앱**: Claude Desktop, Claude Code, ChatGPT 데스크톱, Codex CLI, Gemini CLI, Cursor, Windsurf, Amazon Q Developer, JetBrains Junie, Kiro.
+**안내문만 보여 주는 앱**(화면 안내를 따라 하면 돼요): VS Code, Zed, Cline, Roo Code, LM Studio, Warp.
+
+## 3단계 — 확인
+
+- 사이드 패널 위쪽 카드가 **초록색**이고 "연결됨"이 보이면 된 거예요. 초록색이 아니면 [문제해결](#문제해결)로 가세요.
+- AI 앱에서 "지난주 내 블로그 어땠어?" 처럼 물어보고 실제 수치가 나오면 전부 끝이에요.
+
+## 알아 두면 좋은 것
+
+- **패널이 열려 있는 동안에만 연결돼요.** 데이터랩툴즈 사이드 패널을 닫으면 연결도 함께 끊겨요. 다시 열면 자동으로 이어져요.
+- 커넥터는 다리일 뿐이에요 — 아이디·비밀번호를 저장하지 않고, 내 컴퓨터 밖에서는 동작하지 않아요.
+- 확장이 업데이트되면 새 기능이 자동으로 AI 앱에 나타나요. 커넥터 프로그램 자체는 그대로예요.
+
+## 문제해결
+
+무슨 일이든 첫 질문은 하나예요 — **패널이 열려 있나요?** 카드 상태가 "문제 발생"이면 그 아래 빨간 문장을 아래 소제목에서 찾아보세요. 여기 없는 문장이 떴다면 커넥터가 그대로 전해 준 오류예요 — 아래 "위 어느 것도 아닐 때" 의 기록 파일을 보시면 돼요.
+
+### "연결을 기다리고 있어요. AI 앱을 켜면 자동으로 연결돼요."
+
+오류가 아니라 정상이에요. AI 앱을 실행하면 자동으로 연결돼요.
+
+### "커넥터가 예전 버전이에요. 버튼 한 번이면 새 버전으로 바뀌어요."
+
+카드의 **[새 설정 복사]** 버튼을 누르고 안내대로 붙여넣은 뒤, AI 앱을 완전히 껐다가 다시 켜요.
+
+### "AI 앱이 예전 연결 코드를 쓰고 있어요…"
+
+AI 앱이 켜질 때 받은 옛 코드로 커넥터가 돌고 있어서 그래요. **여기서 [다시 연결하기]는 도움이 안 돼요** — 상대가 계속 같은 옛 코드를 내밀거든요.
+
+1. 카드의 **[새 설정 복사]** 를 누르고
+2. 그 내용을 AI 앱 설정에 붙여넣은 뒤
+3. **그 AI 앱을 완전히 종료했다가 다시 켜요** (창 닫기 말고 — Windows 트레이 종료 / Mac `⌘+Q` / Linux 앱 메뉴 Quit)
+
+3번까지 해야 커넥터가 새 코드로 다시 떠요. 🔴 **[새 토큰 발급]을 다시 누르지 마세요** — 코드가 또 바뀌어서 같은 상황이 반복돼요.
+
+### "연결 통로(포트)를 다른 프로그램이 쓰고 있어요."
+
+카드의 **[업데이트 명령어 복사]** 버튼을 눌러 터미널에 붙여넣어 실행하면 커넥터가 새 설정으로 다시 연결돼요.
+
+### "크롬에서 데이터랩툴즈 패널이 닫혀 있어요. 크롬을 열고 데이터랩툴즈 패널을 열어 두면 바로 동작해요."
+
+말 그대로예요. Chrome을 열고 데이터랩툴즈 사이드 패널을 열어 두면 바로 동작해요.
+
+### 도구가 12개밖에 안 보여요
+
+정상이에요. **일부러 그렇게 보냅니다.**
+
+전체 도구는 168개인데, 그걸 전부 목록으로 보내면 AI 앱마다 정해 둔 상한에 걸려요.
+어떤 앱은 넘치는 만큼 조용히 잘라내고, 어떤 앱은 아예 연결을 거부해요. 그래서 자주 쓰는
+것만 목록에 올리고, 나머지는 **AI가 물어보면 답으로 건네줍니다.**
+
+그래서 사용하는 데는 차이가 없어요. "우리 매장 리뷰 좀 보여줘" 처럼 목록에 없는 일을
+부탁해도, AI가 알아서 목록을 찾아본 뒤 실행해요. 다만 그 한 번을 더 거치니 **처음 부르는
+도구는 답이 1~2초 늦을 수 있어요.**
+
+AI가 "그런 기능은 없다" 고 답하면, **"도구 목록을 확인해 보고 다시 답해줘"** 라고 한 번
+말해 주세요.
+
+### 카드는 초록색인데 AI 앱이 도구를 못 찾을 때
+
+가장 흔한 경우예요. **AI 앱을 완전히 껐다가 다시 켜지 않아서** 그래요 — 창만 닫으면 뒤에서 계속 돌고, 그 상태로는 새로 연결된 도구를 못 봐요.
+
+- **Windows** — 작업 표시줄 오른쪽 아래 트레이 아이콘에서 종료
+- **Mac** — `⌘+Q` (창 닫기가 아니라 종료)
+- **Linux** — 앱 메뉴의 Quit, 또는 터미널에서 프로세스 종료
+
+완전히 종료한 뒤 다시 켜면 도구 목록을 새로 읽어요. 그래도 안 보이면 2단계 명령을 한 번 더 실행해 주세요.
+
+<details>
+<summary>연결이 어느 날 사라졌어요 / 'npx'를 찾을 수 없대요</summary>
+
+- **연결이 사라졌을 때** — 처음 실행했던 그 명령을 한 번 더 실행하면 안전하게 다시 등록돼요. (일부 AI 앱이 설정 파일을 정리하며 연결을 지우기도 해요.)
+
+  ```
+  npx -y @modootoday/datalab-extension-mcp@1.2.5 install
+  ```
+
+- **`'npx'을(는) 내부 또는 외부 명령...`** — Node.js가 없는 거예요. 위 2단계의 "Node.js가 없다면" 한 줄 설치가 가장 간단해요.
+
+- **위 어느 것도 아닐 때** — 커넥터가 무슨 일을 겪었는지 기록해 둬요. 파일 하나만 열어 보면 돼요.
+
+  ```
+  ~/.datalab-mcp/connector.log
+  ```
+
+  마지막 줄들이 그때 무슨 일이 있었는지 알려 줘요. 너무 커지지 않게 일정 크기가 넘으면 자동으로 넘겨서, 파일은 최대 두 개까지만 생겨요. 도움을 요청할 때 이 파일의 마지막 부분을 같이 보내 주시면 훨씬 빨라요. (조회한 내용이나 글 내용은 들어가지 않아요.)
+
+</details>
+
+## 안전
+
+- **조회는 그냥 되고, 고치는 건 허락받아요.** 데이터 조회는 바로 돼요. **네이버 글쓰기 창**과 사진·영상 편집기의 내용을 고치려면 사이드패널에서 이번 연결에 한해 켜 줘야 하고, 패널을 닫으면 다시 꺼져요. 글쓰기 창에서는 제목·본문 넣기와 되돌리기가 열려요. 본문을 통째로 바꾸거나 사진을 넣는 것, 지우기나 요금이 드는 기능은 켜 두었더라도 **할 때마다** 따로 물어봐요.
+- **발행은 하지 않아요.** 글을 올리거나 공개하는 기능은 연결되지 않습니다 — 고친 내용은 글쓰기 창에 남고, 올릴지는 사용자가 직접 정해요.
+- **아이디·비밀번호·쿠키를 저장하지 않아요.** 네이버에 직접 접속하지도 않아요. 모든 조회는 내가 로그인해 둔 내 브라우저 안에서 일어나요.
+- **내 컴퓨터 안에서만 동작해요.** 밖에서는 접속할 수 없고, 연결 토큰과 확장 확인이라는 이중 잠금이 걸려 있어요.
+- **데이터가 나가는 방식** — "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요." 이게 AI가 답하는 방식이라 처음 켤 때 미리 동의를 받아요. 전달된 데이터를 얼마나 보관·학습하는지는 각 AI 제공사 정책을 따르니, 쓰시는 AI 앱의 개인정보 정책을 확인해 주세요.
+- **버전은 고정되어 몰래 바뀌지 않아요.** 새 버전이 나오면 패널이 알려주고, 바꿀지는 사용자가 정해요.
+- **소스가 전부 공개된 오픈소스예요.** 다만 이미 같은 권한으로 실행 중인 악성코드까지 막아 주지는 못해요 — 이 커넥터의 잠금은 원격·타 출처 접근을 막는 장치예요.
+
+## 해지
+
+1. 터미널에서 아래 명령을 실행해요(AI 앱에 등록된 설정을 지워 줘요).
+
+   ```
+   npx -y @modootoday/datalab-extension-mcp@1.2.5 uninstall
+   ```
+
+2. 확장 설정에서 **MCP 연결을 꺼요.** 패널이 브릿지라, 꺼 두면 어딘가 설정 줄이 남아 있어도 AI 앱이 아무것도 조회할 수 없어요.
+
+확장을 삭제해도 남은 커넥터는 즉시 무력해져요. 설정에 남은 한 줄은 위 명령으로 지울 수 있고, 안 지워도 아무 일도 하지 않아요.
+
+## 자주 묻는 질문
+
+<details>
+<summary>유료인가요 / ChatGPT 웹 / 항상 켜 두기 / 어떤 데이터 / 다른 컴퓨터</summary>
+
+- **유료인가요?** 커넥터 자체는 무료이고 소스가 전부 공개된 오픈소스예요. 다만 AI로 사진을 만들거나 영상에 목소리를 넣는 것처럼 **요금이 드는 기능이 몇 가지 있고**, 그건 실행하기 전에 매번 물어봐요 — 물어보지 않고 요금이 나가는 일은 없어요.
+- **ChatGPT 웹사이트에서도 되나요?** 아니요. 컴퓨터에 설치한 데스크톱 앱만 연결돼요.
+- **항상 켜 둬야 하나요?** 아니요. 패널이 열려 있을 때만 연결돼요.
+- **어떤 데이터를 읽나요?** 블로그 통계·키워드·광고 등 데이터랩툴즈가 보여 주는 것들이에요. 기준은 지금 Chrome에 로그인해 둔 네이버 계정이에요.
+- **다른 컴퓨터에서도 되나요?** 네. 컴퓨터마다 한 번씩 설치하고, 연결 토큰도 컴퓨터마다 따로예요.
+</details>
+
+## 개발자 부록
+
+<details>
+<summary>소스 검증·통합용 기술 요약 (기술 용어 사용)</summary>
+
+- 저장소: <https://github.com/modootoday/datalab-extension-mcp>
+- npm: <https://www.npmjs.com/package/@modootoday/datalab-extension-mcp>
+
+**환경 변수**
+
+| 변수                       | 필수 | 기본값      | 설명                                  |
+| -------------------------- | ---- | ----------- | ------------------------------------- |
+| `DATALAB_MCP_TOKEN`        | 필수 | —           | 페어링 토큰. 확장 패널에서 발급·폐기. |
+| `DATALAB_MCP_EXTENSION_ID` | 필수 | —           | 연결을 허용할 확장 ID.                |
+| `DATALAB_MCP_PORT`         | 선택 | `8765`      | 수신 포트.                            |
+| `DATALAB_MCP_HOST`         | 선택 | `127.0.0.1` | 바인드 주소. loopback 외 값은 거부.   |
+
+**아키텍처** — 커넥터는 자격증명도 egress도 없는 릴레이입니다. 도구 목록은 확장이 서빙하며 카탈로그 정본은 스토어 심사를 받는 확장 코드입니다. 전송은 루프백 HTTP+SSE이며 Origin 검증과 토큰 검증의 이중 인증을 거치고, 도구 등급 표(조회 / 편집 / 파괴적 / 유료 / 미개방)는 확장 쪽에서 집행됩니다 — 목록에 없는 이름은 거부되고, 파괴적·유료는 세션 허용으로 건너뛸 수 없습니다 — 사용자 절의 "확장 확인"과 "연결 토큰"이 각각에 해당합니다. allowlist 전문(제외 사유 포함)의 정본: <https://github.com/modootoday/datalab-extension-mcp/blob/main/mcp-core/src/allowlist.ts>
+
+**공급망** — 공개 저장소가 전체 소스입니다. npm 발행은 OIDC trusted publishing + provenance로 이루어지고 장기 발행 토큰은 쓰지 않습니다(`npm audit signatures`로 검증 가능). 모든 설치 표면은 정확 버전을 핀하므로, 배포 경로가 손상돼도 새 코드가 자동으로 흘러들지 않고 업그레이드는 항상 사용자의 명시적 선택을 거칩니다.
+
+**라이선스** — MIT ([LICENSE](./LICENSE)).
+
+</details>