MCP 빠른 시작
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
원격 MCP 클라이언트를 Sume 프로덕션 엔드포인트에 연결하고, OAuth(또는 API 키)를 완료한 뒤 읽기 전용 탐색 도구를 호출하세요.
1. 프로덕션 URL 사용하기
API 키를 채팅에 붙여 넣지 마세요. 인터랙티브 클라이언트에는 OAuth 커넥터 플로를 권장합니다.
2. Claude Code 연결하기
Claude Code MCP 상태 UI에서 서버가 연결됐는지 확인한 뒤, Claude에게
tools_list나 mcp_health를 호출해 달라고 하세요.
3. Cursor 연결하기
원격 MCP 서버 항목을 추가하세요(Cursor Settings → MCP, 또는 MCP 설정 파일).
Cursor가 물어보면 OAuth 로그인을 완료하세요(동의는 MCP 호스트에서 이뤄지며
app.sume.com이 아닙니다). 연결한 뒤 tools_list를 한 번 호출해 세션을
확인하세요.
4. Codex나 다른 HTTP MCP 클라이언트 연결하기
streamable HTTP MCP 서버를 다음 주소로 지정하세요.
해당 클라이언트에서 설정한 서버 이름으로 OAuth 로그인을 실행합니다.
클라이언트는 MCP 엔드포인트에서 Sume protected-resource 메타데이터를 찾아
https://mcp.sume.com/oauth/consent로 보냅니다.
5. 읽기 전용 도구로 확인하기
에이전트에게 이렇게 요청하세요.
처음 호출해 보면 좋은 도구입니다.
| 도구 | 이유 |
|---|---|
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 키, 도구와 게이트에서
살펴보세요.
로컬 CLI 대안
에이전트가 로컬 머신에서 셸 명령어를 실행할 수 있다면, 오늘은 CLI 명령어를
직접 쓰는 편이 좋습니다(sume login, sume tools list --json, Avatar 제출 +
sume jobs …). CLI 개요에서 살펴보세요.
로컬 sume mcp는 현재 CLI 릴리스에서 출시되지 않았습니다(coming_soon).
mcp.sume.com의 호스팅 커넥터와는 별개의 향후 표면입니다. 클라이언트가 원격
HTTP MCP를 말하면 호스팅 MCP를 쓰세요.
Studio Agent는 다릅니다
Studio Agent는 앱 안의 Sume 에이전트 제품입니다. 이 페이지에서 다루는 공개 호스팅 MCP 커넥터가 아닙니다. Studio Agent 내부를 고객 MCP 서버 URL로 설정하지 마세요.