Subscribr MCP

유료 Subscribr 계정을 Claude, ChatGPT, OpenClaw, Cursor, VS Code 및 기타 AI 어시스턴트에 MCP를 사용하여 연결하세요. 대화 중에 채널, 스크립트, 아이디어, Intel 리서치, 북마크에 직접 접근할 수 있습니다.

기능

Subscribr는 **모델 컨텍스트 프로토콜(MCP)**을 지원하여 AI 클라이언트가 외부 도구와 데이터에 안전하게 연결할 수 있도록 합니다.

연결되면 AI 클라이언트는 다음을 수행할 수 있습니다:

• Subscribr 워크스페이스에서 데이터 읽기
• Intel에서 YouTube 채널 및 동영상 조회
• Intel 결과 및 스크립트 미리보기를 위한 리치 MCP 앱 카드 열기
• 팀 역할이 허용하는 경우 북마크 추가 또는 아이디어 생성과 같은 쓰기 작업 실행

프롬프트 예시:

• "최신 스크립트 보여줘"
• "홈 트레이닝에 관한 이상치 동영상을 Intel에서 검색해줘"
• "@mkbhd 채널을 조회하고 요약해줘"
• "이 채널을 북마크에 추가해줘"

MCP 접근은 유료 Subscribr 팀에서 사용할 수 있습니다. Intel 도구는 Intel 지원 플랜이 필요하며, 일반 구독 기준으로 현재 Creator 이상에서 이용 가능합니다.

시작하기

메인 앱 내비게이션에서 AI 통합을 여세요. 해당 페이지에서 다음을 확인할 수 있습니다:

• MCP 서버 URL
• 클라이언트별 설정 가이드
• OAuth 우선 연결 지침
• 수동 토큰 기반 클라이언트를 위한 고급 참고 사항

호환 클라이언트

클라이언트 유형	설정 방식
Claude Desktop	가이드 OAuth 설정
Claude.ai	가이드 OAuth 설정
ChatGPT	원격 MCP/커넥터 사용 가능 시 가이드 OAuth 설정
Cursor / VS Code	고급 원격 HTTP MCP 설정
OpenClaw	고급 MCP 브리지 또는 원격 서버 설정
기타 MCP 클라이언트	동일한 서버 URL 사용; 정확한 단계는 클라이언트마다 다름

표준 설정

1단계: Subscribr에서 AI 통합 열기

1. Subscribr에 로그인
2. 메인 내비게이션에서 AI 통합 열기
3. MCP 서버 URL 복사

프로덕션 서버 URL:

https://subscribr.ai/mcp/subscribr

2단계: AI 클라이언트에 Subscribr 추가

AI 클라이언트에서 새 MCP 서버 또는 통합을 추가하고 다음을 사용하세요:

• 서버 URL: https://subscribr.ai/mcp/subscribr
• 전송 방식: 클라이언트가 요청하면 HTTP 또는 Streamable HTTP
• 인증: 클라이언트가 지원하는 경우 OAuth

3단계: OAuth 완료

대부분의 최종 사용자 클라이언트는 자동으로 Subscribr로 리디렉션합니다.

1. 브라우저 창에서 Subscribr에 로그인
2. MCP 연결 승인
3. AI 클라이언트로 돌아가기
4. 새 채팅을 시작하고 Subscribr 도구 사용

클라이언트 참고 사항

Claude Desktop

• 새 통합/서버 추가
• Subscribr MCP URL 붙여넣기
• 브라우저 인증 흐름 완료

Claude.ai

• 통합 열기
• Subscribr MCP URL 추가
• 브라우저에서 OAuth 완료

ChatGPT

• ChatGPT 계정이 지원하는 경우 원격 MCP/커넥터 흐름을 통해 Subscribr 추가
• 동일한 MCP URL 사용
• 브라우저에서 OAuth 완료

Cursor / VS Code

이들은 개발자 중심의 MCP 클라이언트입니다.

• 새 원격 HTTP MCP 서버 추가
• 위의 Subscribr MCP URL 사용
• 요청 시 HTTP 또는 Streamable HTTP 선택
• 클라이언트가 OAuth를 지원하면 사용
• 클라이언트가 수동 베어러 헤더만 지원하는 경우 개인 액세스 토큰 사용

