# 유튜브 협찬 캠페인 관리 (RC-142) MCP 사용 설명서

영역: 고객을 늘리고 더 팔고 싶다

> 에이전트 가이드는 전문가를 대체하지 않습니다. 결과물은 초안이며, 최종 판단과 외부 실행은 사용자와 전문가가 합니다.

## 무엇을 해 주나요
유튜브 채널 협찬 캠페인을 채널 후보 비교, 협찬 기획·제안, 제작·게시 일정, 콘텐츠 검수, 성과 모음까지 한 흐름으로 정리하는 AI 어시스턴트입니다. 사용자가 확인해 붙여넣은 수치만 쓰고, 영상·채널 데이터를 직접 조회하지 않습니다.

결과물: 채널 후보 비교표, 협찬 기획·제안서 초안, 제작·게시 일정표, 콘텐츠 검수 체크리스트, 성과 모음 보고서

성공 기준: 채널 후보 비교표(점수 근거), 제작·게시 일정과 성과 모음 보고서가 내 데이터 행(source_id)을 근거로 만들어지고, 검수 포인트와 "확인 출처·확인일 없는 지표는 점수에서 제외"가 확인된 상태.

## 일반 AI와 다른 점 (MCP + 내 데이터)

- 일반 AI만: 유튜브 채널 후보와 협찬 제안 문구를 만들어 줍니다.
- Recrua MCP: 검증된 채널 지표·캠페인 비용·게시 이력·브랜드 적합도로 조회당 비용과 우선순위를 계산하고 성과를 캠페인별로 모읍니다.

> 모든 고객에게 공용으로 제공하는 전문가·에이전시 데이터셋은 아직 없습니다. 회사별로 승인·등록한 자료만 해당 워크스페이스에서 조회하며, 역할별 계산에는 필요한 데이터 슬롯을 별도로 연결합니다.

### 필요한 내 데이터

- **채널 지표(검증)**: 채널 ID, 구독자, 최근 10개 평균 조회수, 주제, 시청자 국가·연령, 확인 출처, 확인일
- **캠페인 비용**: 채널 ID, 견적, 통화, 제공물, 계약 조건
- **게시·성과 이력**: 채널 ID, 게시일, URL, 7일 조회수, 클릭, 쿠폰 사용
- **브랜드 기준**: 필수 메시지, 금지 표현, 타깃 주제, 타깃 시청자, 예산
- **실집행·귀속 매출(검증)**: 집행 ID, 채널 ID, 집행일, 게시 URL, 실집행 비용, 통화, 귀속 총매출, 귀속 취소·환불 금액, 귀속 기준, 정산일, 검증 출처

### 판단 기준

- 조회당 비용
- 주제·시청자 적합도
- 과거 협찬 성과
- 금지 표현 리스크

### 데이터 근거 결과물

- 채널 후보 비교표(점수 근거)
- 제작·게시 일정과 성과 모음 보고서

### 출처·최신성 점검

- 확인 출처·확인일 없는 지표는 점수에서 제외
- 유료 광고 표시 확인, 발송·계약은 사용자

## 추천 MCP 클라이언트: Claude 데스크톱·웹 사용자 정의 커넥터 또는 Claude Code
문서·점검 업무라 대화형 MCP 클라이언트가 편합니다. Claude 사용자 정의 커넥터는 OAuth(Recrua 로그인 → 작업 공간 승인)로 연결합니다. (연결 방식 기준 추천이며 모델 성능 비교가 아닙니다.)

## 준비물

