English

데이터랩툴즈 커넥터

Claude 같은 AI 앱을 데이터랩툴즈에 연결해 주는 작은 프로그램이에요. 이 연결에는 AI 앱 연결 표준(MCP)이 쓰여요 — 이름만 알아 두시면 충분해요.

무엇이 되나요?

커넥터를 설치하면, AI 앱이 내 브라우저의 데이터랩툴즈를 통해 네이버 블로그·키워드·광고 데이터를 직접 읽고 답해요.

예를 들어 Claude에게 이렇게 물어볼 수 있어요.

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

그러면 짐작이 아니라 실제 수치로 답해요. 설치의 중심은 명령 한 줄을 복사해 붙여넣는 것이에요 — 아래 순서대로 따라오시면 돼요. 처음 하시는 분도 보통 10분 안팎이면 끝나요.

설치 전에 걱정되는 점이 있다면 아래 안전 절을 먼저 읽으셔도 좋아요.

준비물

컴퓨터마다 한 번씩만 준비하면 돼요. 집과 사무실 컴퓨터를 둘 다 쓰신다면 각각 한 번씩이에요.

| 준비물 | 설명 | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Chrome 브라우저 | 데이터랩툴즈 확장이 동작하는 곳이에요. | | 데이터랩툴즈 확장 | 아직 없다면 app.datalab.tools에서 설치해요. | | Node.js | 커넥터를 실행하는 데 필요한 무료 프로그램이에요. 한 번만 설치하면 돼요. 커넥터는 브라우저 밖에서 AI 앱과 대화해야 해서, 브라우저 확장만으로는 안 되기 때문에 필요해요. nodejs.org에서 받아요 — 영어 사이트가 나오지만 첫 화면의 "LTS"라고 적힌 큰 다운로드 버튼 하나만 누르고, 내려받은 파일을 실행해 설치를 마치면 돼요. | | AI 앱 | 질문을 받을 프로그램이에요. 컴퓨터에 설치하는 앱이어야 해요 — 웹사이트로 쓰는 AI에는 연결할 수 없어요. Claude Desktop은 claude.ai에서 무료로 내려받을 수 있어요. ChatGPT는 데스크톱 앱만 연결돼요 — 웹사이트(chatgpt.com)에서는 쓸 수 없고, 데스크톱 앱은 OpenAI 공식 사이트(openai.com)에서 받아요. |

회사 컴퓨터는 보안 정책 때문에 프로그램 설치가 막혀 있을 수 있어요. 그런 경우에는 시작하기 전에 회사 IT 담당자와 먼저 상의해 주세요 — 중간에 막혀서 시간을 버리는 일을 줄일 수 있어요.

1단계 — 켜기

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

2. 왼쪽 메뉴에서 설정을 눌러요.

3. "다른 AI 앱에 연결 (MCP)" 스위치를 켜요.

4. 켜는 순간 동의 화면이 나와요. 내용을 읽고 동의해요.

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

   이 내용이 궁금하거나 걱정되면 아래 안전 절에 자세히 정리해 두었어요.

5. 패널로 돌아왔을 때 "MCP 연결" 카드가 보이면 성공이에요.

카드에는 연결 토큰이 있어요(보기/숨기기 버튼으로 확인할 수 있어요). 화면의 경고 그대로예요.

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

화면을 캡처해 공유하거나, 채팅으로 보내거나, 복사한 설정 내용을 그대로 전달하는 일은 피해 주세요. 그 밖에 따로 관리하실 일은 없어요. 혹시 이미 노출된 것 같다면 카드의 [다시 연결하기] 버튼을 누르세요 — 새 토큰이 발급되고 예전 코드는 더 이상 쓸 수 없게 돼요.

2단계 — 설치

설치 도우미가 컴퓨터에 설치된 AI 앱을 모두 자동으로 찾아 연결해 줘요. Claude Desktop, Claude Code, ChatGPT 데스크톱, Cursor 등 앱마다 따로 할 일은 없어요.

