HomeBlogTranscribePlansAPI Keys

Claude API YouTube 스크립트 mcp_servers를 통한

YouTube 스크립트를 가져오는 mcp_servers 블록이 있는 Claude Messages API 요청

Claude API는 요청에서 MCP 서버를 전달하면 YouTube 스크립트를 자체적으로 가져올 수 있습니다. Anthropic의 MCP 커넥터는 Messages API가 원격 서버로 다이얼아웃하고, 도구를 발견하고, 완료 중간에 호출하게 합니다. 당신 측에서 도구 실행 루프가 없습니다. 오늘 youtube2text.org의 호스팅된 MCP 서버에 대해 아래 블록을 확인했습니다.

요청

MCP 커넥터는 베타 기능이므로 anthropic-beta: mcp-client-2025-11-20 헤더가 필요하고, 서로 참조해야 하는 두 절반을 사용합니다. mcp_servers 항목은 연결을 선언하고, tools의 mcp_toolset 항목은 이름으로 접근을 부여합니다. 도구 세트를 생략하면 API는 검증 오류를 반환합니다.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 16000,
    "mcp_servers": [{
      "type": "url",
      "url": "https://youtube2text.org/mcp",
      "name": "youtube2text",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "youtube2text"}],
    "messages": [{
      "role": "user",
      "content": "Summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ in five bullets."
    }]
  }'

두 개의 키가 작동하고 있으며 서로 바꿀 수 없습니다. 헤더의 x-api-key는 Anthropic 키입니다. mcp_servers 내부의 authorization_token은 youtube2text 키입니다. 이는 스크립트 서버에 베어러 토큰으로 전달됩니다. youtube2text.org/app/keys에서 Google 로그인을 통해 얻거나 GET https://youtube2text.org/api/demo-key에서 공유 데모 키를 가져오세요 (IP당 월 5개 비디오).

돌아오는 것

응답 content 배열은 도구 활동을 답변으로 삽입합니다: Claude가 프롬프트에서 추출한 URL로 transcribe_video를 호출하는 mcp_tool_use 블록, {title, content, contentSize, videoId, pubDate, truncated}를 운반하는 mcp_tool_result 블록, 그다음 실제 요약을 포함한 text 블록입니다. Anthropic은 전체 도구 라운드 트립을 서버 측에서 실행합니다. 코드는 하나의 HTTP 요청을 만들고 최종 메시지를 읽습니다.

커넥터가 베타이므로 그에 따라 처리하세요: 헤더는 필수이고 요청 형태는 이미 한 번 변경되었습니다 (이전 쓰기는 mcp_toolset 항목 없이 mcp_servers를 표시합니다. 그 형태는 현재 헤더보다 앞섭니다). 베타 문자열을 핀하고 스크립트가 도착했다고 가정하기 전에 mcp_tool_result 블록의 응답을 확인하세요.

코드 없는 경로

API에 대해 구축하지 않습니까? 두 줄: claude.ai에서 설정 → 커넥터 → 사용자 지정 커넥터 추가로 이동하여 https://youtube2text.org/mcp를 붙여넣고 Google 로그인을 완료하고 허용을 클릭합니다. 서버는 동적 클라이언트 등록 및 PKCE를 사용하는 OAuth 2.1을 사용하므로 claude.ai는 전체 핸드셰이크를 처리합니다. 세부 정보 및 Claude의 무료 YouTube 스크립트에서 수행할 작업을 참조하세요.

Claude Code 사용자는 다음과 함께 동일한 도구를 받습니다:

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

그다음 세션 내에서 /mcp는 로그인합니다.

어느 것을 언제 사용할 것인가

Messages API를 기반으로 제품을 구축하고 기존 에이전트 루프 내에서 스크립트 접근을 원할 때 mcp_servers 블록을 사용하세요. 텍스트만 필요한 경우 REST 엔드포인트를 직접 사용하세요. 스크립트를 Claude를 통해 파이프하여 다시 추출하는 것은 비용이 많이 드는 항등 함수입니다. 스택이 OpenAI 측이면 Responses API는 동일한 MCP 서버를 거의 동일한 블록으로 사용합니다.

사용은 youtube2text 계획에 따라 미터링됩니다: 무료는 월 5개 비디오를 포함하고, 기본은 $5.99/50, pro $9.99/500, 무제한 $19.99입니다. 키는 youtube2text.org/app/keys에 있습니다.