English

데이터랩툴즈 커넥터

Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 무료 프로그램이에요. 연결되면 AI에게 이렇게 물어볼 수 있어요.

"지난주 내 블로그 어땠어?"

그러면 짐작이 아니라 내 네이버 블로그·키워드·광고의 실제 수치로 답해요. 조회는 바로 되고, 고치는 건 물어봐요 — 글쓰기 창이나 편집기를 고치려면 따로 허용해야 하고, 발행은 하지 않아요. 처음이어도 보통 10분이면 끝나요.

준비물

컴퓨터마다 한 번씩만 준비하면 돼요.

회사 컴퓨터는 보안 정책 때문에 설치가 막혀 있을 수 있어요. 시작 전에 회사 IT 담당자와 먼저 상의하면 시간을 아낄 수 있어요.

Related MCP server: mcp-browser-kit

세 단계예요

시작 전에 안심하고 싶다면 아래 안전을 먼저 읽으셔도 좋아요.

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.7.1은 커넥터가 나도 모르게 바뀌지 않도록 고정한 버전이에요.)

   npx -y @modootoday/datalab-extension-mcp@1.7.1 install

   영어 글자가 여러 줄 올라오는 건 정상이에요. 이 명령은 커넥터를 내려받아 실행할 뿐, 다른 건 건드리지 않아요.

3. 연결 토큰을 붙여넣어요. 도우미가 이렇게 물어봐요.

   "복사한 연결 토큰을 여기에 붙여넣어 주세요:"

   1단계 카드에서 복사한 토큰을 붙여넣고 Enter를 눌러요.

4. 연결할지 확인해요. 딱 하나만 물어봐요.

   "위 N개 프로그램에 연결할까요?" (Y/n)

   Y를 누르면 앱별 결과가 나와요. 찾은 앱이 0개면 AI 앱을 먼저 설치한 뒤 같은 명령을 다시 실행하면 돼요.

5. 마지막에 이 안내가 보이면 성공이에요.

   마지막 한 단계: AI 앱을 완전히 종료했다가 다시 실행해 주세요. (Windows: 작업 표시줄 트레이 아이콘에서 종료)

   창만 닫으면 뒤에서 계속 돌 수 있어요. 완전히 종료 후 다시 켜세요 — Windows는 트레이 아이콘에서 종료, Mac은 ⌘+Q, Linux는 앱 메뉴의 Quit.

위 명령이 '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 프로그램을 그 자리에서 골라 설치할 수도 있어요(고르는 건 자유예요).

실행 전에 내용을 확인하고 싶으면 위 주소를 브라우저에 그대로 열어 보세요 — 받아서 실행할 스크립트 원문이 그대로 보여요.

자동으로 연결되는 앱: 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 앱을 실행하면 자동으로 연결돼요.

"네이버 페이지를 열면 연결돼요. MCP 는 네이버 탭이 열려 있는 동안에만 동작해요."

MCP 를 켜 두었지만 네이버 페이지가 한 곳도 열려 있지 않을 때 나와요. 이 상태에서는 커넥터 자체가 시작되지 않기 때문에, 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단계 명령을 한 번 더 실행해 주세요.

• 연결이 사라졌을 때 — 처음 실행했던 그 명령을 한 번 더 실행하면 안전하게 다시 등록돼요. (일부 AI 앱이 설정 파일을 정리하며 연결을 지우기도 해요.)

  npx -y @modootoday/datalab-extension-mcp@1.7.1 install

• 'npx'을(는) 내부 또는 외부 명령... — Node.js가 없는 거예요. 위 2단계의 "Node.js가 없다면" 한 줄 설치가 가장 간단해요.

• 위 어느 것도 아닐 때 — 커넥터가 무슨 일을 겪었는지 기록해 둬요. 파일 하나만 열어 보면 돼요.

  ~/.datalab-mcp/connector.log

  마지막 줄들이 그때 무슨 일이 있었는지 알려 줘요. 너무 커지지 않게 일정 크기가 넘으면 자동으로 넘겨서, 파일은 최대 두 개까지만 생겨요. 도움을 요청할 때 이 파일의 마지막 부분을 같이 보내 주시면 훨씬 빨라요. (조회한 내용이나 글 내용은 들어가지 않아요.)

안전

