Scrptly Video Generator MCP Server

closeLoginsearchSearchSignup1,000

←Scrptly의 MCP 서버

Scrptly MCP(모델 커넥터 프로토콜) 서버를 사용하면 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: [문자열] 동영상 생성을 위한 상세한 텍스트 프롬프트입니다. 동영상 길이, 시각적 스타일, 줄거리/내용 및 고품질 동영상 생성에 관련된 모든 사항을 포함해야 합니다.
• context : [객체 배열] 동영상 생성을 안내하는 선택적 컨텍스트 이미지 배열입니다. 각 이미지에는 URL과 간략한 설명이 있어야 합니다.
• • context[].url : [문자열] 동영상 생성에 사용될 컨텍스트 이미지의 URL입니다.
• • context[].description : [문자열] 컨텍스트 이미지와 동영상에서의 사용 방법에 대한 간략한 설명입니다.
• approveUpTo : [숫자] 사용자가 동영상 생성에 승인한 최대 비용(토큰 단위)입니다. 선택 사항이지만 사용을 강력히 권장합니다. 기본값은 10,000 토큰입니다.

출력 매개변수:

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

작업 상태 확인 — getTaskStatus

AI 동영상 생성 작업의 상태를 확인합니다.

• taskId: [문자열] 상태를 확인할 AI 동영상 생성 작업의 ID입니다.

• status: [문자열] AI 동영상 생성 작업의 현재 상태입니다. 가능한 값은 'awaiting', 'processing', 'success', 'failed'입니다.

• statusMessage: [문자열] 작업의 현재 상태에 대한 상세 메시지입니다.

• resultVideoUrl: [문자열] 작업이 성공적으로 완료된 경우 생성된 동영상 파일의 URL입니다.

• projectId: [문자열] Scrptly에 생성된 AI 동영상 프로젝트의 ID입니다.

• projectUrl: [문자열] Scrptly에서 생성된 AI 동영상 프로젝트를 보고 관리/조정할 수 있는 URL입니다.