deepneedle.com

DeepNeedle Insight

이제 AI 도구에서
DeepNeedle에 바로 묻습니다

DeepNeedle Insight를 MCP로 연결하면, 쓰던 AI 도구에서 대화하듯 우리 사이트의 추천 성과를 조회합니다. 이 주소는 그 연결에 쓰는 데이터 조회 서버입니다.

읽기 전용사이트별 권한OAuth 로그인
  1. 01연결명령 한 줄로 AI 도구에 추가합니다.
  2. 02로그인권한이 있는 사이트만 조회되도록 로그인합니다.
  3. 03질문평소 말투로 묻습니다.

이렇게 물어볼 수 있습니다

볼 수 있는 데이터

추천 성과
추천을 거친 주문과 그렇지 않은 주문의 매출, 주문 수, 전환율을 일별·월별로 봅니다.
추천 영역별 성과
어느 추천 영역이 조회와 매출에 기여했는지 영역 단위로 봅니다.

연결하는 방법

두 가지 중 하나를 고르면 됩니다. 아래 명령은 Claude Code 기준입니다.

먼저 Claude Code 설치

Claude Code가 이미 설치돼 있으면 건너뛰세요. 터미널에서 claude --version을 입력해 버전 번호가 나오면 설치된 것입니다.

  1. 터미널을 열고 쓰는 컴퓨터에 맞는 설치 명령을 붙여 넣습니다.

    macOS, Linux (터미널)

    curl -fsSL https://claude.ai/install.sh | bash

    Windows (PowerShell)

    irm https://claude.ai/install.ps1 | iex
  2. 설치가 끝나면 터미널 창을 새로 열고 claude를 실행합니다. 브라우저가 열리면 Claude 계정으로 로그인합니다.

Claude Code는 Claude 유료 요금제(Pro, Max, Team, Enterprise 등) 계정이 있어야 쓸 수 있습니다. 무료 요금제로는 쓸 수 없습니다. 다른 설치 방법(Homebrew, WinGet 등)과 문제 해결은 Claude Code 설치 안내를 참고하세요.

방법 1. DeepNeedle 어드민 계정으로 로그인 (토큰 없이)

  1. 터미널에서 주소를 등록합니다. 처음 한 번만 하면 됩니다.
claude mcp add --transport http deepneedle-insight https://insight.deepneedle.com/mcp
  1. 터미널에서 claude를 실행합니다.
  2. 입력창에 /mcp를 입력하고 Enter를 누릅니다. 연결된 서버 목록이 나오고, deepneedle-insight에는 인증이 필요하다는 표시가 붙어 있습니다.
  3. 화살표 키로 deepneedle-insight를 골라 Enter를 누릅니다.
  4. 메뉴에서 Authenticate(인증)를 골라 Enter를 누릅니다.
  5. 브라우저에 DeepNeedle 어드민(admin.deepneedle.com) 로그인 화면이 열립니다. 평소 쓰는 계정으로 로그인하고 허용을 누릅니다.
  6. 브라우저에 완료 안내가 나오면 터미널로 돌아갑니다. 목록에서 deepneedle-insight가 연결됨으로 바뀌어 있으면 Esc로 닫고 바로 질문하면 됩니다.

브라우저가 열리지 않으면 터미널에 나온 주소를 복사해 브라우저에 붙여 넣으세요. 메뉴 이름은 Claude Code 버전에 따라 조금 다를 수 있습니다.

토큰을 발급받거나 복사할 필요가 없습니다. 연결은 자동으로 갱신되며, 30일 동안 쓰지 않으면 같은 방법으로 다시 인증하면 됩니다. 로그인 연결은 담당자가 사이트에 이 서비스를 켜 둔 경우에만 됩니다. 허용을 눌러도 연결되지 않으면 담당자에게 문의해 주세요.

방법 2. 토큰으로 연결

  1. DeepNeedle 어드민의 서비스 → API KEY 관리에서 토큰을 발급받습니다. 메뉴가 보이지 않으면 담당자에게 요청해 주세요.
  2. 쓰는 도구에 아래 주소와 토큰을 등록합니다.