OpenClaw

OpenClaw 설정은 Claude나 ChatGPT보다 더 다양합니다.

• OpenClaw MCP 브리지, 플러그인 또는 원격 서버 설정을 통해 Subscribr 추가
• 동일한 MCP URL 사용
• OpenClaw 설정이 OAuth를 지원하면 OAuth 선호
• 수동 베어러 인증만 지원하는 경우 개인 액세스 토큰 사용

개인 액세스 토큰 (고급)

대부분의 고객은 Claude, Claude.ai 또는 ChatGPT에 토큰이 필요하지 않습니다.

토큰은 OAuth를 잘 지원하지 않는 고급 클라이언트나 로컬 워크플로에만 필요합니다.

중요 제약 사항:

• 토큰은 개발자 페이지에서 관리됩니다.
• 팀 관리자만 토큰을 관리할 수 있습니다.
• 개발자 페이지는 API 지원 플랜이 필요합니다.

클라이언트에 수동 베어러 인증이 필요한 경우 다음을 사용하세요:

Authorization: Bearer YOUR_TOKEN_HERE

사용 가능한 도구

Subscribr는 15개의 고객 도구를 제공합니다.

계정 데이터

도구	기능
my_team	팀 정보, 플랜 상태, 크레딧 및 사용자 정보
my_channels	Subscribr 채널 목록
get_my_channel	특정 채널 세부 정보 조회
my_scripts	스크립트 목록
get_my_script	ID로 전체 스크립트 콘텐츠 조회
my_videos	추적 중인 채널의 동영상 탐색
get_my_video	전체 동영상 세부 정보 및 선택적 스크립트 조회
get_my_channel_ideas	채널의 동영상 아이디어 보기
my_bookmarks	저장된 북마크 목록

YouTube 리서치 (Intel)

도구	기능	필요 플랜
intel_search_channels	Subscribr의 Intel 채널 데이터베이스 검색	Creator 이상
intel_search_videos	Intel에서 이상치 동영상 및 패턴 검색	Creator 이상
get_youtube_channel	핸들, ID 또는 URL로 YouTube 채널 조회	Creator 이상
get_youtube_video	ID 또는 URL로 YouTube 동영상 조회	Creator 이상

작업

도구	기능	필요 권한
generate_ideas	Subscribr 채널에 대한 새 동영상 아이디어 생성	편집자 이상
add_bookmark	YouTube 채널 또는 동영상을 북마크에 저장	편집자 이상

뷰어는 읽기 전용 도구를 사용할 수 있습니다. 쓰기 작업에는 편집자 이상의 접근 권한이 필요합니다.

예시 워크플로

리서치 및 아이디어 구상

1. "식사 준비에 관한 이상치 동영상을 Intel에서 검색해줘"라고 요청
2. "해당 결과에서 상위 채널을 조회해줘"라고 요청
3. "그 패턴에서 영감을 받아 내 채널에 대한 아이디어 5개 생성해줘"라고 요청
4. "나중을 위해 그 채널을 북마크에 추가해줘"라고 요청

스크립트 검토

1. "최근 스크립트 보여줘"라고 요청
2. "첫 번째 스크립트 열어줘"라고 요청
3. AI 어시스턴트와 함께 스크립트를 검토하고 피드백이나 재작성을 요청

경쟁사 리서치

1. "YouTube 채널 @경쟁사핸들 조회해줘"라고 요청
2. "이 틈새 시장과 유사한 동영상을 Intel에서 검색해줘"라고 요청
3. "상위 이상치 동영상이 돋보이는 이유를 요약해줘"라고 요청

문제 해결

"15개 도구가 모두 보이지 않아요"

Intel 도구는 Creator, Automation 또는 Scale이 필요합니다. my_team을(를) 호출하여 현재 플랜 세부 정보를 확인하세요.

"북마크를 추가하거나 아이디어를 생성할 수 없어요"

쓰기 작업에는 팀 내 편집자 이상의 접근 권한이 필요합니다.

