KOLens
로그인무료 시작
Claude · Custom Connector

KOLens를 Claude에 연결

Claude.ai의 Custom Connector 대화창에 URL 하나를 붙여넣고 Approve를 한 번 클릭하세요. 그러면 Claude가 KOL을 검색하고, 오디언스 스냅샷을 가져오고, 광고를 스파이하고, 워치리스트와 알림을 관리할 수 있습니다 — 모두 자연어로. MCP + PKCE를 사용하는 OAuth 2.1을 사용하며, 자격 증명은 절대 kolens.ai를 떠나지 않습니다.

https://kolens.ai/mcp

Claude에 붙여넣을 정확한 URL입니다.

Claude.ai 열기 전체 안내 읽기

30초 설정

  1. 1

    Claude.ai를 열고 Settings → Connectors로 이동합니다.

    Claude Pro, Team, Enterprise에서 사용 가능합니다. 커넥터 목록 하단의 Add custom connector를 찾아주세요.

  2. 2

    https://kolens.ai/mcp을 붙여넣고 Connect를 클릭합니다.

    Claude는 우리의 OAuth 엔드포인트(RFC 9728/8414)를 자동 검색하고 퍼블릭 클라이언트로 동적 등록(RFC 7591)합니다. API 키를 만들거나 시크릿을 다룰 필요가 없습니다.

  3. 3

    동의 페이지에서 KOLens 계정에 로그인합니다.

    https://kolens.ai/oauth/authorize로 이동됩니다. 계정이 없다면 먼저 계정을 만드세요.

  4. 4

    요청된 스코프를 검토하고 Approve를 클릭합니다.

    동의 페이지는 Claude가 요청하는 권한을 정확히 나열합니다 — 보통 read:kols, write:lists, run:scrape입니다. 언제든 계정 → Connections에서 어느 권한이든 철회할 수 있습니다.

  5. 5

    완료 — 쿼리를 시도해 보세요.

    아무 Claude 대화나 열고 다음 중 하나를 물어보세요:

    • “미국에서 팔로워 5만 이상인 핸드폰 케이스 KOL을 검색해 줘.”
    • “@creatorbeta의 오디언스 스냅샷을 가져와.”
    • “@creatoralpha를 내 A-list 워치리스트에 추가해 줘.”
    • “내 rising_kol 알림을 모두 읽음으로 표시해 줘.”

도구 15개, 즉시 사용 가능

디스커버리

  • list_kols — 키워드, 팔로워 수, 참여도, 지역으로 KOL을 필터링합니다.
  • get_kol_profile — 전체 프로필 + 최근 비디오 + 연락처 정보.
  • search_history — 당신(또는 팀)이 최근 검색한 내용.
  • run_scrape — 새 키워드 스크랩 작업을 시작합니다.

오디언스 & 성장

  • get_audience_snapshot — 국가 구성, 언어, 활동 %, 상위 니치(95% 신뢰구간 포함).
  • list_alerts — KOLens가 당신을 위해 표시한 떠오르는 KOL과 트렌딩 비디오.
  • mark_alert_read — 채팅에서 알림을 해제합니다.

광고 스파이

  • list_advertisers — 특정 니치에서 현재 Facebook 광고를 집행 중인 브랜드.
  • get_ad_detail — 한 광고의 전체 페이로드를 가져옵니다 — 카피, 크리에이티브, 집행 기간.
  • list_watches — 저장한 자동 실행 광고 스파이 워치.

리스트 & 워치리스트

  • add_to_list — 나중에 내보내기 위해 KOL을 명명된 리스트에 저장합니다.
  • add_to_watchlist — KOL의 성장 추이를 시간순으로 추적합니다.
  • list_lists — 당신의 KOL 리스트.
  • list_watchlist — 추적 중인 KOL과 변동 델타.
  • remove_from_watchlist — KOL 추적을 중단합니다.

보안

  • OAuth 2.1 + PKCE. 비밀번호는 절대 kolens.ai를 떠나지 않습니다. Claude는 인증 코드를 불투명하고 철회 가능한 액세스 토큰과 교환합니다.
  • 세분화된 스코프. 각 도구는 명시적으로 승인한 스코프에 매핑됩니다. 동의 화면에 이름으로 나열되며 — 숨겨진 접근은 없습니다.
  • 앱별 철회 가능. /account/connections를 방문해 연결된 모든 클라이언트를 확인하고 한 번의 클릭으로 토큰을 철회하세요(RFC 7009).
  • 복사해 둘 장기 시크릿이 없습니다. 토큰은 자동으로 만료되고 갱신됩니다. Custom Connector URL은 조직 내에서 공유해도 안전합니다.

문제 해결

Claude.ai에 “Add custom connector”가 보이지 않습니다.

Custom Connector는 유료 Claude 플랜(Pro, Team, Enterprise)이 필요합니다. Free 등급에서는 옵션이 숨겨집니다. claude.ai/upgrade에서 업그레이드하세요.

동의 페이지에 “Invalid client”가 표시됩니다.

Claude는 커넥터를 추가할 때마다 새 클라이언트를 등록합니다. 이전 등록이 도중에 끊긴 경우(탭 닫기 등) Claude.ai → Settings → Connectors에서 미완성 커넥터를 제거하고 다시 추가하세요. 각 등록은 일회용입니다.

연결 후에도 Claude가 KOLens 도구를 인식하지 못합니다.

Claude 대화를 새로 고치거나 새 대화를 시작하세요 — Claude는 대화 경계에서만 도구 목록을 갱신합니다. 그래도 보이지 않으면 /account/connections에서 연결이 활성 상태인지 확인하세요.

URL https://kolens.ai/mcp 을 직접 방문하면 404가 뜹니다.

예상된 동작입니다. /mcp 는 JSON-RPC 바디가 있는 POST 에만 응답합니다 — 브라우저에 표시할 것이 없습니다. Claude는 백그라운드에서 POST합니다. 엔드포인트가 살아 있는지 확인하려면 새 탭에서 https://kolens.ai/.well-known/oauth-authorization-server 를 열면 — JSON 문서가 보일 것입니다.

이미 연결되어 있나요?

연결된 Claude 클라이언트는 계정 → Connections에서 관리하고 철회할 수 있습니다.

KOLens를 Claude에 연결(MCP + OAuth) — Custom Connector | KOLens