| 항목 | 필수 | 용도 | 준비 방법 | 단계 | 상태 |
|---|---|---|---|---|---|
| Recrua 계정과 구독 | 필수 | 실행용 | 가입 후 이 에이전트를 포함하는 구독: 개별 구독 월 19,000원(관리 작업 월 50건) · 마케팅·판매 직무 영역 팀 월 99,000원 · 전체 월 990,000원 | 준비 | 구독·권한 필요 |
| MCP 키 (mcp 범위) | 필수 | 실행용 | 구독 후 설정 → 키 발급. 키는 환경 변수로만 넘기고 문서·대화에 붙이지 않습니다 | 준비 | 구독·권한 필요 |
| 내 데이터: 채널 지표(검증) | 필수 | 실행용 | 필요한 열: 채널 ID, 구독자, 최근 10개 평균 조회수, 주제, 시청자 국가·연령, 확인 출처, 확인일. 업무 자료에 CSV로 등록(내 워크스페이스에서만 사용) | 자료 연결 | 사용자가 직접 준비 |
| 내 데이터: 캠페인 비용 | 필수 | 실행용 | 필요한 열: 채널 ID, 견적, 통화, 제공물, 계약 조건. 업무 자료에 CSV로 등록(내 워크스페이스에서만 사용) | 자료 연결 | 사용자가 직접 준비 |
| 내 데이터: 게시·성과 이력 | 필수 | 실행용 | 필요한 열: 채널 ID, 게시일, URL, 7일 조회수, 클릭, 쿠폰 사용. 업무 자료에 CSV로 등록(내 워크스페이스에서만 사용) | 자료 연결 | 사용자가 직접 준비 |
| 내 데이터: 브랜드 기준 | 필수 | 실행용 | 필요한 열: 필수 메시지, 금지 표현, 타깃 주제, 타깃 시청자, 예산. 업무 자료에 CSV로 등록(내 워크스페이스에서만 사용) | 자료 연결 | 사용자가 직접 준비 |
| 내 데이터: 실집행·귀속 매출(검증) | 필수 | 실행용 | 필요한 열: 집행 ID, 채널 ID, 집행일, 게시 URL, 실집행 비용, 통화, 귀속 총매출, 귀속 취소·환불 금액, 귀속 기준, 정산일, 검증 출처. 업무 자료에 CSV로 등록(내 워크스페이스에서만 사용) | 자료 연결 | 사용자가 직접 준비 |

## 입력 예시

- **캠페인 목표·제품·예산·기간** (필수): 가나뷰티 비건 선크림 신제품. 목표: 출시 첫 달 인지도와 자사몰 전환. 총예산 1,800만 원, 2026년 11~12월. 필수 메시지: 백탁 없음, 비건 인증. 금지: 의약품 효능 표현.
- **채널 후보 정보(사용자가 확인한 수치)** (필수): 채널A(뷰티 리뷰) 구독 42만, 최근 10개 평균 조회 9.1만, 견적 650만 원, 과거 선크림 협찬 1회 / 채널B(데일리 브이로그) 구독 18만, 평균 조회 6.4만, 견적 320만 원 / 채널C(피부과 정보) 구독 27만, 평균 조회 3.2만, 견적 480만 원
- **진행 상황·성과 자료(있으면)** (선택): 채널A 12/03 게시, 7일 조회 12.4만, 댓글 830, 고정 댓글 링크 클릭 2,140, 쿠폰 사용 186건 / 채널B 12/10 게시 예정

## 빠진 자료 점검

- 캠페인 목표·제품·예산·기간이(가) 비어 있지 않은지
- 채널 후보 정보(사용자가 확인한 수치)이(가) 비어 있지 않은지
- 확인 출처·확인일 없는 지표는 점수에서 제외
- 유료 광고 표시 확인, 발송·계약은 사용자

## 자료·기준 준비

- 채널 지표(검증): 채널 ID, 구독자, 최근 10개 평균 조회수, 주제, 시청자 국가·연령, 확인 출처, 확인일
- 캠페인 비용: 채널 ID, 견적, 통화, 제공물, 계약 조건
- 게시·성과 이력: 채널 ID, 게시일, URL, 7일 조회수, 클릭, 쿠폰 사용
- 브랜드 기준: 필수 메시지, 금지 표현, 타깃 주제, 타깃 시청자, 예산
- 실집행·귀속 매출(검증): 집행 ID, 채널 ID, 집행일, 게시 URL, 실집행 비용, 통화, 귀속 총매출, 귀속 취소·환불 금액, 귀속 기준, 정산일, 검증 출처
- 공유·사용 권한이 있는 자료만 등록하고, 주민등록번호·계좌번호 등 민감정보는 가립니다.
- 회사 기준은 회사 전문성 팩(업무 절차·판단 기준·양식·사례)에 넣으면 get_agent_context에 함께 전달됩니다.
- 이 역할의 핵심 판단 요소: 판단 기준·계산, 절차·양식, 데이터·DB.

