WantedLived
홈으로

AI 조회 연결 (MCP) 가이드

최종 수정일: 2026년 10월 02일

AI 조회 연결이란?

ChatGPT, Claude, Claude Code, Cursor 같은 AI 앱에서 WantedLived 가 수집한 유튜브 채널 데이터를 대화로 조회할 수 있게 해 주는 연결입니다. AI 앱이 표준 규격인 MCP(Model Context Protocol)로 아래 주소에 접속합니다.

https://wantedlived.com/mcp
  • 읽기 전용입니다. AI 앱은 데이터를 조회만 할 수 있고, 수정하거나 삭제할 수 없습니다.
  • 연결 방법은 두 가지입니다. AI 앱에서 WantedLived 계정으로 로그인해 연결을 허용하는 앱 연결(OAuth), 또는 설정 → AI 연결 (MCP) 에서 발급한 개인 API 키입니다.
  • 로그인한 WantedLived 사용자라면 누구나 쓸 수 있습니다. 연결한 앱과 키는 설정 화면에서 확인하고 언제든 해지할 수 있습니다.

볼 수 있는 데이터

  • WantedLived 가 추적·수집한 유튜브 채널의 데이터입니다: 채널 통계와 추이, 영상, 라이브 방송(동시 시청자·채팅), 채널 간 채팅 시청자 겹침, AI 분석 리포트, 커뮤니티 분위기.
  • WantedLived 서비스 내부 정보(다른 사용자, 결제·구독, 설정 등)는 볼 수 없습니다.
  • 데이터는 주기적으로 수집되므로 유튜브 화면과 시차가 있을 수 있습니다. 시각은 한국 시간(KST, +09:00) 기준입니다.
  • 채팅 교차 분석·커뮤니티 분위기 같은 일부 기능은 운영자가 켜 둔 경우에만 동작합니다. AI 분석 리포트는 무료 플랜에서는 앞부분만 보입니다.

AI 앱은 질문에 맞춰 아래 도구를 골라 씁니다. 도구 이름을 외울 필요는 없습니다.

도구하는 일
list_channels추적 중인 채널 목록 (구독자·조회수·영상 수)
get_channel채널 프로필, 유형별 영상 수(일반·쇼츠·라이브), 최근 업로드, 재생목록, 자주 쓰는 태그
get_channel_history채널 구독자·조회수·영상 수의 일별 추이 (기본 최근 90일)
list_videos채널 영상 목록 — 유형·게시일로 거르고 최신·조회수·좋아요·댓글·최근 조회수 증가 순으로 정렬
get_video영상 상세 정보 (설명, 태그, 라이브 일정, 수집된 댓글 수(답글 포함))
get_video_history영상 조회수·좋아요·댓글 수의 일별 변화
list_lives채널의 라이브 방송 목록 (최고·p95·평균 동시 시청자, 채팅 수, 채팅 참여자, 유료 메시지)
get_live_timeseries라이브 한 편의 동시 시청자·조회수·좋아요·채팅 수 시계열
get_live_chat_stats라이브 채팅 통계 (메시지·참여자 수, 슈퍼챗 합계, 채팅을 많이 한 시청자, 채팅이 몰린 시간)
search_chat_messages라이브 채팅 메시지 검색 (채널·영상·작성자 중 하나 이상 지정)
search_comments유튜브 댓글·답글 검색 (채널·영상·작성자·부모 댓글 중 하나 이상 지정)
search_external외부 수집 글(뉴스·커뮤니티·SNS·공식 홈페이지) 검색과 글 하나의 본문·댓글 (채널·플랫폼·검색어 중 하나 이상, 또는 itemId) — 운영 설정에 따라 꺼져 있을 수 있습니다
get_live_now지금 진행 중인 라이브와 현재 동시 시청자
compare_channels기간별(7일·30일·90일·전체) 채널 간 라이브 성과 비교
get_chat_overlap채널 간 채팅 시청자 겹침 요약과 채널 쌍별 표
list_overlap_viewers여러 채널에서 채팅한 시청자 목록
get_viewer_profile시청자 한 명의 채널별 채팅 활동
get_analysis_report라이브 방송의 AI 분석 리포트
get_sentiment채널별 커뮤니티 분위기(감성) 리포트

동시 시청자의 p95 는 수집한 값 가운데 가장 높은 5% 를 빼고 본 최댓값이라, 잠깐 튄 값에 흔들리는 최고값보다 방송 규모를 더 안정적으로 보여 줍니다.

연결 방법