명령에 붙는 @1.1.0은 버전 번호예요. 커넥터가 나도 모르게 다른 버전으로 바뀌는 일이 없도록 항상 정확한 버전을 고정해요. 새 버전이 나오면 패널이 알려줘요.

설치 도우미는 묻는 대로 붙여넣기만 하면 돼요. 긴 명령을 통째로 복사할 필요 없이, 짧은 명령 하나를 실행하고 연결 토큰만 붙여넣으면 끝나요.

1. 터미널을 열어요. 터미널은 명령어를 입력하는 창이에요. 처음이어도 괜찮아요.

   • Windows: 시작 버튼 옆 검색창에 cmd를 입력하고 "명령 프롬프트"를 눌러요.
   • Mac: 오른쪽 위 돋보기(또는 command+스페이스)를 누르고 터미널을 입력한 뒤 Enter를 눌러요.
   • Linux: 프로그램 목록에서 "터미널(Terminal)"을 실행해요. Ctrl+Alt+T로 열리는 경우가 많아요.

2. 아래 명령을 붙여넣고 Enter를 눌러요.

   npx -y @modootoday/[email protected] install

   붙여넣기는 Windows 명령 프롬프트에서는 마우스 오른쪽 클릭이에요(Ctrl+V가 안 되는 창도 있어요). Mac에서는 command+V, Linux 터미널에서는 Ctrl+Shift+V예요.

   Enter를 누르면 영어 글자가 여러 줄 올라와요 — 잘못된 게 아니라 정상이에요. 이 명령은 커넥터를 내려받아 실행할 뿐, AI 앱 연결 외에는 컴퓨터의 다른 것을 건드리지 않아요.

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

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

   1단계에서 본 "MCP 연결" 카드로 가서 연결 토큰을 복사한 뒤(카드의 보기 버튼으로 확인할 수 있어요), 터미널에 붙여넣고 Enter를 눌러요. 토큰만 있으면 되고, 확장 프로그램 정보는 도우미가 알아서 채워요.

4. 연결할지 확인해요. 도우미가 컴퓨터에 설치된 AI 앱을 자동으로 찾아, 딱 하나만 물어봐요.

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

   Y를 입력하고 Enter를 누르면 앱별 연결 결과가 차례로 나와요. 원하지 않으면 n을 누르세요 — 아무것도 바꾸지 않고 끝나요.

   찾은 앱이 0개라고 나오면 아직 AI 앱이 설치되지 않은 거예요. 준비물의 링크에서 AI 앱을 먼저 설치한 뒤 같은 명령을 다시 실행하면 돼요.

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

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

   창만 닫으면 앱이 뒤에서 계속 실행 중일 수 있어서, 완전히 종료 후 다시 켜는 게 중요해요. Mac에서는 command+Q를 누르거나 Dock의 앱 아이콘을 오른쪽 클릭해 "종료"를 선택해야 완전히 꺼져요.

설치 도우미가 자동으로 연결해 주는 앱: Claude Desktop, Claude Code, ChatGPT 데스크톱, Codex CLI, Gemini CLI, Cursor. ChatGPT 데스크톱과 Codex CLI는 설정을 함께 쓰기 때문에 한 번에 같이 연결돼요. 찾아서 안내문만 보여 주는 앱: VS Code, Zed, Windsurf, JetBrains — 화면의 안내문을 따라 하면 돼요.

3단계 — 확인

• 사이드 패널 위쪽 카드가 초록색이면 연결된 거예요. 상태 배지에 "연결됨"이 보여요.

• 초록색이 아니라면 문제해결 절로 가세요.

• AI 앱에서 시험 질문을 하나 해 보세요.

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

  실제 수치가 나오면 전부 끝난 거예요.

알아 두면 좋은 것