## 작업 순서

1. 캠페인 목표·예산·기간과 필수 메시지·금지 표현을 정리하고 성공 기준(조회·클릭·전환)을 먼저 정한다
2. 채널 후보를 구독자·평균 조회수·주제 적합도·견적·과거 협찬 이력으로 비교하고 조회 1회당 비용을 계산해 우선순위를 매긴다
3. 채널별 협찬 형식(전용 리뷰·브이로그 삽입 등), 핵심 메시지, 제공물, 일정, 견적 조건을 담은 제안서 초안을 만든다
4. 기획·촬영·초안 검수·수정·게시·성과 집계 일정을 채널별로 표로 만든다
5. 초안 영상 검수 체크리스트(필수 메시지, 금지 표현, 유료 광고 표시, 링크·쿠폰)를 만들고, 받은 성과 수치로 채널별 성과 모음을 정리한다

## 넘기기 전 점검

- [ ] 비교표의 숫자가 입력값과 같은지, 입력에 없는 수치를 지어내지 않았는지 확인
- [ ] 조회 1회당 비용 등 계산값의 식과 결과가 맞는지 확인
- [ ] 유료 광고 표시 항목이 검수 체크리스트에 있는지 확인
- [ ] 게시 전 일정과 게시 후 성과 집계 일정이 모두 있는지 확인
- [ ] 제안서 발송·계약 체결을 실행한 것처럼 쓰지 않았는지 확인

## 결과물 소제목

- 캠페인 목표와 성공 기준
- 채널 후보 비교표
- 협찬 기획·제안서 초안
- 제작·게시 일정표
- 콘텐츠 검수 체크리스트
- 성과 모음과 다음 조치

## 결과 예시 (견본, 실제 실행 결과 아님)

비건 선크림 출시 유튜브 협찬 3개 채널 예시

### 채널 후보 비교표
- 채널A | 구독 42만 | 평균 조회 9.1만 | 견적 650만 원 | 조회당 약 71원 | 주제 적합 높음
- 채널B | 구독 18만 | 평균 조회 6.4만 | 견적 320만 원 | 조회당 50원 | 주제 적합 중간
- 채널C | 구독 27만 | 평균 조회 3.2만 | 견적 480만 원 | 조회당 150원 | 의학 정보 채널 — 효능 표현 주의

### 콘텐츠 검수 체크리스트
- [ ] 백탁 없음·비건 인증 메시지 포함
- [ ] 의약품 효능 표현 없음
- [ ] 유료 광고 포함 표시와 고정 댓글 고지
- [ ] 쿠폰 코드·링크 정상

### 성과 모음
- 채널A 7일 조회 12.4만(평균 대비 136%), 클릭 2,140, 쿠폰 186건
- 채널B 게시 예정 — 12/17 7일 성과 집계

## 자주 생기는 문제

- **401 / Recrua 인증이 필요합니다** → OAuth 연결이면 설정 → 연결된 AI 앱에서 연결이 해지되지 않았는지 확인하고 다시 연결합니다. 키 방식이면 Authorization: Bearer 헤더에 mcp 범위 키가 있는지, 키가 폐기되지 않았는지 확인합니다.
- **"현재 구독에 포함되지 않습니다"** → 이 에이전트를 포함하는 구독(개별 구독 월 19,000원(관리 작업 월 50건) · 마케팅·판매 직무 영역 팀 월 99,000원 · 전체 월 990,000원)이 활성인지 확인합니다.
- **prepare_work가 no_data·missing_fields를 돌려줌** → 양식 CSV로 채널 지표(검증), 캠페인 비용, 게시·성과 이력, 브랜드 기준, 실집행·귀속 매출(검증)을(를) 등록하고 사용 설명서의 데이터 연결에서 슬롯과 열을 저장합니다.
- **start_work가 NOT_READY를 돌려줌** → 차단 오류(형식·중복·필수 매개변수)를 고친 뒤 다시 점검합니다. 차감되지 않았습니다.
- **run_agent가 "AI 제공자 미연결"을 돌려줌** → Recrua 서버 AI가 연결되지 않은 상태입니다. 관리 작업의 근거와 서버 계산으로 클라이언트 모델이 작업하면 됩니다(차감 없음).
- **ChatGPT·Claude OAuth 연결이 안 됨** → 서버 URL이 정확히 https://recrua.store/api/mcp인지, 로그인한 Recrua 계정이 이 작업 공간의 구성원인지 확인합니다. 승인 요청은 10분 안에 한 번만 처리됩니다. 연결 뒤 도구 오류는 구독 포함 여부를 확인합니다.

