MCP

AI 어시스턴트에서 동영상과 이미지 생성

Model Context Protocol(MCP)을 통해 Seedance 2.0 AI 계정을 AI 어시스턴트에 연결합니다. 대화에서 원하는 내용을 설명하면 어시스턴트가 필요한 크레딧을 안내하고, 확인 후 생성을 요청하여 결과를 전달합니다.

MCP 서버 URL

https://preview.seedance2ai.io/api/mcp

이용 방법

  1. 1

    서버 URL 추가

    AI 어시스턴트의 커넥터 또는 MCP 설정에 위의 MCP 서버 URL을 추가합니다.

  2. 2

    로그인 및 권한 허용

    Seedance 2.0 AI 계정에 로그인하고 접근을 허용합니다. API 키는 필요하지 않습니다.

  3. 3

    요청 내용 설명

    대화에서 동영상이나 이미지를 요청합니다. 어시스턴트는 생성 전에 필요한 크레딧을 확인합니다.

클라이언트별 연결 방법

클라이언트 버전에 따라 메뉴 이름이 다소 다를 수 있습니다.

Claude(웹 및 데스크톱)

무료 요금제에서는 맞춤 커넥터를 1개까지 추가할 수 있습니다. Team 및 Enterprise 요금제에서는 소유자가 먼저 조직 설정(Organization settings) > 커넥터(Connectors)에서 추가해야 합니다.

  1. 맞춤 설정(Customize) > 커넥터(Connectors)를 열고 + 추가(+ Add)에서 맞춤 커넥터 추가(Add custom connector)를 선택합니다.
  2. 이름(예: Seedance 2.0 AI)을 입력하고 MCP 서버 URL을 붙여넣은 후 추가(Add)를 선택합니다.
  3. 연결을 선택하고 Seedance 2.0 AI 계정에 로그인한 후 접근을 허용합니다.
  4. 대화 화면 왼쪽 아래의 +를 선택하고 커넥터(Connectors)에서 해당 커넥터를 켭니다.

ChatGPT

맞춤 MCP 서버를 추가할 수 있는지는 계정 및 워크스페이스 정책에 따라 다릅니다.

  1. 플러그인(Plugins) 페이지(chatgpt.com/plugins)를 열고 +에서 맞춤 MCP 서버 추가(Add custom MCP server)를 선택합니다.
  2. 이름과 설명을 입력하고 연결(Connection)에 MCP 서버 URL을 붙여넣은 뒤, 인증 방식으로 OAuth를 선택합니다.
  3. 위험 안내를 확인한 후 플러그인으로 만들기(Create as a plugin)를 선택하고, Seedance 2.0 AI 계정에 로그인하여 접근을 허용합니다.
  4. 대화에서 @를 입력해 플러그인을 선택한 후 요청합니다.

Gemini

맞춤 앱을 사용하려면 Gemini Spark 이용 자격이 있어야 하며, 만 18세 이상, 미국 거주, 활동 기록(Keep Activity) 사용 설정이 필요합니다. Google은 현재 영어로만 이 기능을 제공합니다.

  1. 설정을 열고 연결된 앱(Connected Apps)을 선택합니다. 일부 버전에서는 개인 맞춤 지능 안에 있습니다.
  2. Spark용 맞춤 앱 항목에 MCP 서버 URL을 붙여넣고 다음을 선택합니다.
  3. Seedance 2.0 AI 계정에 로그인하고 접근을 허용합니다.
  4. Spark로 전환하고 @를 입력해 앱을 선택한 후 요청합니다.

Claude Code

  1. 터미널에서 다음 명령을 실행하여 서버를 추가합니다.
  2. Claude Code에서 /mcp를 실행하고 seedance2ai를 선택해 로그인을 완료합니다.
claude mcp add --transport http seedance2ai https://preview.seedance2ai.io/api/mcp

Codex

  1. 첫 번째 명령을 실행하여 서버를 추가합니다.
  2. 두 번째 명령을 실행하여 로그인하고 접근을 허용합니다.
codex mcp add seedance2ai --url https://preview.seedance2ai.io/api/mcp
codex mcp login seedance2ai

기타 클라이언트(API 키)

  1. 클라이언트가 OAuth 로그인을 지원하지 않는 경우에만 이 방법을 사용합니다.
  2. API 페이지에서 API 키를 만든 뒤 MCP 서버 URL과 함께 Bearer 토큰으로 전달합니다.
  3. 키는 클라이언트의 안전한 자격 증명 설정에 저장하고, 대화에 붙여넣지 마세요.
https://preview.seedance2ai.io/api/mcp
Authorization: Bearer sk_live_…

코딩 에이전트에 설정 맡기기

다음 지시문을 Claude Code 또는 Codex에 보내면 에이전트가 설정 가이드를 읽고 서버를 추가합니다.

Read https://preview.seedance2ai.io/mcp-guide.txt and connect the Seedance 2.0 AI MCP server (https://preview.seedance2ai.io/api/mcp) to this client.

