MCP 서버 만들기 실전: 클로드에 유튜브 데이터 API와 애널리틱스 API를 연결한 기록

핵심 메시지

• MCP는 AI 모델과 외부 서비스를 잇는 표준 규격으로, 서버는 도구 목록만 노출하고 어떤 도구를 언제 부를지는 모델이 스스로 정한다.
• 유튜브 API는 공개 데이터 API와 소유자 인증이 필요한 애널리틱스 API 두 개로 갈리며, 클릭률·시청 지속 시간·트래픽 소스는 후자에만 있다.
• 서버 코드 약 200줄 가운데 대부분은 도구 로직이 아니라 구글 OAuth 처리였다.
• 질문 하나에 클로드가 지시 없이 도구를 네 번 연쇄 호출해 부진한 영상과 이탈 지점을 찾아냈다.
• 하루 할당량, 최대 48시간 지연, 리프레시 토큰 보관 위험이라는 분명한 한계가 있다.

쉽게 이해하기

클로드에게 지난 영상이 왜 부진했는지 물으면 추측밖에 하지 못한다. 클릭률도, 시청 지속 그래프도, 어떤 유입 경로가 실제로 조회수를 만들었는지도 볼 수 없기 때문이다. 그 데이터는 전부 채널 소유자만 로그인할 수 있는 유튜브 스튜디오 안에 있다. 그래서 대부분의 제작자는 대시보드를 캡처해 챗봇에 붙여 넣는 정적이고 수동적인 방식에 머문다.

영상 제작자는 그 대신 클로드가 채널에 직접 손을 뻗어 숫자를 스스로 가져오게 하는 다리를 만들었고, 그 다리가 MCP다. 앤트로픽의 설명대로 기기마다 전용 케이블이 필요하던 시절을 끝낸 USB-C 포트에 가까운 규격이다. 기술적으로 MCP 서버는 이름과 설명과 입력 스키마를 갖춘 도구 목록을 노출할 뿐이고, 그 목록을 읽고 어떤 도구를 언제 부를지 정하는 것은 모델이다. 대부분의 튜토리얼이 건너뛰는 지점이 여기인데, 호출 순서를 사람이 코드로 못 박지 않는다는 것이 이 방식의 핵심이다.

유튜브 API가 하나라고 생각하기 쉽지만 실제로는 완전히 분리된 두 개다. 데이터 API는 공개돼 있어 키만 있으면 조회수·구독자 수·제목·썸네일을 얻을 수 있지만, 평균 시청 시간을 요청하면 권한 오류가 돌아온다. 그 지표는 채널 소유자가 직접 로그인해 권한을 내주는 OAuth 기반의 애널리틱스 API에 들어 있다. 영상은 이를 상점에 비유해 데이터 API는 누구나 볼 수 있는 매대이고 애널리틱스 API는 주인만 열쇠를 가진 뒷방 장부라고 설명한다.

구현은 공식 MCP 타입스크립트 SDK를 썼고, 모든 도구가 이름·입력 스키마·핸들러 함수라는 같은 형태를 따른다. 채널 개요, 최근 영상 목록, 영상별 분석, 두 영상 비교, 상위 유입 경로까지 다섯 개를 정의했으며 각 도구는 산문이 아니라 구조화된 JSON을 돌려준다. 구글 클라우드 프로젝트에서 두 API를 켜고 OAuth 클라이언트를 만들어 ID와 시크릿을 코드가 아닌 환경 파일에 두었는데, 애널리틱스 API를 켜지 않아 첫 인증 시도는 실패했다. 마지막으로 클로드 데스크톱 설정 파일에 서버 실행 명령을 가리키는 JSON 블록 하나를 등록하자 재시작과 함께 도구 다섯 개가 자동으로 나타났다.

실제 질문은 하나였다. 최근 영상 열 개 중 어느 것이 부진했고 이유가 무엇이냐고 묻자 클로드는 최근 영상 목록을 부르고, 시키지도 않았는데 열 개 각각의 분석을 하나씩 호출한 뒤, 가장 낮은 두 개를 비교하는 도구까지 스스로 불렀다. 답은 1분 안에 돌아왔는데 클릭률은 6.2%로 높았지만 평균 시청 시간이 50초 지점에서 무너졌고, 그 시각이 내레이션에서 소리 없는 코드 녹화 화면으로 바뀌는 대목과 정확히 겹쳤다. 한계도 분명하다. 데이터 API 기본 할당량은 하루 1만 유닛이고 검색 호출 한 번이 100유닛을 쓰며, 애널리틱스 수치는 보통 최대 48시간 지연되고, 리프레시 토큰을 가진 사람은 누구든 비공개 데이터를 조회할 수 있다.

주요 인사이트

• 이 프로젝트의 성과는 유튜브에 관해 말하는 챗봇이 아니라 유튜브를 읽는 도구를 만든 것이다. 대시보드가 못 보여준 것은 데이터가 없어서가 아니라 지표와 대본을 이어 볼 방법이 없어서였다.
• 도구가 문장이 아니라 구조화된 JSON을 돌려주도록 한 선택이 추론 품질을 좌우했다. 모델은 산문보다 구조화된 데이터 위에서 더 잘 판단한다.
• 호출 순서를 코드로 고정하지 않은 것이 결정적이었다. 비교하라고 지시하지 않았는데도 모델이 다음 단계로 비교를 택했다.
• 가장 어려운 부분은 AI 연동이 아니라 구글 OAuth였다. 그래서 읽기 전용 키로 도구 세 개를 먼저 굴려보고 인증을 나중에 붙이는 순서가 권장된다.
• 리프레시 토큰은 사실상 비밀번호다. 설정 파일에 하드코딩하지 않고 환경 변수로 두며 저장소에 올리지 않아야 한다.

자주 묻는 질문

관련 AI 소식