MCP 개요

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

Sume는 호스팅 Model Context Protocol(MCP) 엔드포인트를 제공합니다. HTTP API를 직접 감싸지 않아도 에이전트가 Sume의 계정, 카탈로그, Job, 에셋, Avatar 도구를 호출할 수 있습니다.

프로덕션 엔드포인트

Cursor, Claude Code, Codex를 비롯한 원격 MCP 클라이언트에서 이 URL을 사용하세요.

내부·개발용 참고: https://mcp.dev.sume.com/mcp는 Sume 개발 환경을 위한 것입니다. 공개 문서와 고객 설정에는 mcp.sume.com을 사용하세요.

표면	무엇인지	언제 쓰는지
호스팅 MCP	`https://mcp.sume.com/mcp`의 원격 HTTP MCP	OAuth나 API 키로 Cursor/Claude/Codex를 Sume에 연결합니다. 오늘 권장하는 MCP 경로입니다.
로컬 `sume mcp`	CLI MCP 명령어(stdio 클라이언트 설정)	현재 `sumelabs/cli` 릴리스에서 출시되지 않았습니다(`sume mcp doctor` → `coming_soon`). 호스팅 MCP나 CLI 명령어를 직접 사용하세요.
Developer API / CLI	`https://api.sume.com/v1`과 `sume` 바이너리	백엔드 연동, 스크립트, Avatar CLI 제출, Image/Video/Music HTTP 제출입니다.
Studio Agent	Sume 앱 안의 제품 에이전트 경험	제품 내 에이전트 워크플로입니다. 공개 MCP 커넥터가 아니며 여기서 다루지 않습니다.

오늘 지원하는 원격 커넥터는 호스팅 MCP입니다. 로컬 sume mcp는 앞으로 나올 CLI 표면이니 아직 동작하는 stdio 서버로 문서화하거나 설정하지 마세요. Studio Agent 제품 표면도 마찬가지입니다. CLI 개요도 함께 살펴보세요.

인증	오늘 호스팅 MCP에서 가능한 것
OAuth (Phase 1)	읽기 전용 도구입니다. 스코프는 `mcp:read`입니다. 쓰기·유료 도구는 `insufficient_scope`를 반환합니다.
API 키	전체 호스팅 도구 세트입니다. 다만 `allow_write` / `allow_paid` / `dry_run` 게이트는 그대로 적용됩니다.

Cursor와 Claude 같은 인터랙티브 클라이언트에는 OAuth를 권장합니다. 기존 자동화를 위해 API 키 원격 MCP도 계속 사용할 수 있습니다.

자세한 내용은 OAuth와 API 키에서 살펴보세요.

호스팅 MCP는 HTTP API와 완전히 동일하지 않습니다.

출시된 유료 생성 도구는 Avatar 중심입니다.

Image, Video, Music, STT, Video Router 생성을 위한 호스팅 MCP 도구는 오늘 없습니다. 이 계열들은 Developer API를 사용하세요.

catalog.list, tools.list, tools.schema 같은 탐색 도구가 현재 세션에서 어떤 MCP 도구를 쓸 수 있는지 정확히 알려줍니다.