---
title: MCP 빠른 시작
description: Claude, Claude Code, Cursor, Codex를 Sume에 연결하고 첫 이미지를 만드세요.
---

Sume MCP 주소는 모든 클라이언트에서 하나입니다.

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

클라이언트에 이 주소를 추가하면 브라우저가 열립니다. Sume에 로그인한 뒤
**Allow**를 누르세요. API 키는 필요 없습니다.

## 1. 클라이언트 연결하기

### Claude (claude.ai, Claude Desktop)

[Claude에 Sume 추가하기](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Sume&connectorUrl=https%3A%2F%2Fmcp.sume.com%2Fmcp)

링크를 열면 Claude의 **Add custom connector** 창에 이름과 주소가 채워져
있습니다. **Continue**를 누르고 나머지 단계를 마치세요. 직접 추가하려면 Claude의
**Customize → Connectors**에서 사용자 지정 커넥터를 추가하고 주소를 붙여 넣으세요.
Team·Enterprise 요금제에서는 소유자가 사용자 지정 커넥터를 추가합니다.

### Claude Code

```bash
claude mcp add --transport http sume https://mcp.sume.com/mcp
claude mcp login sume
```

`claude mcp login`이 브라우저를 엽니다. 로그인한 뒤 **Allow**를 누르세요. 세션에서
`/mcp`를 열면 `sume`이 연결됨으로 보입니다.

### Cursor

[Cursor에 Sume 추가하기](https://cursor.com/install-mcp?name=sume&config=eyJ1cmwiOiJodHRwczovL21jcC5zdW1lLmNvbS9tY3AifQ==)

또는 `~/.cursor/mcp.json`(모든 프로젝트)이나 `.cursor/mcp.json`(한 프로젝트)에
추가하세요.

```json
{
  "mcpServers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp"
    }
  }
}
```

Cursor에서 `sume` 옆에 **Needs login**이 보이면 눌러서 로그인하고 **Allow**를
누르세요.

### Codex

```bash
codex mcp add sume --url https://mcp.sume.com/mcp
codex mcp login sume
```

### 다른 클라이언트

이 주소를 streamable HTTP MCP 서버로 추가하세요. 클라이언트는
`https://mcp.sume.com/.well-known/oauth-protected-resource/mcp`에서 로그인 방법을
찾습니다. 로그인할 수 없는 스크립트는 Sume API 키를 `https://api.sume.com/mcp`로
보냅니다(`Authorization: Bearer $SUME_API_KEY` 또는 `x-api-key`).
`mcp.sume.com`은 API 키를 받지 않습니다. [로그인과 API 키](/mcp/oauth)를
참고하세요.

## 2. 접근 허용하기

로그인하면 Sume이 어떤 앱이 접근을 요청하는지, 어떤 계정으로 로그인했는지
보여 줍니다.

- **Read**는 항상 켜져 있습니다. 앱이 계정, 크레딧, 모델, 에셋, 작업을 볼 수
  있습니다.
- **Create and spend credits**를 켜면 앱이 이미지·영상·오디오를 만들고, 파일을
  올리고, 작업을 취소할 수 있습니다. 생성하려면 켜 두세요. 끄면 앱은 읽기만 할 수
  있습니다.
- **Workspace** 선택이 보이면 앱이 크레딧을 쓸 워크스페이스를 고르세요. 보이지
  않으면 앱은 개인 워크스페이스를 씁니다.

연결하려면 **Allow**, 그만두려면 **Deny**를 누르세요.

## 3. 첫 이미지 만들기

에이전트에게 이렇게 요청하세요.

```text
Sume으로 흰 테이블 위의 빨간 사과 이미지를 만들고 링크를 보여 줘.
```

에이전트는 도구 두 개를 호출합니다.

1. `payload.prompt`와 `idempotency_key`를 넣어 `generate_image`를 호출합니다.
   Sume은 1초쯤 뒤 `job_id`로 답합니다.
2. 그 `job_id`와 `include_results: true`로 `jobs_wait`를 호출합니다. 작업이
   끝나면 답에 이미지 주소(`https://media.sume.com/...`)가 들어 있습니다.

Claude에서는 이미지가 채팅 안의 Sume 뷰어에도 바로 뜹니다. 뷰어가 작업이 끝날
때까지 알아서 기다립니다. 이미지를 누르면 프롬프트, 모델, 비율과 함께 전체 화면으로
열립니다. **Download**는 파일을 저장하고, **Animate**, **Edit**, **Recreate**는
요청을 메시지 입력란에 채워 넣습니다. 보내면 에이전트가 `generate_video`나
`generate_image`로 실행합니다.

이미지는 10–60초, 영상(`generate_video`)은 1–5분쯤 걸립니다. 가격을 먼저 보려면
에이전트에게 `dry_run: true`를 붙여 달라고 하세요. Sume이 크레딧만 보여 주고
작업은 실행하지 않습니다.

내 컴퓨터의 파일을 참조로 쓰려면 에이전트가 `assets_upload_url`과
`assets_complete`로 올린 뒤 에셋 주소를 넘깁니다. 공개 `https://` 이미지·영상
주소는 그대로 넘겨도 됩니다.

## 4. 문제가 생기면

| 보이는 것 | 할 일 |
|---|---|
| 크레딧 부족(`insufficient_credits`) | 메시지에 필요한 크레딧과 잔액이 나옵니다. 결제 페이지에서 크레딧을 추가한 뒤 다시 시도하세요. |
| `insufficient_scope` | 읽기만 허용된 연결입니다. 앱에서 Sume을 지우고 다시 연결하면서 **Create and spend credits**를 켜 두세요. |
| 클라이언트가 다시 로그인하라고 함 | 로그인하고 **Allow**를 누르세요. 작업과 파일은 그대로입니다. |
| 도구가 보이지 않음 | 클라이언트가 보여 주는 목록의 도구를 쓰라고 에이전트에게 요청하세요. |

## 로컬 CLI 대안

에이전트가 내 컴퓨터에서 셸 명령을 실행할 수 있다면 CLI 명령도 쓸 수 있습니다
(`sume login`, `sume tools list --json`, `sume jobs …`).
[CLI 개요](/cli)를 참고하세요. 로컬 `sume mcp`는 현재 CLI 릴리스에서 **아직
출시되지 않았습니다**(`sume mcp doctor` → `coming_soon`). `mcp.sume.com`의 호스팅
커넥터와는 별개입니다.

## Studio Agent는 다릅니다

Studio Agent는 Sume 앱 안의 에이전트 제품입니다. 이 문서가 설명하는 공개 호스팅
MCP 커넥터가 **아닙니다**. Studio Agent 내부 주소를 고객 MCP 서버 URL로 설정하지
마세요.