HomeBlogTranscribePlansAPI Keys

OpenAI Responses API MCP: GPT-5를 위한 YouTube 스크립트

원격 MCP 서버에 연결하여 YouTube 스크립트를 가져오는 OpenAI Responses API

OpenAI Responses API는 원격 MCP 서버를 직접 호출할 수 있습니다. tools에 서버를 선언하면 모델이 도구를 발견하여 자동으로 호출합니다. youtube2text.org의 MCP 서버를 연결하면 GPT-5는 대화 중 어떤 YouTube 스크립트든 한 줄의 fetch 코드도 작성하지 않고 가져올 수 있습니다. 오늘 gpt-5에 대해 이 정확한 설정을 테스트했고, 아래 설정을 그대로 복사하여 사용할 수 있습니다.

tool 블록

이것이 전체 통합 내용입니다:

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

headers 필드는 youtube2text API 키를 모든 호출에서 서버에 전달합니다. require_approval: "never"는 인간 승인 라운드 트립을 건너뜁니다. 여기서 합리적인데, 유일한 도구가 읽기 전용 스크립트 fetch이기 때문입니다. youtube2text.org/app/keys에서 Google 로그인을 통해 키를 얻거나, GET https://youtube2text.org/api/demo-key에서 공유 데모 키를 가져올 수 있습니다 (IP당 월 5개 비디오).

Python 전체 예제

from openai import OpenAI

client = OpenAI()

resp = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "youtube2text",
        "server_url": "https://youtube2text.org/mcp",
        "headers": {"x-api-key": "YOUR_KEY"},
        "require_approval": "never",
    }],
    input="Summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ "
          "in five bullet points.",
)

print(resp.output_text)

이게 전부입니다. 스크립트 fetch 코드, 파싱, 프롬프트 조합이 없습니다. 모델이 스크립트가 필요하다고 결정하고 도구를 호출하며 결과를 읽고 요약을 작성합니다.

내부적으로 무슨 일이 일어나는가

resp.output을 살펴보면 메커니즘이 보입니다:

  1. 먼저 mcp_list_tools 항목이 나타납니다. Responses API가 https://youtube2text.org/mcp에 연결되어 도구 매니페스트를 가져왔습니다. 우리의 경우 transcribe_video(url, maxChars?)라는 단일 도구이며, {title, content, contentSize, videoId, pubDate, truncated}를 반환합니다. 이 가져오기는 대화당 한 번 일어나고 후속 턴에서 캐시됩니다.
  2. 모델이 호출하기로 결정하면 선택한 인수({"url": "https://www.youtube.com/watch?v=..."})를 포함한 mcp_call 항목이 나타나고, 서버가 응답하면 전체 도구 출력이 표시됩니다.
  3. 마지막으로 모델의 답변이 포함된 일반 message 항목이 있으며, 이것이 output_text가 제공하는 것입니다.

서버는 스트리밍 가능한 HTTP이고 상태가 없으므로 관리할 세션 핸드셰이크가 없습니다. 각 호출은 독립적입니다. 비디오에 자막이 없으면 도구는 TRANSCRIPT_UNAVAILABLE 오류를 반환하며, 모델은 실행을 중단하지 않고 일반 영어로 이를 전달합니다.

알아두면 좋은 한 가지 특성

GPT-5는 스크립트에서 요약하고, 분석하고, 짧은 조각을 인용하는 것을 기꺼이 합니다. 긴 그대로의 구절을 재현하도록 요청하면 거부할 수 있습니다. OpenAI의 저작권 보호 조치가 타사 콘텐츠의 확대된 단어 단위 재현에 작동합니다. 오늘의 테스트에서 요약, 주제 추출, Q&A는 모두 마찰 없이 작동했습니다. "전체 스크립트를 다시 제공해줄래"는 그렇지 않았습니다. 원본 텍스트가 필요하면 모델을 완전히 건너뛰고 curl로 REST 엔드포인트를 hit하세요. 그렇지 않으면 자신의 API 응답을 세탁하기 위해 토큰을 지불하는 것입니다.

비용 참고

스크립트는 큽니다. 한 시간의 말하기는 약 8,000-10,000 단어이며, 모두 도구 출력으로 GPT-5의 컨텍스트에 들어가고 입력 토큰으로 청구됩니다. 대량으로 요약하는 경우 프롬프트 지시에서 maxChars를 전달하거나 (모델이 도구 인수로 전달) 더 저렴한 것으로 전처리합니다.

동일한 서버, 다른 클라이언트

동일한 MCP 엔드포인트는 Claude와 함께 작동합니다. Messages API mcp_servers 블록을 통하거나 claude.ai 커넥터 및 Claude Code에서, 따라서 하나의 youtube2text 키가 전체 에이전트를 커버합니다.

키와 계획 (월 5개 무료부터 $19.99의 무제한까지)은 youtube2text.org/app/keys에 있습니다.