• 조회는 그냥 되고, 고치는 건 허락받아요. 데이터 조회는 바로 돼요. 네이버 글쓰기 창과 사진·영상 편집기의 내용을 고치려면 사이드패널이나 설정에서 AI 편집 허용을 켜야 해요. 두 가지 중에 고르면 됩니다 — 이번 연결에만 켜면 패널을 닫을 때 다시 꺼지고, 항상 허용으로 저장하면 매번 켜지 않아도 돼요(끄는 것도 같은 자리에서 합니다). 글쓰기 창에서는 제목·본문 넣기와 되돌리기가 열려요. 본문을 통째로 바꾸거나 사진을 넣는 것, 편집기 창을 닫는 것, 지우기나 요금이 드는 기능은 항상 허용으로 저장해 두어도 할 때마다 따로 물어봐요.

• 발행은 하지 않아요. 글을 올리거나 공개하는 기능은 연결되지 않습니다 — 고친 내용은 글쓰기 창에 남고, 올릴지는 사용자가 직접 정해요.

• 아이디·비밀번호·쿠키를 저장하지 않아요. 네이버에 직접 접속하지도 않아요. 모든 조회는 내가 로그인해 둔 내 브라우저 안에서 일어나요.

• 내 컴퓨터 안에서만 동작해요. 밖에서는 접속할 수 없고, 연결 토큰과 확장 확인이라는 이중 잠금이 걸려 있어요.

• 데이터가 나가는 방식 — "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요." 이게 AI가 답하는 방식이라 처음 켤 때 미리 동의를 받아요. 전달된 데이터를 얼마나 보관·학습하는지는 각 AI 제공사 정책을 따르니, 쓰시는 AI 앱의 개인정보 정책을 확인해 주세요.

• 버전은 고정되어 몰래 바뀌지 않아요. 새 버전이 나오면 패널이 알려주고, 바꿀지는 사용자가 정해요.

• 소스가 전부 공개된 오픈소스예요. 다만 이미 같은 권한으로 실행 중인 악성코드까지 막아 주지는 못해요 — 이 커넥터의 잠금은 원격·타 출처 접근을 막는 장치예요.

해지

1. 터미널에서 아래 명령을 실행해요(AI 앱에 등록된 설정을 지워 줘요).

   npx -y @modootoday/datalab-extension-mcp@1.7.1 uninstall

2. 확장 설정에서 MCP 연결을 꺼요. 패널이 브릿지라, 꺼 두면 어딘가 설정 줄이 남아 있어도 AI 앱이 아무것도 조회할 수 없어요.

확장을 삭제해도 남은 커넥터는 즉시 무력해져요. 설정에 남은 한 줄은 위 명령으로 지울 수 있고, 안 지워도 아무 일도 하지 않아요.

자주 묻는 질문

• 유료인가요? 커넥터 자체는 무료이고 소스가 전부 공개된 오픈소스예요. 다만 AI로 사진을 만들거나 영상에 목소리를 넣는 것처럼 요금이 드는 기능이 몇 가지 있고, 그건 실행하기 전에 매번 물어봐요 — 물어보지 않고 요금이 나가는 일은 없어요.

• ChatGPT 웹사이트에서도 되나요? 아니요. 컴퓨터에 설치한 데스크톱 앱만 연결돼요.

• 항상 켜 둬야 하나요? 아니요. 패널이 열려 있을 때만 연결돼요.

• 어떤 데이터를 읽나요? 블로그 통계·키워드·광고 등 데이터랩툴즈가 보여 주는 것들이에요. 기준은 지금 Chrome에 로그인해 둔 네이버 계정이에요.

• 다른 컴퓨터에서도 되나요? 네. 컴퓨터마다 한 번씩 설치하고, 연결 토큰도 컴퓨터마다 따로예요.

개발자 부록

• 저장소: https://github.com/modootoday/datalab-extension-mcp

• npm: https://www.npmjs.com/package/@modootoday/datalab-extension-mcp

환경 변수

호출 한도 — 세션당 10회까지 몰아 부를 수 있고 초당 1회씩 다시 찹니다. 요금 제한이 아니라 폭주 루프 완충용이라 평범한 사용에서는 닿지 않습니다.

실패 응답 — 도구 호출 실패는 프로토콜 오류가 아니라 isError 결과로 오고, 본문은 성공과 같은 JSON입니다(ok / reason / message / retryable, 기다리면 풀리는 경우 retryAfterMs). 실패 코드 전체 목록과 각각의 재시도 여부 정본: https://github.com/modootoday/datalab-extension-mcp/blob/main/mcp-core/src/errors.ts

아키텍처 — 커넥터는 자격증명도 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).