MCP 개요

Cursor, Claude를 비롯한 MCP 클라이언트를 위한 호스팅 Sume 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)으로 Cursor/Claude/Codex를 Sume에 연결합니다. 오늘 권장하는 MCP 경로입니다. API 키를 쓰는 스크립트는 `https://api.sume.com/mcp`를 씁니다.
로컬 `sume mcp`	CLI MCP 명령어(stdio 클라이언트 설정)	현재 `sumelabs/cli` 릴리스에서 출시되지 않았습니다(`sume mcp doctor` → `coming_soon`). 호스팅 MCP나 CLI 명령어를 직접 사용하세요.
Developer API / CLI	`https://api.sume.com/v1`과 `sume` 바이너리	백엔드 연동, 스크립트, HTTP 제출입니다. 호스팅 MCP가 대부분의 생성 계열을 다룹니다. Image 1.0 / Video 1.0(`images_create` / `videos_create`)만 REST 전용입니다.
Studio Agent	Sume 앱 안의 제품 에이전트 경험	제품 내 에이전트 워크플로입니다. 공개 MCP 커넥터가 아니며 여기서 다루지 않습니다.

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

인증 한눈에 보기

인증	오늘 호스팅 MCP에서 가능한 것
로그인(OAuth)	필수 `mcp:read`는 읽기 전용 도구만 봅니다. MCP 호스트 동의 화면에서 Create and spend credits(`mcp:write`)를 켜 두면 변경·유료 도구가 보입니다. `mcp:paid` 스코프는 없습니다. `sume login`도 같은 로그인을 씁니다.
API 키	`https://api.sume.com/mcp`에서 전체 도구 세트를 씁니다(`mcp.sume.com`은 받지 않음). 유료·쓰기 호출에는 여전히 `idempotency_key`가 필요하고, 지출 게이트는 지갑/접수입니다.

Cursor와 Claude처럼 사람이 쓰는 클라이언트는 로그인하고, API 키는 스크립트와 서버에서 씁니다.

자세한 내용은 로그인과 API 키에서 살펴보세요.

오늘 호스팅 MCP가 할 수 있는 일

호스팅 MCP는 HTTP API와 완전히 동일하지 않습니다. 라이브 도구 ID는 tools_list의 밑줄 이름입니다(packages/mcp-server/src/mcp.ts remoteMcpTools). 점 별칭(tools.list)은 밑줄로 canonicalize됩니다.

출시된 유료 생성 도구는 Avatar만이 아닙니다.

generate_image / generate_video(payload.model을 생략하면 sume/auto로 라우팅; 카탈로그 id는 image-models_list / video-router_models)
music_create, tts_create, stt_create
avatars_create, avatar-videos_create, Stage P 프리뷰 도구
kling-motion-control_create, image_upscale_create, rmbg_create, video_upscale_create, timeline_create / timeline_audio / timeline_compose / timeline_get

로그인 연결(https://mcp.sume.com/mcp의 Claude, ChatGPT, Cursor, Codex)은 이미지와 영상을 만들고 편집하는 도구만 보여 줍니다. 흐름 도구(generate_image, generate_video, generate_audio와 배치, execute_preset, 워크플로·프리셋 읽기, media_upload, media_confirm, media_import_url, models_explore, balance, 워크스페이스 도구, jobs_wait, job_status)와 jobs_result, jobs_list, jobs_get, jobs_cancel, usage_get, 업스케일, 배경 제거, 모션 컨트롤, Fabric, video_inspect, video_frames_*, video_trim, audio_detach, video_filter, timeline_* 도구입니다. 크롤, 소셜, 게시 도구는 보여 주지 않습니다.

REST 전용(tools_list에 없음): Sume Image 1.0과 Video 1.0 (images_create / videos_create). 이 두 제품은 Developer API를 사용하세요.

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

다음 페이지

빠른 시작 — 몇 분 만에 Cursor나 Claude를 연결합니다.
도구와 게이트 — 도구 목록, 안전 플래그, 플레이북입니다.
로그인과 API 키 — 인증 매트릭스와 mcp:read / mcp:write입니다.
Agents · 안전한 자동화 — 에이전트가 API / CLI / MCP 경계를 다루는 방법입니다.