English

데이터랩툴즈 커넥터

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

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

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

준비물

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

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

Related MCP server: ma-browser

네 단계예요

1·3단계는 같은 화면에서 이어집니다. 설정 화면이 지금 어디까지 됐는지 알려 주니, 화면을 열어 둔 채로 따라오시면 돼요.

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

1단계 — 켜기

1. Chrome 오른쪽 위의 데이터랩툴즈 아이콘을 눌러 사이드 패널을 열어요. (안 보이면 퍼즐 조각 아이콘에서 찾을 수 있어요.)

2. 패널 아래쪽 설정을 눌러 확장 설정 화면을 열어요.

3. "다른 AI 앱에 연결 (MCP)" 스위치를 켜요. 동의 화면이 나오면 내용을 읽고 동의해요.

   "연결된 AI 앱이 요청하면 네이버 데이터가 해당 앱과 그 AI 제공사 서버로 전달돼요."

4. 아래에 1 · 2 · 3 번호가 붙은 안내가 펼쳐져요. 1번 [설치 인증키] 칸의 [복사] 버튼을 누르세요(눈으로 확인하고 싶으면 [보기]).

"이 값은 이 컴퓨터 전용 비밀번호예요. 다른 사람에게 보내지 마세요."

캡처 공유·채팅 전송은 피해 주세요. 인증키는 AI 앱 설정과 등록된 브라우저 관리에만 씁니다. 3번의 등록 코드와는 다른 값이라 등록 코드 칸에 붙여넣으면 안 돼요 — 브라우저마다 별도 등록 코드가 발급되고, 그 코드는 만든 직후 한 번만 보여요.

2단계 — 설치

명령 한 줄이면 컴퓨터에 있는 AI 앱을 모두 자동으로 찾아 연결해 줘요. 앱마다 따로 할 일은 없어요.

1. 터미널을 열어요 — Windows는 검색창에 cmd → "명령 프롬프트", Mac은 ⌘+스페이스로 터미널, Linux는 터미널 앱(보통 Ctrl+Alt+T)이에요.

2. 아래 명령을 붙여넣고 Enter를 눌러요. 저장되는 명령은 정확한 시작 버전을 적습니다. 연결 프로그램은 시작할 때와 유휴 상태에서 정본 릴리스를 확인해 현재의 안전하고 호환되는 버전으로 승격합니다. 진단 환경에서는 --no-self-update로 승격을 끌 수 있어요.

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

   영어 글자가 여러 줄 올라오는 건 정상이에요. 이 명령은 연결 프로그램을 다운로드해 실행할 뿐, 다른 건 건드리지 않아요.

   도우미는 네 대목으로 진행돼요 — [1/4] 설치 인증키 확인, [2/4] 연결할 AI 프로그램 찾기, [3/4] 연결하는 중, [4/4] 결과.

3. 설치 인증키를 붙여넣어요. 도우미가 이렇게 물어봐요.

   "복사한 설치 인증키를 붙여넣어 주세요:"

   1단계에서 복사한 값을 붙여넣고 Enter를 눌러요. 형식이 어긋나면 한 번 더 물어봐요.

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

   "위 N개 프로그램에 연결할까요?" (엔터 = 예 / n = 아니오)

   엔터를 누르면 앱별 결과와 함께 N개 프로그램에 연결했어요. 가 나와요. 찾은 앱이 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단계 — 연결

설치가 끝나면 확장 설정 화면의 3번 칸이 바뀌어 있어요. 새로고침하지 않아도 돼요.

• [이 브라우저 연결하기] 버튼이 보이면 그것만 누르면 끝이에요. 등록 코드를 만들어 붙여넣는 과정을 화면이 대신 해 줘요.

• "등록됨" 이 이미 떠 있으면 할 일이 없어요.

• 이 컴퓨터의 다른 브라우저에서 이미 설치했다면 버튼 대신 등록 코드 칸이 나와요. 그 브라우저에서 만든 코드를 넣으세요(아래 이 컴퓨터에 크롬 하나 더 올리기).

등록은 브라우저마다 한 번이에요. 실제 연결은 사이드 패널을 열어 둔 동안 이루어져요.

4단계 — 확인

• 사이드 패널 위쪽 카드가 초록색이고 "연결됨"이 보이면 된 거예요. 초록색이 아니면 문제해결로 가세요.

• AI 앱에서 "지난주 내 블로그 어땠어?" 처럼 물어보고 실제 수치가 나오면 전부 끝이에요.

알아 두면 좋은 것

• 패널이 열려 있는 동안에만 연결돼요. 데이터랩툴즈 사이드 패널을 닫으면 연결도 함께 끊겨요. 다시 열면 자동으로 이어져요.

• 연결 프로그램은 다리일 뿐이에요 — 아이디·비밀번호를 저장하지 않고, 내 컴퓨터 밖에서는 동작하지 않아요.