• 데이터랩툴즈 사이드 패널이 열려 있는 동안에만 AI 앱과 연결돼요 — 패널을 닫으면 연결도 함께 끊겨요.
• 커넥터는 다리일 뿐이에요 — 아이디·비밀번호를 저장하지 않고, 내 컴퓨터 밖에서는 동작하지 않아요.
• 확장이 업데이트되면 새 기능이 자동으로 AI 앱에 나타나요 — 따로 할 일이 없어요. (커넥터 프로그램 자체는 그대로예요.)
• 읽기만 해요 — 글 쓰기·수정·삭제는 못 해요.

문제해결

무슨 일이 생겼든, 첫 질문은 항상 같아요 — 패널이 열려 있나요? Chrome에서 데이터랩툴즈 사이드 패널을 먼저 열어 두세요(여는 방법은 1단계와 같아요). 카드의 상태 배지가 "문제 발생"이면 그 아래에 빨간 문장이 함께 보여요 — 그 문장을 아래 소제목에서 그대로 찾으세요. "대기 중"은 오류가 아니에요(첫 항목을 보세요).

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

오류가 아니라 정상 상태예요. AI 앱이 아직 켜져 있지 않을 뿐이에요. AI 앱을 실행하면 자동으로 연결돼요.

"커넥터가 예전 버전이에요. 버튼 한 번이면 새 버전으로 바뀌어요."

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

"연결 토큰이 맞지 않아요. 새 토큰으로 다시 연결해주세요."

카드의 [다시 연결하기] 버튼을 누르면 새 토큰으로 다시 이어져요.

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

다른 프로그램이 같은 통로를 먼저 차지한 경우예요. 카드의 [업데이트 명령어 복사] 버튼을 누르고 터미널에 붙여넣어 실행하면, 커넥터가 새 설정으로 다시 연결돼요.

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

AI 앱 쪽에 이 메시지가 보이면, 말 그대로예요. Chrome을 열고 데이터랩툴즈 사이드 패널을 열어 두면 바로 동작해요.

연결이 어느 날 사라졌어요

처음에 하셨던 그 명령어를 한 번 더 실행하면 돼요. 일부 AI 앱이 자기 설정 파일을 정리하면서 연결을 지우는 경우가 있어요 — 같은 명령이 안전하게 다시 등록해요.

npx -y @modootoday/[email protected] install

'npx'은(는) 내부 또는 외부 명령...

터미널에 이렇게 나오면 Node.js가 아직 설치되지 않은 거예요. 준비물 절의 안내대로 Node.js를 설치한 뒤, 터미널을 새로 열고 다시 시도해요.

안전

설치 전에 이 절부터 읽으셔도 좋아요.

• 읽기 전용이에요. AI 앱은 데이터를 조회만 할 수 있어요. 글 발행·수정·삭제·이미지 생성은 못 해요 — 그 기능들은 데이터랩툴즈 확장 안에서 직접 쓸 때만 동작해요.
• 커넥터는 아이디·비밀번호·쿠키를 저장하지 않아요. 네이버에 직접 접속하지도 않아요. 모든 조회는 내가 로그인해 둔 내 브라우저 안에서 일어나요.
• 내 컴퓨터 안에서만 동작해요. 밖에서는 접속할 수 없고, 연결 토큰과 확장 확인이라는 이중 잠금이 걸려 있어요.
• 데이터는 이렇게 전달돼요. AI 앱이 요청하면, 그 결과가 해당 AI 제공사(예: Anthropic)로 전달돼요. 처음 켤 때 동의 화면에서 확인하신 바로 그 내용이에요 — 이게 AI가 질문에 답하는 방식이라서, 미리 동의를 받아요. 전달된 데이터를 AI 제공사가 얼마나 보관하고 학습에 쓰는지는 각 제공사의 정책을 따라요 — 커넥터가 관여할 수 없는 영역이니, 쓰시는 AI 앱의 개인정보 정책을 확인해 주세요.
• 버전은 고정되어 몰래 바뀌지 않아요. 새 버전이 나오면 패널이 알려주고, 바꿀지는 사용자가 정해요.

해지