각 AI 앱의 메뉴 이름과 위치는 제품 업데이트로 바뀔 수 있습니다. 아래와 다르면 비슷한 이름의 메뉴(커넥터, 앱, MCP)를 찾아 주세요.

ChatGPT (웹)

Plus·Pro·Business·Enterprise·Edu 플랜에서 개발자 모드로 연결합니다. 연결은 앱 연결(OAuth)만 지원합니다.

  1. 설정(Settings) → 앱 및 커넥터(Apps & Connectors) 또는 보안(Security) 메뉴에서 개발자 모드(Developer mode)를 켭니다.
  2. 앱(커넥터) 만들기(Create)를 누르고 이름은 WantedLived, MCP 서버 URL 은 https://wantedlived.com/mcp, 인증은 OAuth 를 고릅니다.
  3. 만들기를 누르면 WantedLived 로그인·연결 동의 화면이 열립니다. 연결할 계정과 돌아갈 주소(chatgpt.com)를 확인하고 [허용]을 누릅니다.
  4. 대화창의 도구 메뉴에서 WantedLived 를 켜고 질문합니다.

Business·Enterprise·Edu 워크스페이스는 관리자가 앱을 만들어 게시(publish)해야 구성원이 쓸 수 있습니다. 게시된 앱의 도구 목록은 게시 시점에 고정되므로, 새 도구가 추가되면 관리자가 다시 게시해야 보일 수 있습니다.

Claude (웹·데스크톱)

앱 연결(OAuth)로 연결합니다. Free 플랜은 커스텀 커넥터를 1개까지 추가할 수 있습니다.

  1. 설정(Settings) 또는 사용자 지정(Customize) → 커넥터(Connectors) → 커스텀 커넥터 추가(Add custom connector)를 누릅니다.
  2. 이름은 WantedLived, 원격 MCP 서버 URL 은 https://wantedlived.com/mcp 를 입력합니다. 고급 설정의 OAuth Client ID·Client Secret 칸은 비워 둡니다(자동으로 등록됩니다).
  3. 추가한 뒤 연결(Connect)을 누르면 WantedLived 동의 화면이 열립니다. 돌아갈 주소(claude.ai)를 확인하고 [허용]을 누릅니다.
  4. 대화에서 WantedLived 커넥터가 켜져 있는지 확인하고 질문합니다.

Team·Enterprise 플랜은 조직 소유자(Owner)가 조직 설정에서 커넥터를 먼저 추가해야 구성원이 각자 연결할 수 있습니다. Claude 데스크톱 앱에서도 같은 메뉴(설정 → 커넥터)에서 추가할 수 있습니다.

Claude Code

방법 1 — 앱 연결(OAuth, 권장)

claude mcp add --scope user --transport http wantedlived https://wantedlived.com/mcp

그다음 Claude Code 안에서 /mcp 를 입력하고 wantedlived 를 골라 Authenticate 를 누릅니다. 브라우저에 WantedLived 동의 화면이 열리면 [허용]을 누릅니다.

방법 2 — API 키: 설정 → AI 연결 (MCP) 에서 키를 발급한 뒤 헤더로 넣습니다.

claude mcp add --scope user --transport http wantedlived https://wantedlived.com/mcp --header "Authorization: Bearer wlk_발급받은키"

--scope user 로 추가하면 어느 폴더에서 Claude Code 를 열어도 쓸 수 있습니다. 빼면 명령을 실행한 폴더(프로젝트)에서만 보입니다. 어느 쪽이든 설정은 내 컴퓨터(~/.claude.json)에만 저장되고 저장소에는 들어가지 않습니다. 팀과 공유하는 프로젝트 설정 (--scope project, .mcp.json)에는 키를 직접 쓰지 말고 환경변수 참조를 쓰세요.

{
  "mcpServers": {
    "wantedlived": {
      "type": "http",
      "url": "https://wantedlived.com/mcp",
      "headers": {
        "Authorization": "Bearer ${WANTEDLIVED_MCP_KEY}"
      }
    }
  }
}

Cursor

방법 1 — 앱 연결(OAuth): ~/.cursor/mcp.json 에 아래처럼 추가합니다.

{
  "mcpServers": {
    "wantedlived": {
      "url": "https://wantedlived.com/mcp"
    }
  }
}

저장한 뒤 Cursor 설정의 MCP 메뉴에서 wantedlived 의 연결(Connect)·로그인 버튼을 누르고, 브라우저에 열린 WantedLived 동의 화면에서 [허용]을 누릅니다.

방법 2 — API 키: 키는 설정 파일에 직접 쓰지 말고 환경변수에서 읽게 합니다.

