---
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` 바이너리 | 백엔드 연동, 스크립트, Avatar CLI 제출, Image/Video/Music HTTP 제출입니다. |
| Studio Agent | Sume 앱 안의 제품 에이전트 경험 | 제품 내 에이전트 워크플로입니다. 공개 MCP 커넥터가 아니며 여기서 다루지 않습니다. |

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

## 인증 한눈에 보기

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

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

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

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

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

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

- `avatars.create`
- `avatar-videos.create`

Image, Video, Music, STT, Video Router 생성을 위한 호스팅 MCP 도구는 오늘
**없습니다**. 이 계열들은 [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) — 인증 매트릭스와 Phase 1 OAuth 제약입니다.
4. [Agents](/agents) · [안전한 자동화](/agents/safe-automation) — 에이전트가
   API / CLI / MCP 경계를 다루는 방법입니다.