• 확장이 업데이트되면 새 기능이 자동으로 AI 앱에 나타나요. 연결 프로그램 자체는 그대로예요.

설치된 글쓰기 도움말 고르기

설치할 때 글쓰기 도움말(스킬) 도 함께 놓입니다. AI 앱은 켜질 때마다 설치된 도움말의 이름과 설명을 전부 읽기 때문에, 많이 깔수록 대화에 쓸 자리가 줄어들어요. 그래서 기본은 바로 쓸 수 있는 것만 놓습니다.

npx -y @modootoday/datalab-extension-mcp@1.8.22 skills list
npx -y @modootoday/datalab-extension-mcp@1.8.22 skills status
npx -y @modootoday/datalab-extension-mcp@1.8.22 skills attach <이름>
npx -y @modootoday/datalab-extension-mcp@1.8.22 skills detach <이름>

• list 는 이 버전에 들어 있는 전부를 이름과 설명으로 보여 줘요.

• status 는 지금 내 컴퓨터의 어느 폴더에 무엇이 들어가 있는지 보여 줘요.

• attach / detach 로 하나씩 넣고 뺍니다.

• 설치할 때 전부 원하시면 install 에 --all-skills 를, 아예 원하지 않으시면 --no-skills 를 붙이세요.

기본에서 빠지는 것 3가지 — 사진 편집기·영상 편집기가 열려 있어야 시작하거나, AI 사진 생성처럼 확장 패널에서만 되는 것들이에요. 그 편집기를 쓰신다면 attach 로 넣으시면 됩니다.

다른 도구로 설치한 같은 이름의 도움말이 있으면 건드리지 않고 그렇게 말해요. 뺄 때도 우리가 넣은 파일만 지웁니다.

이 컴퓨터에 크롬 하나 더 올리기

등록은 연결 프로그램이 도는 이 컴퓨터를 기준으로 해요. 크롬 프로필을 여러 개 쓰신다면 프로필마다 등록 코드를 하나씩 만들어 같은 컴퓨터에 올릴 수 있어요. 한 컴퓨터 안에서만 됩니다 — 연결 프로그램은 127.0.0.1 에서만 듣기 때문에 다른 컴퓨터는 닿지 못하고, 코드는 남에게 보낼 것이 아니에요.

확장 설정 → 다른 AI 앱에 연결 (MCP) → 3번 아래의 [다른 브라우저 추가 (선택)] 를 펼쳐 [등록 코드 만들기]를 눌러도 되고, 터미널을 쓰셔도 돼요.

npx -y @modootoday/datalab-extension-mcp@1.8.22 browsers add "회사 크롬"
npx -y @modootoday/datalab-extension-mcp@1.8.22 browsers list
npx -y @modootoday/datalab-extension-mcp@1.8.22 browsers revoke <handle>
npx -y @modootoday/datalab-extension-mcp@1.8.22 browsers repair

add 를 실행하면 설치 인증키를 붙여넣으라고 물어봐요 — 설치할 때와 같은 값이고, 설정 화면 1번의 복사 버튼으로 얻습니다. 그러면 브라우저 등록 코드가 한 번만 출력돼요. 연결 프로그램은 그 코드를 저장하지 않고 지문만 남기므로 다시 보여 줄 수 없어요.

만든 코드는 올릴 크롬을 열고 → 확장 설정 → 다른 AI 앱에 연결 (MCP) → 3. 이 브라우저 등록 칸에 붙여넣습니다. 그 브라우저는 자기 코드를 따로 만들지 않아요.

• list 는 코드 대기(코드는 만들었지만 아직 아무도 안 붙음) · 연결됨 · 연결 끊김 을 구분해서 보여 줘요.

• revoke 뒤에는 그 브라우저가 다시 붙지 못해요. 다시 넣으려면 revoke 한 뒤 새로 add 하세요 — 같은 브라우저에 코드만 새로 줘도 거절돼요.

• list 가 등록부 복구를 안내하면 repair를 실행한 뒤, 영향받은 브라우저에 등록 코드를 새로 발급해 붙여넣으세요. 정상 등록은 유지됩니다.

• 연결 프로그램이 꺼져 있으면 이 명령은 아무것도 하지 않고 그렇게 말해요. 연결해 둔 AI 앱을 켜면 연결 프로그램이 함께 살아납니다.

문제해결

무슨 일이든 첫 질문은 하나예요 — 패널이 열려 있나요? 카드 상태가 "문제 발생"이면 그 아래 빨간 문장을 아래 소제목에서 찾아보세요. 여기 없는 문장이 떴다면 연결 프로그램이 그대로 전해 준 오류예요 — 아래 "위 어느 것도 아닐 때" 의 기록 파일을 보시면 돼요.

"연결을 기다리고 있어요. AI 앱을 켜면 자동으로 연결돼요."

오류가 아니라 정상이에요. AI 앱을 실행하면 자동으로 연결돼요.

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

