---
title: MCP 개요
description: Cursor, Claude를 비롯한 MCP 클라이언트를 위한 호스팅 Sume MCP를 살펴보세요.
---

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

## 프로덕션 엔드포인트

```text
https://mcp.sume.com/mcp
```

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` 바이너리 | 백엔드 연동, 스크립트, 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 개요](/cli)도 함께 살펴보세요.

## 인증 한눈에 보기

| 인증 | 오늘 호스팅 MCP에서 가능한 것 |
|---|---|
| OAuth | 필수 `mcp:read`는 읽기 전용 도구만 봅니다. MCP 호스트 동의 화면에서 Write를 켜면 `mcp:write`가 추가되어 변경·유료 도구가 보입니다. **`mcp:paid` 스코프는 없습니다.** |
| API 키 | 전체 호스팅 도구 세트입니다. 유료·쓰기 호출에는 여전히 `idempotency_key`가 필요하고, 지출 게이트는 지갑/접수입니다. |

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

자세한 내용은 [OAuth와 API 키](/mcp/oauth)에서 살펴보세요.

## 오늘 호스팅 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`

웹·소셜 읽기는 `crawl_*` 계열입니다(`crawl_scrape` / `crawl_map` /
`crawl_search` / `crawl_site` / `crawl_get`, 그리고 `crawl_profile` /
`crawl_feed` / `crawl_media` / `crawl_find`).

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

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

## 다음 페이지

1. [빠른 시작](/mcp/quickstart) — 몇 분 만에 Cursor나 Claude를 연결합니다.
2. [도구와 게이트](/mcp/tools-and-gates) — 도구 목록, 안전 플래그, 플레이북입니다.
3. [OAuth와 API 키](/mcp/oauth) — 인증 매트릭스와 `mcp:read` / `mcp:write`입니다.
4. [Agents](/agents) · [안전한 자동화](/agents/safe-automation) — 에이전트가
   API / CLI / MCP 경계를 다루는 방법입니다.