Scrptly Video Generator

←Scrptly의 MCP 서버

Scrptly MCP(Model Connector Protocol) 서버를 사용하면 MCP 인터페이스를 통해 Scrptly를 선호하는 대형 언어 모델(LLM)과 연결할 수 있습니다. 이를 통해 Scrptly의 AI 에이전트를 활용하여 맞춤형 LLM으로 전문적인 비디오를 생성할 수 있습니다.

MCP 서버 설정

다음 구성을 통해 Scrptly의 MCP 서버를 원하는 LLM에 연결할 수 있습니다:

• 엔드포인트 URL: https://mcp.scrptly.com/
• 인증: 인증에는 Scrptly API 키를 사용하세요. 사용되는 인증 방법은 Authorization 헤더의 Bearer Token입니다.

JSON 구성을 요구하는 클라이언트의 경우, 다음은 설정 예시입니다:

{
    "mcpServers": {
        "scrptly-video-generator": {
            "command": "npx",
            "args": ["mcp-remote", "https://mcp.scrptly.com/", "--header", "Authorization: Bearer YOUR_API_KEY_HERE"]
        }
    }
}

MCP 서버 사용

Scrptly의 MCP 서버는 LLM과 Scrptly의 AI 비디오 에이전트 사이의 브리지 역할을 합니다. MCP 서버에 요청을 보내면 LLM이 처리한 프롬프트를 기반으로 비디오를 생성하기 위해 Scrptly의 AI 비디오 에이전트 API를 호출합니다.

Scrptly의 MCP는 현재 다음 도구를 지원합니다:

AI 비디오 생성 — generateAiVideo

텍스트 프롬프트와 선택적 컨텍스트 이미지를 기반으로 비디오를 생성합니다.

입력 매개변수:

• prompt: [string] 비디오 생성을 위한 상세한 텍스트 프롬프트입니다. 비디오의 길이, 시각적 스타일, 줄거리/내용 및 고품질 비디오 생성에 관련된 모든 정보를 포함해야 합니다.
• context: [object 배열] 비디오 생성을 안내하는 선택적 컨텍스트 이미지 배열입니다. 각 이미지에는 URL과 간단한 설명이 있어야 합니다.
• • context[].url: [string] 비디오 생성에 사용할 컨텍스트 이미지의 URL입니다.
• • context[].description: [string] 컨텍스트 이미지에 대한 간단한 설명과 비디오에서 어떻게 사용되어야 하는지에 대한 설명입니다.
• approveUpTo: [number] 사용자가 비디오 생성에 승인한 최대 비용(토큰 단위)입니다. 선택 사항이지만 강력히 권장됩니다. 기본값은 10,000 토큰입니다.

출력 매개변수:

• taskId: [string] AI 비디오 생성을 위해 생성된 작업의 ID입니다.
• projectId: [string] Scrptly에 생성된 AI 비디오 프로젝트의 ID입니다.
• projectUrl: [string] Scrptly에서 생성된 AI 비디오 프로젝트를 보고 관리/조정할 수 있는 URL입니다.

작업 상태 확인 — getTaskStatus

AI 비디오 생성 작업의 상태를 확인합니다.

입력 매개변수:

• taskId: [string] 상태를 확인할 AI 비디오 생성 작업의 ID입니다.

출력 매개변수:

• status: [string] AI 비디오 생성 작업의 현재 상태입니다. 가능한 값은 'awaiting', 'processing', 'success', 'failed'입니다.
• statusMessage: [string] 작업의 현재 상태에 대한 상세 메시지입니다.
• resultVideoUrl: [string] 작업이 성공적으로 완료된 경우 생성된 비디오 파일의 URL입니다.
• projectId: [string] Scrptly에 생성된 AI 비디오 프로젝트의 ID입니다.
• projectUrl: [string] Scrptly에서 생성된 AI 비디오 프로젝트를 보고 관리/조정할 수 있는 URL입니다.