MCP 빠른 시작

Claude, Claude Code, Cursor, Codex를 Sume에 연결하고 첫 이미지를 만드세요.

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

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

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

1. 클라이언트 연결하기

Claude (claude.ai, Claude Desktop)

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

Claude Code

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

Cursor

Cursor에 Sume 추가하기

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

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

Codex

다른 클라이언트

이 주소를 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 키를 참고하세요.

2. 접근 허용하기

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

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

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

3. 첫 이미지 만들기

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

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

payload.prompt와 idempotency_key를 넣어 generate_image를 호출합니다. Sume은 1초쯤 뒤 job_id로 답합니다.
그 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 개요를 참고하세요. 로컬 sume mcp는 현재 CLI 릴리스에서 아직 출시되지 않았습니다(sume mcp doctor → coming_soon). mcp.sume.com의 호스팅 커넥터와는 별개입니다.

Studio Agent는 다릅니다

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