## 첫 호출

```json
{
 "name": "get_kit",
 "arguments": {
  "agent_no": 142
 }
}
```

## 사람이 직접 하는 일

- 유튜브 영상 원본 열람·다운로드나 채널 관리자(스튜디오) 데이터 직접 조회
- 크리에이터에게 제안서 발송·계약 체결·대금 지급
- 조회수·성과 수치를 추정해 사실처럼 기재
- 광고 표시(유료 광고 포함) 의무 판단의 최종 확정
- 유튜브 정책·광고법 위반 여부의 법률 판단
- 외부 발송·제출·게시 (승인 후 사용자가 직접 진행)
- 크리에이터 제안서 발송은 결과 확인 후 사용자가 직접 진행

## 이용 조건

- 구독: 개별 구독 월 19,000원(관리 작업 월 50건) · 마케팅·판매 직무 영역 팀 월 99,000원 · 전체 월 990,000원. 관리 작업 1건은 대화에서 맡긴 업무 1건입니다. 자료 확인·조회·제출·검토·내보내기와 그 업무 안의 계산은 차감하지 않습니다.
- 로그인하면 이 에이전트를 예시 데이터로 1건 체험할 수 있습니다(체험 키 24시간).
- 여러 상품을 함께 구독할 수 있고, 직무 영역·전체 구독이 있으면 개별 구독의 50건보다 우선해 관리 작업 총량 제한 없이 씁니다(남용 방지용 속도 제한은 있음).
- 카드 결제: 가능.
- MCP 클라이언트(Claude·Codex 등) 이용 요금은 Recrua 결제에 포함되지 않습니다.

## AI 어시스턴트 안내

이 에이전트는 업무를 돕는 AI 어시스턴트입니다. 결과의 정확성·완결성이나 최종 확정을 보장하지 않으며, 중요한 판단은 관련 전문가의 검토가 필요합니다.
전문가 상담 연결: /consultation?agent=RC-142&area=%EB%A7%88%EC%BC%80%ED%8C%85%C2%B7%ED%8C%90%EB%A7%A4

## MCP 연결: 연결 준비

Recrua는 MCP로만 씁니다. 웹사이트에서는 구독·키·업무 자료(DB)·전문성 팩을 관리하고, 실제 업무는 MCP 클라이언트에서 유튜브 협찬 캠페인 관리 도구를 불러 진행합니다.

1. **준비 · 구독·키** — 이 에이전트를 포함하는 구독을 하고 설정에서 mcp 범위 키를 발급합니다.
2. **자료 연결 · 데이터 연결·점검** — 연결한 AI가 첨부한 파일에서 채널 지표(검증), 캠페인 비용, 게시·성과 이력, 브랜드 기준, 실집행·귀속 매출(검증) 항목을 뽑아 보여 주고, 확인하면 등록·연결한 뒤 사전 점검(무료)을 통과시킵니다.
3. **실행 · MCP 클라이언트에서 작업** — get_kit(142) → prepare_work → start_work(근거 고정, 관리 작업 1건) → 클라이언트 모델이 채널 후보 비교표 등을 작성해 submit_work.
4. **검수/상담 · 근거 확인** — source_id로 근거를 확인하고 "비교표의 숫자가 입력값과 같은지, 입력에 없는 수치를 지어내지 않았는지 확인"를 점검합니다.