지원 모델

각 모델의 옵션은 웹사이트 및 API와 동일합니다.

  • Seedance 2.5
    동영상
    텍스트, 이미지 또는 참조 미디어로 동영상을 생성합니다. 4~30초, 최대 2K, 사운드 포함. 구매 이력이 필요합니다.
  • Seedance 2.0
    동영상
    텍스트, 이미지 또는 참조 미디어로 동영상을 생성합니다. 4~15초이며 Mini, Fast, Pro 품질 등급을 제공합니다.
  • GPT Image 2.5
    이미지
    텍스트 기반 이미지 생성과 이미지 편집을 지원합니다.
  • GPT Image 2
    이미지
    텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 한 번에 최대 4장까지 생성합니다.
  • Nano Banana Pro
    이미지
    텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 최대 4K로 출력합니다.
  • Nano Banana 2
    이미지
    텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 최대 4K로 출력합니다. 검색 결과를 참고한 생성도 선택할 수 있습니다.
  • Nano Banana 2 Lite
    이미지
    텍스트 기반 이미지 생성과 이미지 편집을 1K로 지원하며, 비용이 가장 낮습니다.

크레딧 및 요금

  • 연결, 잔액 확인, 견적 요청, 작업 상태 확인에는 크레딧이 차감되지 않습니다.
  • 크레딧은 생성을 제출할 때만 웹사이트 및 API와 공유하는 개인 잔액에서 차감됩니다.
  • 생성에 실패하면 크레딧이 자동으로 환불됩니다.
  • 동영상 길이를 자동으로 설정하면 최대 길이만큼 예약하고, 생성 후 사용하지 않은 크레딧을 환불합니다.
  • AI 어시스턴트 구독 요금은 Seedance 2.0 AI 크레딧과 별도로 청구됩니다.

요청 예시

연결 후 다음과 같은 요청을 AI 어시스턴트에 보낼 수 있습니다.

  • Seedance 2.0 AI에서 사용할 수 있는 동영상 및 이미지 모델과 현재 크레딧 잔액을 알려 주세요.
  • Seedance 2.0 Fast 등급으로 5초, 16:9 동영상의 견적을 알려 주세요. 해 질 녘 비 내린 거리를 따라 종이배가 떠내려가는 장면입니다.
  • Nano Banana Pro로 산악 음악 축제용 2K 정사각형 포스터를 만들어 주세요. 생성 전에 필요한 크레딧을 먼저 알려 주세요.
  • 이 풍경 사진을 구름이 천천히 흘러가는 6초 분량의 Seedance 2.5 동영상으로 만들어 주세요: https://example.com/landscape.jpg
  • 가장 최근 작업의 상태를 확인하고, 완료되면 결과 링크를 보내 주세요.

자주 묻는 질문

연결에는 성공했지만 도구를 사용할 수 없습니다. 어떻게 해야 하나요?

로그인을 완료했는지, 현재 대화에서 커넥터가 활성화되어 있는지 확인해 주세요. Claude에서는 + > 커넥터(Connectors)에서, ChatGPT에서는 @를 입력해 플러그인을 선택하여 활성화합니다. 그래도 도구가 표시되지 않으면 새 대화를 시작하거나 다시 연결해 주세요.

API 키가 필요한가요?

Claude, ChatGPT, Gemini, Claude Code, Codex처럼 OAuth 로그인을 지원하는 클라이언트에서는 필요하지 않습니다. API 키는 OAuth를 지원하지 않는 클라이언트에서만 필요합니다.

AI 어시스턴트 연결은 어떻게 해제하나요?

API 페이지의 '연결된 AI 앱'에서 해당 앱 옆의 '연결 해제'를 선택하세요. 접근 권한은 즉시 해제됩니다. 다시 사용하려면 다시 연결하고 접근을 허용해 주세요. 새 연결로 표시됩니다.

다시 연결한 후 이전 작업이 작업 목록에 표시되지 않는 이유는 무엇인가요?

각 연결에는 해당 연결에서 만든 작업만 표시됩니다. 이전 연결에서 만든 작업은 API 페이지의 '최근 API 작업'에서 계속 확인할 수 있습니다.

컴퓨터에 저장된 이미지나 동영상을 사용할 수 있나요?

참조 파일은 공개 HTTPS URL로 접근할 수 있어야 합니다. 직접 링크를 제공하는 서비스에 파일을 업로드한 후 요청에 해당 링크를 포함해 주세요.

어떤 크레딧이 사용되나요?

웹사이트 및 API와 공유하는 개인 크레딧 잔액이 사용됩니다. 팀 크레딧은 사용되지 않습니다.

지금 연결하세요

MCP 서버 URL을 복사하여 AI 어시스턴트에 추가하세요. 연결된 앱은 API 페이지에서 언제든지 관리할 수 있습니다.

API 페이지로 이동