두 가지를 하면 깨끗하게 끝나요.

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

   npx -y @modootoday/[email protected] uninstall

2. 사이드 패널에서 **"연동 해제"**를 눌러요. 연결 토큰이 폐기돼요 — 어딘가에 설정 줄이 남아 있어도 즉시 무력화돼요.

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

자주 묻는 질문

유료인가요? 아니요. 커넥터는 무료이고, 소스가 전부 공개된 오픈소스예요.

다른 컴퓨터에서도 쓸 수 있나요? 네. 다만 컴퓨터마다 한 번씩 같은 과정으로 설치해야 해요. 연결 토큰도 컴퓨터마다 따로예요.

ChatGPT 웹사이트에서도 되나요? 아니요. ChatGPT는 데스크톱 앱만 연결돼요. 커넥터는 컴퓨터에 설치된 AI 앱하고만 연결되기 때문에, 웹사이트로 쓰는 AI(chatgpt.com 등)에서는 쓸 수 없어요.

항상 켜 둬야 하나요? 아니요. 데이터랩툴즈 사이드 패널이 열려 있을 때만 연결돼요. 안 쓸 때는 그냥 닫으면 돼요.

어떤 데이터를 읽나요? 블로그 통계·키워드·광고 데이터 등 데이터랩툴즈가 보여 주는 것들이에요. 조회만 하고, 바꾸지는 못해요. 기준은 지금 Chrome에 로그인해 둔 네이버 계정이에요 — 다른 계정 데이터를 보려면 브라우저에서 그 계정으로 로그인한 상태여야 해요.

회사 컴퓨터라 설치가 안 돼요. 관리자 권한이나 회사 보안 정책이 Node.js 설치나 터미널 실행을 막는 경우예요. 회사 IT 담당자에게 문의해 주세요.

개발자 부록

이 절은 npm이나 GitHub에서 소스를 검증하러 온 개발자를 위한 기술 요약입니다. 위의 사용자 절과 달리 기술 용어를 그대로 사용합니다.

소스와 패키지

• 저장소: 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는 확장 쪽에서 집행됩니다. 사용자 절의 "확장 확인"과 "연결 토큰"이 각각 Origin 검증과 토큰 검증에 해당합니다.

allowlist 정의 전문(항목별 제외 사유 포함)은 아래 파일이 정본이며, 집행 주체는 확장입니다: https://github.com/modootoday/datalab-extension-mcp/blob/main/mcp-core/src/allowlist.ts

Claude Code 수동 경로는 내부적으로 claude mcp add datalab --scope user ... 형태로 등록합니다. 전체 명령은 패널 카드가 연결 토큰·확장 ID·정확 버전을 채워 생성합니다. 설치 도우미가 감지·수정하는 앱별 설정 파일 경로는 저장소의 설치 도우미 소스에서 확인할 수 있습니다.

공급망

공개 저장소가 전체 소스입니다. npm 발행은 OIDC trusted publishing + provenance로 이루어지며, 장기 발행 토큰은 사용하지 않습니다. 설치된 패키지의 서명과 provenance는 npm audit signatures로 검증할 수 있습니다.

모든 설치 표면은 정확 버전을 핀하며, 유동 버전 태그는 어떤 표면에도 쓰지 않습니다. 버전이 고정되면 배포 경로 어딘가가 손상되더라도 이미 설치된 사용자에게 새 코드가 자동으로 흘러들지 않고, 업그레이드는 항상 패널의 안내와 사용자의 명시적 선택을 거칩니다. 과도한 방어라기보다는, 자동 갱신 채널을 하나 줄이는 저비용 관행입니다.

정직한 한계

같은 사용자 권한으로 이미 실행 중인 악성코드는 어떤 로컬 방식으로도 막을 수 없습니다. 이 커넥터의 토큰·Origin 검증·loopback 제한은 원격 및 타 출처 접근을 통제하는 장치이지, 이미 침해된 호스트를 복구하는 장치가 아닙니다.

라이선스

MIT — LICENSE 참조.