- 가입·로그인 후 요금에서 이 에이전트를 포함하는 상품을 구독합니다.
- ChatGPT·Claude는 OAuth로 연결합니다(Recrua 로그인 → 작업 공간 승인, 키 불필요). Codex·Claude Code는 설정에서 mcp 범위 키를 발급해 RECRUA_API_KEY 같은 환경 변수에 둡니다.
- 업무에 쓸 자료(채널 지표(검증), 캠페인 비용, 게시·성과 이력, 브랜드 기준, 실집행·귀속 매출(검증))는 따로 변환하지 않아도 됩니다. 연결한 GPT·Claude에 파일을 첨부하면 AI가 필요한 항목을 뽑아 보여 주고, 확인하면 작업 공간에 등록합니다(자료 편집 권한 필요).
- 쓰는 MCP 클라이언트 탭(Codex · ChatGPT / Claude Code · Claude)에서 연결 설정을 따라 합니다.
- 연결 후에는 GPT·Claude 창에서 평소처럼 일을 맡기면 됩니다. 자료 점검은 무료이고, 관리 작업을 열 때 1건이 차감되며, 결과는 내 팀에서 검토합니다.

### MCP 서버 (구독·권한 필요)

키 값은 이 화면·다운로드에 넣지 않습니다. 자리표시자를 내 키로 바꾸되 환경 변수로 넘기세요.

```
URL: https://recrua.store/api/mcp
전송 방식: Streamable HTTP (JSON 응답)
인증: OAuth(ChatGPT·Claude, https://recrua.store/api/mcp 그대로 입력) 또는 Authorization: Bearer <설정에서 발급한 mcp 범위 키>
```

### 첫 호출 예 (구독·권한 필요)

구독에 포함되지 않은 에이전트는 오류를 돌려줍니다.

```json
{
 "name": "get_kit",
 "arguments": {
  "agent_no": 142
 }
}
```

## MCP 연결: Codex · ChatGPT

Codex는 공식 문서상 HTTP MCP에 환경 변수의 Bearer 토큰을 쓸 수 있습니다. ChatGPT(웹·앱)는 OAuth로 연결합니다: Recrua 로그인 후 승인 화면에서 작업 공간과 범위를 확인해 허용합니다.

1. **준비 · 구독·키** — 이 에이전트를 포함하는 구독을 하고 설정에서 mcp 범위 키를 발급합니다.
2. **자료 연결 · 데이터 연결·점검** — 연결한 AI가 첨부한 파일에서 채널 지표(검증), 캠페인 비용, 게시·성과 이력, 브랜드 기준, 실집행·귀속 매출(검증) 항목을 뽑아 보여 주고, 확인하면 등록·연결한 뒤 사전 점검(무료)을 통과시킵니다.
3. **실행 · Codex에서 작업** — get_kit(142) → prepare_work → start_work(근거 고정, 관리 작업 1건) → 클라이언트 모델이 채널 후보 비교표 등을 작성해 submit_work.
4. **검수/상담 · 근거 확인** — source_id로 근거를 확인하고 "비교표의 숫자가 입력값과 같은지, 입력에 없는 수치를 지어내지 않았는지 확인"를 점검합니다.

- Codex의 config.toml에 아래 설정을 추가합니다(HTTP 서버는 공식 문서상 config.toml로 설정).
- RECRUA_API_KEY 환경 변수에 설정에서 발급한 mcp 범위 키를 넣습니다. 키를 파일에 직접 쓰지 마세요.
- Codex에서 Recrua 도구 목록이 보이는지 확인한 뒤 get_kit부터 호출합니다.
- ChatGPT: ChatGPT 설정의 앱(커넥터) 메뉴에서 새 MCP 앱을 추가합니다. 메뉴 이름과 사용 가능 여부(개발자 모드 등)는 ChatGPT 요금제·워크스페이스 설정에 따라 다릅니다.
- ChatGPT: MCP 서버 URL에 https://recrua.store/api/mcp를 넣고 인증은 OAuth를 고릅니다.
- ChatGPT: Recrua 로그인 화면이 열리면 기존 Recrua 계정으로 로그인하고, 승인 화면에서 연결할 앱·작업 공간·범위를 확인한 뒤 허용합니다.