claude mcp add --transport http deepneedle-insight https://insight.deepneedle.com/mcp \
  --header "Authorization: Bearer <토큰>"

MCP(Model Context Protocol)의 HTTP 방식을 지원하는 다른 도구에도 같은 주소로 연결할 수 있습니다. 로그인(OAuth)을 지원하면 방법 1, 요청 헤더를 넣을 수 있으면 방법 2를 씁니다. Gemini와 ChatGPT는 아래에 따로 안내합니다. claude.ai 웹·앱의 커넥터 연결은 아직 확인 중입니다.

Gemini, ChatGPT에서 연결하기

주소는 같습니다. 로그인하면 DeepNeedle 어드민 계정으로, 토큰을 쓰면 어드민에서 발급받은 토큰으로 연결됩니다.

Gemini CLI

Gemini Code Assist Standard·Enterprise 라이선스나 유료 Gemini API 키로 Gemini CLI를 쓰는 경우입니다. 개인 요금제(Google AI Pro·Ultra)를 쓰면 아래 Antigravity CLI를 보세요.

  1. 터미널에서 주소를 등록합니다. 처음 한 번만 하면 됩니다.
gemini mcp add --transport http -s user deepneedle-insight https://insight.deepneedle.com/mcp
  1. 터미널에서 gemini를 실행하고, 입력창에 /mcp auth deepneedle-insight를 입력합니다.
  2. 브라우저에 DeepNeedle 어드민 로그인 화면이 열립니다. 로그인하고 허용을 누른 뒤 터미널로 돌아가 질문하면 됩니다.

토큰으로 연결하려면 1번에서 아래처럼 등록하고 2·3번은 건너뜁니다.

gemini mcp add --transport http -s user \
  -H "Authorization: Bearer <토큰>" deepneedle-insight https://insight.deepneedle.com/mcp

Antigravity CLI

설정 파일 ~/.gemini/config/mcp_config.json에 아래 내용을 넣고 Antigravity CLI를 다시 시작합니다. 파일에 다른 서버가 이미 있으면 mcpServers 안에 deepneedle-insight 항목만 추가합니다.

{
  "mcpServers": {
    "deepneedle-insight": {
      "serverUrl": "https://insight.deepneedle.com/mcp",
      "headers": { "Authorization": "Bearer <토큰>" }
    }
  }
}

지금은 토큰으로 연결하는 방법만 안내합니다. 로그인으로 연결하는 방법은 확인 중입니다.

ChatGPT (확인 중)

  1. chatgpt.com 웹에서 Plugins로 들어가 + 버튼을 누르고 Add custom MCP server를 고릅니다.
  2. 이름을 넣고 Server URL에 https://insight.deepneedle.com/mcp를 넣습니다. 인증은 OAuth를 고르고 Create as a plugin을 누릅니다.
  3. 연결을 시작하면 DeepNeedle 어드민 로그인 화면이 열립니다. 로그인하고 허용을 누릅니다.

ChatGPT 유료 요금제에서만 직접 서버를 추가할 수 있고, 회사 워크스페이스는 관리자가 이 기능을 막아 둘 수 있습니다. 토큰으로는 연결할 수 없습니다. 아직 연결을 확인하는 중이라 되지 않을 수 있습니다. 메뉴 이름은 ChatGPT 화면에 따라 조금 다를 수 있습니다.

Gemini 웹·앱

gemini.google.com의 맞춤 앱 연결은 아직 일부 개인 계정에만 열려 있어 안내하지 않습니다.

주소

MCPhttps://insight.deepneedle.com/mcp
RESThttps://insight.deepneedle.com/api/tools 도구 목록, https://insight.deepneedle.com/api/tools/<도구> 실행
인증모든 요청에 Authorization: Bearer <토큰> 헤더. 로그인으로 연결하면 도구가 이 헤더를 알아서 붙입니다
OAuthhttps://insight.deepneedle.com/.well-known/oauth-authorization-server

알아두실 점