"클라이언트에서 인증이 필요하다고 표시돼요"

OAuth 지원 클라이언트의 경우 정상입니다. 브라우저 로그인 및 인증 흐름을 완료하세요.

"클라이언트가 수동 베어러 헤더만 지원해요"

다음 경우에만 개인 액세스 토큰을 사용하세요:

• 팀에 API 지원 플랜이 있는 경우
• 팀 관리자가 토큰을 생성할 수 있는 경우

"연결 실패"

다음을 확인하세요:

1. 서버 URL이 정확히 https://subscribr.ai/mcp/subscribr인지
2. 팀이 유료 플랜에 가입되어 있는지
3. 클라이언트가 로컬 stdio 모드가 아닌 원격 HTTP MCP를 사용하고 있는지

보안 및 개인정보 보호

• 모든 MCP 데이터는 인증된 Subscribr 계정으로 범위가 제한됩니다.
• 자신의 팀 데이터에만 접근할 수 있습니다.
• MCP 요청에는 세션 쿠키 인증이 허용되지 않습니다.
• AI 클라이언트가 비밀번호를 받지 않으므로 OAuth가 선호됩니다.
• 토큰은 개발자 페이지에서 언제든지 취소할 수 있습니다.

AI 에이전트 스킬 및 CLI (Claude Code / Codex / Cursor / OpenClaw)

Claude Code, Codex, Cursor 또는 OpenClaw와 같은 AI 코딩 에이전트를 사용하는 경우, 에이전트에게 Subscribr REST API 사용 방법을 가르치는 스킬 파일을 설치할 수 있습니다. 이 스킬은 인증, 엔드포인트, 일반적인 워크플로 및 전체 API 레퍼런스 링크를 다룹니다.

프로젝트 루트에서 다음 한 줄 명령어로 설치하세요:

npx @giltotherescue/subscribr-cli

이 명령은 .agents/skills/(Codex, Cursor, OpenClaw) 및 .claude/skills/(Claude Code) 모두에 스킬을 설치합니다. 또한 에이전트 스킬 사양을 따르는 다른 모든 에이전트와도 작동합니다. 함께 제공되는 종속성 없는 Python CLI를 설치하려면:

npx @giltotherescue/subscribr-cli --with-cli

CLI는 모든 Subscribr API 엔드포인트를 래핑하며 자동화, 스크립팅 및 AI 에이전트 도구 사용에 유용합니다. GitHub에서 저장소를 확인하세요.

이 스킬은 콘텐츠 생성, 스크립트 생성, 내보내기 및 웹훅을 포함한 전체 플랫폼을 다루는 REST API(Automation 플랜 이상)에 중점을 둡니다. 또한 리서치 및 아이디어 구상을 위한 MCP 도구도 문서화합니다.

앱 내 개발자 페이지의 개요 탭에서 확인할 수 있습니다.

AI 에이전트 스킬은 사용자를 대신하여 API를 호출하는 코딩 에이전트를 위한 것입니다. Claude Desktop 또는 ChatGPT와 같은 대화형 AI 클라이언트의 경우 위에서 설명한 MCP 설정을 대신 사용하세요.

MCP vs REST API

MCP 서버는 AI 채팅 클라이언트 내에서 리서치, 아이디어 구상 및 콘텐츠 검토를 위해 설계되었습니다. 계정 데이터 및 Intel 검색에 대한 읽기 접근과 북마크 추가 및 아이디어 생성과 같은 가벼운 쓰기 작업을 제공합니다.

콘텐츠 생성(스크립트 생성, 개요 생성, 콘텐츠 내보내기, 경쟁사 관리 또는 웹훅 설정)의 경우 REST API를 사용하세요. REST API는 Automation 플랜 이상이 필요하며 개발자 페이지에서 관리됩니다.

다음 단계

• Subscribr에서 /ai-integrations을(를) 열어 AI 클라이언트 연결
• Claude Code 또는 Codex용 AI 에이전트 스킬 설치
• Intel 리서치에 대해 알아보기
• 동영상 아이디어 탐색
• 전체 프로그래밍 방식 접근을 위한 API 문서 확인