### Codex config.toml (공식 문서 기준 · 실제 연결 미검증)

공식 문서 형식입니다. 실제 계정 연결은 이 화면에서 검증하지 않았습니다.
공식 문서: https://learn.chatgpt.com/docs/extend/mcp?surface=cli

```toml
[mcp_servers.recrua]
url = "https://recrua.store/api/mcp"
bearer_token_env_var = "RECRUA_API_KEY"
```

### ChatGPT 웹·앱 (OAuth) (공식 문서 기준 · 실제 연결 미검증)

연결은 설정 → 연결된 AI 앱에서 확인·해지합니다. 도구 사용에는 이 작업 공간의 구독이 필요하고, 체험은 체험 키로만 합니다. 실제 ChatGPT 계정 연결은 이 화면에서 검증하지 않았습니다.
공식 문서: https://developers.openai.com/api/docs/guides/custom-mcp-server

```
MCP 서버 URL: https://recrua.store/api/mcp
인증: OAuth — Recrua 로그인 → 작업 공간 승인
```

## MCP 연결: Claude Code · Claude

Claude 웹·데스크톱 사용자 정의 커넥터는 OAuth(Recrua 로그인 → 작업 공간 승인)로, Claude Code는 --header로 Bearer 키를 넣는 HTTP MCP로 연결합니다.

1. **준비 · 구독·키** — 이 에이전트를 포함하는 구독을 하고 설정에서 mcp 범위 키를 발급합니다.
2. **자료 연결 · 데이터 연결·점검** — 연결한 AI가 첨부한 파일에서 채널 지표(검증), 캠페인 비용, 게시·성과 이력, 브랜드 기준, 실집행·귀속 매출(검증) 항목을 뽑아 보여 주고, 확인하면 등록·연결한 뒤 사전 점검(무료)을 통과시킵니다.
3. **실행 · Claude에서 작업** — get_kit(142) → prepare_work → start_work(근거 고정, 관리 작업 1건) → 클라이언트 모델이 채널 후보 비교표 등을 작성해 submit_work.
4. **검수/상담 · 근거 확인** — source_id로 근거를 확인하고 "비교표의 숫자가 입력값과 같은지, 입력에 없는 수치를 지어내지 않았는지 확인"를 점검합니다.

- Claude Code: 아래 명령으로 HTTP MCP를 추가하고 /mcp로 연결 상태를 확인합니다. 키는 환경 변수로만 넘깁니다.
- Claude 웹·데스크톱: Claude 설정의 커넥터에서 사용자 정의 커넥터를 추가합니다(요금제·조직 권한에 따라 다름).
- Claude 웹·데스크톱: 원격 MCP 서버 URL에 https://recrua.store/api/mcp를 넣고 OAuth로 연결합니다(요청 헤더 불필요).
- Claude 웹·데스크톱: Recrua 로그인 → 승인 화면에서 앱·작업 공간·범위를 확인하고 허용합니다.
- 연결 후 get_kit(142) → prepare_work → start_work로 작업을 열고, 근거 source_id를 인용해 결과를 submit_work로 제출합니다.

### Claude Code 명령 (공식 문서 기준 · 실제 연결 미검증)

공식 문서 형식입니다. 실행 전에 RECRUA_API_KEY 환경 변수를 설정하세요.
공식 문서: https://code.claude.com/docs/en/mcp

```bash
claude mcp add --transport http recrua https://recrua.store/api/mcp \
  --header "Authorization: Bearer $RECRUA_API_KEY"
```

### Claude 사용자 정의 커넥터 (OAuth) (구독·권한 필요)

연결은 설정 → 연결된 AI 앱에서 확인·해지합니다. 도구 사용에는 이 작업 공간의 구독이 필요하고, 체험은 체험 키로만 합니다. Claude 웹에서 운영 서버의 OAuth 로그인과 역할 키트 조회를 확인했습니다. 데스크톱·모바일 연결은 아직 확인하지 않았습니다.
공식 문서: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

```
원격 MCP 서버 URL: https://recrua.store/api/mcp
인증: OAuth — Recrua 로그인 → 작업 공간 승인
```