{
  "mcpServers": {
    "wantedlived": {
      "url": "https://wantedlived.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WANTEDLIVED_MCP_KEY}"
      }
    }
  }
}

환경변수는 셸 설정 파일(macOS·Linux 의 ~/.zshrc 등)에 넣고 Cursor 를 다시 시작합니다.

export WANTEDLIVED_MCP_KEY="wlk_발급받은키"

이렇게 물어보세요

  • WantedLived 에서 추적 중인 채널 목록을 보여 줘.
  • ○○ 채널의 최근 90일 구독자 수 변화를 정리해 줘.
  • ○○ 채널에서 지난 7일 동안 조회수가 가장 많이 늘어난 영상 10개는?
  • ○○ 채널의 최근 라이브 5개를 최고·p95·평균 동시 시청자로 표를 만들어 비교해 줘.
  • 어제 ○○ 라이브에서 채팅이 가장 몰린 시간대와 슈퍼챗 합계를 알려 줘.
  • 지금 라이브 중인 채널이 있어?
  • 지난 30일 동안 채널별 라이브 성과를 비교해 줘.
  • 두 채널 이상에서 채팅한 시청자는 몇 명이야?

보안 수칙

  • API 키는 비밀번호와 같습니다. 채팅·스크린샷·이슈·문서에 붙여 넣거나 다른 사람과 공유하지 마세요. 키는 발급할 때 한 번만 보입니다.
  • 키를 코드 저장소에 커밋하지 마세요. 설정 파일에는 키 대신 환경변수 참조(${WANTEDLIVED_MCP_KEY}, ${env:WANTEDLIVED_MCP_KEY})를 쓰세요.
  • 키가 유출됐다고 의심되면 설정 → AI 연결 (MCP) 에서 즉시 해지하고 새로 발급하세요.
  • 키는 만료 기간(30일·90일·365일)을 정해 발급하는 것을 권장합니다. 사용 중인 키는 계정당 최대 10개입니다.
  • 앱 연결(OAuth)도 같은 화면에서 언제든 해지할 수 있습니다. 쓰지 않는 연결은 해지해 두세요.
  • 동의 화면에서는 돌아갈 주소를 꼭 확인하세요. 직접 연결을 시작하지 않았거나 모르는 주소라면 [거부]를 누르세요.
  • 이 연결은 읽기 전용이라 AI 앱이 WantedLived 데이터를 바꿀 수 없습니다. 다만 조회 결과의 채팅·영상 제목·설명은 다른 사람이 쓴 글이므로, 그 안의 문구를 지시처럼 따르지 않도록 결과를 확인하며 쓰세요.

문제 해결

  • 401 · invalid_token · 인증이 필요하다는 오류: 키가 해지·만료됐거나 앱 연결이 끊긴 경우입니다. 앱 연결은 AI 앱에서 다시 연결(재인증)하고, API 키는 새로 발급해 설정을 바꿔 주세요.
  • Rate limit exceeded. Retry after N seconds.: 짧은 시간에 너무 많이 호출했습니다. 안내된 시간만큼 기다린 뒤 다시 시도하세요. 지금 기준으로 키·연결 하나당 도구 호출은 분당 60회, 계정당 시간당 600회까지입니다.
  • Server is busy. Retry shortly.: 같은 계정의 조회가 동시에 여러 개 실행 중입니다. 잠시 후 다시 시도하세요.
  • Query took too long · Result too large: 기간을 좁히거나 가져올 개수를 줄여 다시 물어보세요.
  • This feature is currently turned off by the operator.: 운영자가 그 기능(채팅 교차 분석, 커뮤니티 분위기 등)을 꺼 둔 상태입니다.
  • 연결 자체가 안 되거나 "기능이 꺼져 있다"는 안내가 나올 때: AI 조회 연결 기능이 잠시 꺼져 있을 수 있습니다. 나중에 다시 시도하세요.
  • 서비스 점검·업데이트 뒤 연결이 끊겼을 때: AI 앱에서 WantedLived 커넥터를 다시 연결(재인증)하세요. 그래도 안 되면 커넥터를 지우고 다시 추가하세요.
  • "연결 요청이 올바르지 않습니다" 화면: AI 앱에서 커넥터를 지우고 다시 추가하세요.

이 기능은 WantedLived 이용약관과 개인정보처리방침을 따릅니다.

문의: [email protected]

© WantedLived. All rights reserved.  |  이용약관  |  개인정보처리방침  |  YouTube Terms of Service  |  Google Privacy Policy

Powered by YouTube Data API. YouTube is a trademark of Google LLC.

사업자: WantedLived | 이메일: [email protected]