본문으로 건너뛰기

AI 영상을 위한 Yoh MCP 서버

원격 MCP 엔드포인트 하나로 어떤 에이전트든 Yoh 스튜디오 전체를 쓸 수 있습니다. 스토리를 쓰고, 캐릭터를 캐스팅해 그리고, 음성과 음악이 들어간 클립 영상을 생성하고, 타임라인과 자막을 편집하고, 렌더링해 게시합니다. 모든 도구는 yoh.app 편집기와 같은 규칙을 따릅니다.

가장 쉬운 방법: AI에게 설정을 맡기세요Claude Code, Codex 또는 Cursor에 프롬프트 하나를 붙여 넣으세요. macOS, Linux, Windows에서 Yoh를 설치하고 로그인까지 안내합니다.

MCP 클라이언트 연결하기

  1. 이 주소를 쓰세요

    Streamable HTTP, OAuth 로그인입니다. www 주소를 그대로 쓰세요. www 없는 yoh.app은 리디렉션되고, 로그인할 때 주소를 확인합니다.

    https://www.yoh.app/api/mcp
  2. Claude Code, Codex, Cursor, ChatGPT

    각 로그인 명령은 브라우저를 열어 Yoh 로그인을 진행합니다. Cursor는 yoh 항목을 ~/.cursor/mcp.json에 합치고 Cursor가 요청할 때 로그인하세요. ChatGPT는 커스텀 MCP 서버를 추가하고 로그인합니다. Claude 데스크톱과 claude.ai는 커스텀 커넥터를 추가합니다.

    Claude Code
    claude mcp add --transport http --scope user yoh https://www.yoh.app/api/mcp
    claude mcp login yoh
    Codex
    codex mcp add yoh --url https://www.yoh.app/api/mcp
    codex mcp login yoh
    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "yoh": {
          "url": "https://www.yoh.app/api/mcp"
        }
      }
    }
  3. 또는 API 키 사용

    로그인할 수 없는 클라이언트, 스크립트, CI용입니다. Settings → API keys에서 필요한 scope로 키를 만들고 Bearer 토큰으로 보내세요.

    .mcp.json
    {
      "mcpServers": {
        "yoh": {
          "type": "http",
          "url": "https://www.yoh.app/api/mcp",
          "headers": { "Authorization": "Bearer ${YOH_API_KEY}" },
          "timeout": 900000
        }
      }
    }
  4. 연결 확인

    에이전트에게 get_credits를 실행해 달라고 하세요. Yoh 크레딧 잔액이 나오면 정상입니다. Claude Code나 Codex에서 /mcp를 실행하면 서버 상태를 볼 수 있습니다.

그다음 요청만 하세요

  • “유령의 목소리를 듣는 야간 근무 간호사 이야기를 60초 영상으로 만들어 주세요.”
  • “이 대본을 5화짜리 시리즈로 만들고, 그림을 그리기 전에 캐스팅부터 보여 주세요.”
  • “3화를 다듬어 주세요. 빈 구간을 잘라 내고 자막을 박자에 맞춘 다음 렌더링 견적을 알려 주세요.”
  • “4번 클립의 주인공을 제 캐릭터로 바꾸고 그 클립 영상만 다시 만들어 주세요.”

잘 작동하는 이유

도구가 다루는 범위

스토리와 시리즈, 에피소드로 나뉘는 대본과 PDF, 캐릭터·배경·아이템, 클립 그림과 영상, 음성과 립싱크, 음악과 효과음, 타임라인(이동, 트림, 분할, 자막, 오버레이), 렌더링, 게시, 템플릿, 크리에이터 고용까지 다룹니다.

승인 없이는 결제되지 않습니다

보기와 편집은 무료입니다. 크레딧이 드는 단계(그림 그리기, 클립 영상 생성, 렌더링)는 모두 먼저 가격을 알려 줍니다. 에이전트가 가격을 보여 주고 승인한 뒤에만 진행하며, 같은 승인으로 두 번 결제되지 않습니다.

범위가 정해진 접근

키와 로그인에는 scope(stories:read, stories:write, stories:generate, series, assets, hires, ads)가 붙습니다. 읽기 전용 에이전트는 어떤 것도 쓰거나 바꿀 수 없습니다.

이어서 진행할 수 있는 긴 작업

생성과 렌더링은 지속형 작업으로 실행됩니다. 한 번 시작하고 get_job이나 get_run으로 상태를 확인하고, cancel_generation으로 멈춥니다. 같은 승인을 다시 보내면 두 번 결제되지 않고 같은 실행에 합류합니다.

자주 묻는 질문

Yoh MCP 서버 주소는 무엇인가요?

https://www.yoh.app/api/mcp(streamable HTTP)입니다. Yoh 계정으로 로그인하거나 API 키를 Bearer 토큰으로 보내세요.

어떤 클라이언트에서 되나요?

원격 HTTP 서버를 지원하는 모든 MCP 클라이언트에서 됩니다. Claude Code, Claude desktop app, claude.ai, Codex, ChatGPT, Cursor, GitHub Copilot을 쓰는 VS Code 등입니다.

MCP 서버는 무료인가요?

연결, 보기, 편집은 무료입니다. 생성과 렌더링에는 Yoh 크레딧이 쓰이며, 유료 단계마다 견적 가격을 명시적으로 승인해야 합니다.

REST API도 있나요?

네. 같은 계정으로 /api/v1의 REST API를 API 키와 함께 쓸 수 있습니다. API 페이지와 문서를 참고하세요.

전체 레퍼런스: Yoh 문서 · 요금

다른 연결 방법