MCP 를 켜 두었지만 네이버 페이지가 한 곳도 열려 있지 않을 때 나와요. 이 상태에서는 연결 프로그램 자체가 시작되지 않기 때문에, AI 앱을 켜도 연결되지 않아요. 네이버 블로그나 스마트플레이스 같은 페이지를 한 탭 열어 두면 자동으로 연결돼요.

"연결 프로그램이 예전 버전이에요. 새 설정을 AI 앱 설정에 붙여넣고…"

카드의 [새 설정 복사] 버튼을 누르고 안내대로 붙여넣은 뒤, AI 앱을 완전히 껐다가 다시 켜요.

"AI 앱이 예전 설치 인증키를 쓰고 있어요…"

AI 앱이 켜질 때 받은 옛 설치 인증키로 연결 프로그램이 돌고 있어서 그래요. 여기서 [다시 연결하기]는 도움이 안 돼요 — 상대가 계속 같은 옛 코드를 내밀거든요.

1. 카드의 [새 설정 복사] 를 누르고

2. 그 내용을 AI 앱 설정에 붙여넣은 뒤

3. 그 AI 앱을 완전히 종료했다가 다시 켜요 (창 닫기 말고 — Windows 트레이 종료 / Mac ⌘+Q / Linux 앱 메뉴 Quit)

3번까지 해야 연결 프로그램이 AI 앱 설정에 저장된 설치 인증키로 다시 떠요. 브라우저 등록 코드는 이 과정에서 바꾸지 않습니다.

"연결 통로(포트)를 다른 프로그램이 쓰고 있어요."

카드의 [업데이트 명령어 복사] 버튼을 눌러 터미널에 붙여넣어 실행하면 연결 프로그램이 새 설정으로 다시 연결돼요.

"크롬에서 데이터랩툴즈 패널이 닫혀 있어요. 크롬을 열고 데이터랩툴즈 패널을 열어 두면 바로 동작해요."

말 그대로예요. Chrome을 열고 데이터랩툴즈 사이드 패널을 열어 두면 바로 동작해요.

도구가 10개밖에 안 보여요

정상이에요. 일부러 그렇게 보냅니다.

전체 도구는 188개인데, 그걸 전부 목록으로 보내면 AI 앱마다 정해 둔 상한에 걸려요. 어떤 앱은 넘치는 만큼 조용히 잘라내고, 어떤 앱은 아예 연결을 거부해요. 그래서 자주 쓰는 것만 목록에 올리고, 나머지는 AI가 물어보면 답으로 건네줍니다.

그래서 사용하는 데는 차이가 없어요. "우리 매장 리뷰 좀 보여줘" 처럼 목록에 없는 일을 부탁해도, AI가 알아서 목록을 찾아본 뒤 실행해요. 다만 그 한 번을 더 거치니 처음 부르는 도구는 답이 1~2초 늦을 수 있어요.

AI가 "그런 기능은 없다" 고 답하면, "도구 목록을 확인해 보고 다시 답해줘" 라고 한 번 말해 주세요.

카드는 초록색인데 AI 앱이 도구를 못 찾을 때

가장 흔한 경우예요. AI 앱을 완전히 껐다가 다시 켜지 않아서 그래요 — 창만 닫으면 뒤에서 계속 돌고, 그 상태로는 새로 연결된 도구를 못 봐요.

• Windows — 작업 표시줄 오른쪽 아래 트레이 아이콘에서 종료

• Mac — ⌘+Q (창 닫기가 아니라 종료)

• Linux — 앱 메뉴의 Quit, 또는 터미널에서 프로세스 종료

완전히 종료한 뒤 다시 켜면 도구 목록을 새로 읽어요. 그래도 안 보이면 2단계 명령을 한 번 더 실행해 주세요.

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

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

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

• 위 어느 것도 아닐 때 — 연결 프로그램이 무슨 일을 겪었는지 기록해 둬요. 파일 하나만 열어 보면 돼요.

  ~/.datalab-mcp/connector.log

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

안전

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

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

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

• 내 컴퓨터 안에서만 동작해요. 밖에서는 접속할 수 없고, 설치 인증키와 확장 확인이라는 이중 잠금이 걸려 있어요.

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

• 설정에는 정확한 버전이 기록되고, 실행 시 안전한 최신 버전을 확인해요. 연결 프로그램은 시작할 때와 유휴 상태에서 정본 버전을 확인해 최신 보안·호환 버전으로 승격합니다. 특정 버전을 유지해야 하는 진단 환경은 --no-self-update를 사용할 수 있어요.

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

해지

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

   npx -y @modootoday/datalab-extension-mcp@1.8.22 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로 검증 가능). 설치 설정은 정확한 bootstrap 버전을 기록하고, 연결 프로그램은 정본 릴리스로 승격할 때도 같은 검증된 npm 패키지 경로를 사용합니다.

라이선스 — MIT (LICENSE).