2026-09-26에이전트

Sume MCP vs CLI vs API: AI 에이전트는 무엇을 쓸까

Sume에서 AI 에이전트의 주 경로는 HTTP와 Format API입니다. 호스팅 MCP는 원격 MCP 클라이언트에 맞고, CLI는 셸 에이전트에 맞으며 Avatar 중심입니다.

읽는 시간 6분Sume

Sume에서 AI 에이전트의 주 경로는 HTTP입니다. 문서가 대부분의 파트너가 연동해야 할 표면이라고 부르는 Format API, 그리고 직접 호출하거나 TypeScript SDK로 호출하는 Developer API가 여기에 해당합니다. https://mcp.sume.com/mcp의 호스팅 MCP는 원격 MCP를 지원하는 에이전트 클라이언트에, Sume CLI는 셸 명령어를 실행하는 에이전트에 맞습니다. 문서에 따르면 둘 다 여전히 동작하지만 현재 주 경로는 아닙니다.

아래 비교는 Sume의 Agents, Sume 기초, MCP 개요, CLI 개요 페이지를 바탕으로 하며, 2026-09-26에 확인했습니다.

API, 호스팅 MCP, CLI는 서로 어떤 관계인가요?

영상 에이전트란 무엇인가요?에서 설명하듯, Sume 개발자 도구는 공개 API라는 하나의 경계를 씁니다. 달라지는 것은 래퍼입니다. CLI는 Developer API를 셸에서 쓰기 좋게 감싼 래퍼이고, 호스팅 MCP 도구는 Cursor, Claude Code, Codex를 비롯한 원격 MCP 클라이언트를 위해 선별된 공개 API 기능을 감싸며, SDK는 같은 Developer API 위의 얇은 클라이언트입니다.

API와 MCP 액세스는 Pro 요금제부터 포함되며, Pro 요금제에는 CLI 액세스도 함께 나와 있습니다(요금제).

내 에이전트는 어떤 인터페이스를 써야 하나요?

문서는 목표에 맞는 표면을 다음과 같이 안내합니다.

Agents, MCP OAuth와 API 키, MCP 빠른 시작, Scheduled 기준, 2026-09-26 확인.
에이전트나 앱이…	사용할 것
백엔드에서 저장해 둔 레시피를 호출	HTTP 또는 SDK로 Format API
백엔드에서 일회성 작업으로 에이전트를 실행	HTTP로 Agent Completions
같은 작업을 정해진 주기로 실행	대시보드에서 작성하는 Scheduled. MCP 도구나 CLI 명령어는 없음
Cursor, Claude Code, Codex 또는 다른 원격 MCP 클라이언트	OAuth로 로그인한 호스팅 MCP
원격 MCP는 지원하지만 OAuth는 지원하지 않음	API 키로 연결한 호스팅 MCP
셸 명령어를 실행할 수 있는 로컬 에이전트	`sume login` 후 CLI 명령어 직접 사용

MCP, CLI, HTTP에서 각각 어떤 기능을 쓸 수 있나요?

호스팅 MCP는 HTTP API와 기능이 완전히 같지 않고, CLI의 생성 지원 범위는 그보다도 좁습니다. 현재 CLI에서 일급 생성 제출 경로는 유료 Avatar 생성뿐입니다. 호스팅 MCP 도구는 공개 API 기능을 감싸므로, 아래 표의 모든 행은 HTTP로도 쓸 수 있습니다.

Image 1.0과 Video 1.0은 곧 은퇴합니다. CLI 문서에는 아직 Image 1.0 라우트가 나와 있지만, 셸 에이전트를 포함한 새 연동은 model: "sume/auto"로 POST /v1/images나 POST /v1/videos를 보냅니다(마이그레이션 가이드).

MCP 개요, MCP 도구와 게이트, CLI 명령어 레퍼런스, CLI 생성 워크플로 기준, 2026-09-26 확인.
기능	호스팅 MCP	CLI
이미지, 영상, 음악 생성	`generate_image`, `generate_video`, `music_create`	서브커맨드 없음. HTTP로 제출한 뒤 `sume jobs`로 복구
음성, 업스케일, 배경 제거, 영상 편집	`tts_create`, `stt_create`, `image_upscale_create`, `video_upscale_create`, `rmbg_create`, `video_trim`, `video_filter`, `timeline_*`	제출 명령어 없음
아바타와 아바타 영상	`avatars_create`, `avatar-videos_create`	`sume avatars create`, `sume avatar-videos create`
Job	`jobs_status`, `jobs_wait`, `jobs_result`	`sume jobs status`, `result`, `watch`, `download`
계정, 잔액, 사용량, 카탈로그	`account_me`, `balance_get`, `usage_get`, `catalog_list`	`sume account get`, `sume balance`, `sume usage get`, `sume catalog list`

셸 에이전트는 CLI를 어떻게 써야 하나요?

에이전트가 로컬 머신에서 셸 명령어를 실행할 수 있다면, 문서는 CLI 명령어를 직접 쓰는 방식을 권합니다. sume login, sume tools list --json, Avatar 제출, 그리고 복구용 sume jobs …입니다. --confirm-paid와 --confirm-submit 쓰기 게이트, 민감한 값을 가리는 --agent --json 출력은 CLI 튜토리얼에서 다룹니다. 어떤 인터페이스를 고를지에는 다음 두 가지가 중요합니다.

CLI 도구 ID는 점 표기(avatars.create)를 유지합니다. 그 레지스트리는 호스팅 MCP 카탈로그가 아닙니다.
번들 agent skills: sume skills install은 패키징된 Sume skill을 .agents/skills 또는 .claude/skills에 쓰고, sume skills export sume로 소스 파일을 먼저 검토할 수 있습니다.

sume login
sume tools list --json
sume skills export sume
sume skills install
sume jobs status <job_id> --agent --json

에이전트가 호스팅 MCP를 쓰면 무엇이 달라지나요?

도구 세트는 HTTP 레퍼런스가 아니라 세션에서 정해집니다. tools_list와 tools_schema는 현재 세션에 어떤 도구가 있는지 보여 주고, catalog_list에는 대응하는 MCP 도구가 없는 HTTP 기능이 여전히 나타날 수 있습니다. 자격 증명도 이어지지 않습니다. CLI 로그인과 호스팅 MCP OAuth는 서로 다른 플로이므로, sume login은 호스팅 MCP 토큰을 발급하지 않습니다.

OAuth 세션은 사용자가 동의 화면에서 Write를 켜기 전까지 읽기 전용으로 시작합니다. 로그인, 스코프, 클라이언트 설정은 Claude Code·Cursor·Codex를 호스팅 MCP로 Sume에 연결에, 모든 유료 호출에 그대로 적용되는 게이트는 유료 API를 호출하는 AI 에이전트의 안전한 자동화에 있습니다. 계열별로 묶은 도구 목록은 Sume MCP 도구 목록에서 볼 수 있습니다.

MCP나 CLI로 아직 할 수 없는 일은 무엇인가요?

다음 공백 때문에 에이전트는 HTTP나 대시보드로 돌아가야 합니다.

스케줄 실행. Scheduled에는 MCP 도구도 CLI 명령어도 없습니다.
MCP로 Image 1.0이나 Video 1.0(images_create, videos_create) 호출. 둘 다 REST 전용이며 곧 은퇴합니다.
CLI 서브커맨드로 이미지, 영상, 음악 생성. 문서는 그런 명령어를 지어내지 말라고 안내합니다.

출처

작성자 Sume