---
title: MCP 빠른 시작
description: Cursor나 Claude를 호스팅 Sume MCP에 연결하세요.
---

원격 MCP 클라이언트를 Sume 프로덕션 엔드포인트에 연결하고, OAuth(또는 API 키)를
완료한 뒤 읽기 전용 탐색 도구를 호출하세요.

## 1. 프로덕션 URL 사용하기

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

API 키를 채팅에 붙여 넣지 마세요. 인터랙티브 클라이언트에는 OAuth 커넥터 플로를
권장합니다.

## 2. Claude Code 연결하기

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

Claude Code MCP 상태 UI에서 서버가 연결됐는지 확인한 뒤, Claude에게
`tools_list`나 `mcp_health`를 호출해 달라고 하세요.

## 3. Cursor 연결하기

원격 MCP 서버 항목을 추가하세요(Cursor Settings → MCP, 또는 MCP 설정 파일).

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

Cursor가 물어보면 OAuth 로그인을 완료하세요(동의는 MCP 호스트에서 이뤄지며
`app.sume.com`이 아닙니다). 연결한 뒤 `tools_list`를 한 번 호출해 세션을
확인하세요.

## 4. Codex나 다른 HTTP MCP 클라이언트 연결하기

streamable HTTP MCP 서버를 다음 주소로 지정하세요.

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

해당 클라이언트에서 설정한 서버 이름으로 OAuth 로그인을 실행합니다.
클라이언트는 MCP 엔드포인트에서 Sume protected-resource 메타데이터를 찾아
`https://mcp.sume.com/oauth/consent`로 보냅니다.

## 5. 읽기 전용 도구로 확인하기

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

```text
Sume MCP 도구 tools_list를 호출해서 사용할 수 있는 도구를 정리해 줘.
라이브 id는 밑줄입니다(tools_list, generate_image). 점 별칭도 동작합니다.
```

처음 호출해 보면 좋은 도구입니다.

| 도구 | 이유 |
|---|---|
| `mcp_health` | 엔드포인트, 인증 출처, 안전 설정을 확인합니다. |
| `tools_list` | 이 세션에서 보이는 모든 도구를 나열합니다. |
| `tools_schema` | `name`으로 도구 하나의 계약을 반환합니다. |
| `account_me` | 워크스페이스 계정 컨텍스트를 확인합니다. |
| `catalog_list` | 공개 API 기능을 나열합니다(MCP 도구보다 범위가 넓습니다). |

## 6. OAuth 스코프 알아두기

기본 호스팅 OAuth는 **읽기 전용** 접근(`mcp:read`)만 부여합니다. 동의
화면에서 **Write**를 켜면 `mcp:write`도 받습니다. `mcp:paid` 스코프는
없습니다.

`mcp:read`만 있으면 다음과 같습니다.

- `jobs_list`, `assets_get`, `catalog_list`, `crawl_scrape` 같은 읽기 도구는
  동작합니다.
- `jobs_cancel`이나 `assets_create` 같은 쓰기 도구는 `insufficient_scope`를
  반환합니다.
- `generate_image`나 `avatars_create` 같은 유료 도구는 `insufficient_scope`를
  반환합니다.

쓰기나 유료 MCP 도구를 실행하려면 동의에서 `mcp:write`를 부여하거나, API 키
원격 MCP 세션이나 Developer API / CLI를 사용하세요.
[OAuth와 API 키](/mcp/oauth), [도구와 게이트](/mcp/tools-and-gates)에서
살펴보세요.

## 로컬 CLI 대안

에이전트가 로컬 머신에서 셸 명령어를 실행할 수 있다면, 오늘은 CLI 명령어를
직접 쓰는 편이 좋습니다(`sume login`, `sume tools list --json`, Avatar 제출 +
`sume jobs …`). [CLI 개요](/cli)에서 살펴보세요.

```bash
sume login
sume mcp doctor --json
```

로컬 `sume mcp`는 현재 CLI 릴리스에서 **출시되지 않았습니다**(`coming_soon`).
`mcp.sume.com`의 호스팅 커넥터와는 별개의 향후 표면입니다. 클라이언트가 원격
HTTP MCP를 말하면 호스팅 MCP를 쓰세요.

## Studio Agent는 다릅니다

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