---
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 로그인을 완료하세요. 연결한 뒤 `tools.list`를 한 번
호출해 세션을 확인합니다.

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

스트리밍 가능한 HTTP MCP 서버를 다음 주소로 지정하세요.

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

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

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

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

```text
Sume MCP 도구 tools.list를 호출해서 사용할 수 있는 도구와, 그중 allow_write나
allow_paid가 필요한 도구를 정리해 줘.
```

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

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

## 6. Phase 1 OAuth 제약 알아두기

호스팅 OAuth Phase 1은 **읽기 전용** 접근(`mcp:read`)만 허용합니다.

OAuth를 쓰면 다음과 같습니다.

- `jobs.list`, `assets.get`, `catalog.list` 같은 읽기 도구는 동작합니다.
- `jobs.cancel`이나 `assets.create` 같은 쓰기 도구는 거부됩니다.
- `avatars.create` 같은 유료 도구는 거부됩니다.

오늘 쓰기나 유료 MCP 도구를 실행하려면 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로
설정하지 마세요.