AI 에이전트에 YouTube 스크립트 제공: MCP with Claude Code, Codex, and claude.ai

MCP를 통해 YouTube 스크립트에 연결된 AI 에이전트

YouTube 링크를 채팅에 붙여넣고 모델이 비디오를 "알고" 있기를 바라는 것은 작동하지 않습니다. 모델은 비디오를 볼 수 없습니다. 작동하는 것: 에이전트에게 실제 스크립트를 가져오는 도구를 제공합니다. youtube2text.org는 정확히 그것을 수행하는 호스팅된 MCP (Model Context Protocol) 서버를 배송합니다.

엔드포인트: https://youtube2text.org/mcp (스트리밍 가능한 HTTP, 상태 없음). 하나의 도구를 노출합니다:

transcribe_video(url, maxChars?) — {title, content, contentSize, videoId, pubDate, truncated}를 반환합니다.

연결되면 "https://www.youtube.com/watch?v=...을(를) 5개의 요점으로 요약하세요"를 요청하고 에이전트가 스크립트를 자체적으로 가져옵니다.

claude.ai (웹 및 데스크톱)

설정 → 커넥터 → 사용자 지정 커넥터 추가
URL: https://youtube2text.org/mcp
Google 로그인을 완료하고 허용을 클릭합니다.

서버는 동적 클라이언트 등록 및 PKCE를 사용하는 OAuth 2.1을 구현하므로 claude.ai는 전체 핸드셰이크를 자동으로 처리합니다. 주변에 복사할 키가 없습니다. 사용량은 youtube2text 계정 계획에 따라 계산됩니다.

Claude Code

claude mcp add --transport http youtube2text https://youtube2text.org/mcp

그다음 세션 내에서 /mcp를 실행하여 OAuth 로그인을 완료합니다. 그 시점부터 모든 Claude Code 세션은 비디오를 요청할 수 있습니다. 컨퍼런스 대화를 노트 또는 문서로 변환하는 데 좋습니다.

Codex 및 기타 MCP 클라이언트

스트리밍 가능한 HTTP를 사용하는 모든 클라이언트가 연결할 수 있습니다. 클라이언트가 OAuth를 하지 않으면 대신 API 키로 인증하세요. Authorization: Bearer <key> 또는 x-api-key로 보냅니다. 대시보드에서 키를 가져오세요 (GET /api/demo-key에서 공유 데모 키).

Claude API를 직접 호출하시나요? Messages 요청의 mcp_servers 배열에 이를 추가합니다:

{"type": "url", "url": "https://youtube2text.org/mcp", "name": "youtube2text",
 "authorization_token": "<YOUR_API_KEY>"}

OpenAI Responses API를 사용하십시오:

{"type": "mcp", "server_label": "youtube2text",
 "server_url": "https://youtube2text.org/mcp",
 "headers": {"x-api-key": "<YOUR_KEY>"}, "require_approval": "never"}

사람들이 이것으로 구축하는 것

비디오 요약기 — 대화, 강의 및 팟캐스트를 LLM 파이프라인에 공급합니다.
연구 에이전트 — 에이전트가 실제 표현을 인용하도록 하고 말한 것을 환각하지 않도록 합니다.
콘텐츠 재목적 — 스크립트 입력, 블로그 게시물 / 스레드 / 쇼 노트 출력.
채널 위의 RAG — 스크립트를 인덱싱하고 전체 채널에 걸쳐 질문에 답합니다.

평문 REST를 선호하시나요?

동일한 기능은 클래식 HTTP API로 사용 가능합니다. 30초 안에 curl로 YouTube 스크립트 추출을 참조하세요. 에이전트 읽기: 전체 기계 판독 가능 참고는 youtube2text.org/api.md에 있습니다 (인덱스: /llms.txt).