Claude Code·Cursor·Codex를 호스팅 MCP로 Sume에 연결

Sume는 https://mcp.sume.com/mcp에서 호스팅 Model Context Protocol(MCP) 서버를 운영합니다. Claude Code, Cursor, Codex 등 원격 HTTP MCP 클라이언트라면 무엇이든 이 주소를 가리키게 하고 로그인하면, HTTP API를 직접 감싸지 않아도 코딩 에이전트가 Sume의 계정, 카탈로그, Job, 에셋, 생성, 크롤 도구를 호출할 수 있습니다.

아래 내용은 모두 MCP 문서에서 가져왔습니다. MCP 액세스는 Pro 요금제부터 포함됩니다(요금제 참고).

Claude Code는 어떻게 연결하나요?

HTTP로 서버를 추가한 뒤 로그인 플로를 실행하세요. OAuth 동의는 MCP 호스트에서 이뤄집니다.

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

Cursor는 어떻게 연결하나요?

Cursor Settings → MCP나 MCP 설정 파일에 원격 MCP 서버 항목을 추가하고, Cursor가 요청하면 OAuth 로그인을 마치세요.

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

Codex나 다른 MCP 클라이언트는 어떻게 연결하나요?

streamable HTTP MCP 서버 항목이 https://mcp.sume.com/mcp를 가리키게 설정하고, 설정한 서버 이름으로 해당 클라이언트의 OAuth 로그인을 실행하세요. 클라이언트는 엔드포인트에서 Sume의 protected-resource 메타데이터를 찾아 mcp.sume.com의 동의 페이지로 안내합니다.

연결을 확인하려면 에이전트에게 tools_list(세션에서 보이는 모든 도구)나 mcp_health(엔드포인트, 인증 출처, 안전 설정)를 호출해 달라고 하세요.

로그인 방식마다 에이전트는 무엇을 할 수 있나요?

호스팅 OAuth는 기본적으로 읽기 전용입니다. 동의 화면에서 Write를 켜면 mcp:write도 부여됩니다. 유료 호출용 스코프는 따로 없습니다. 유료 호출은 지갑과 Job 접수 단계에서 통제됩니다.

미디어를 생성하는 도구는 무엇인가요?

출시된 유료 도구는 아바타에 그치지 않습니다. 탐색 도구(tools_list, tools_schema, catalog_list)가 현재 세션에서 무엇을 쓸 수 있는지 클라이언트에게 정확히 알려 주므로, 아래 목록은 계약이 아니라 지도로 봐 주세요.

• 이미지와 영상: generate_image, generate_video. payload.model을 생략하면 Sume가 sume/auto로 라우팅하며, 카탈로그 ID를 직접 고를 수도 있습니다.
• 오디오: music_create, tts_create, stt_create
• 아바타: avatars_create, avatar-videos_create
• 미디어 도구: image_upscale_create, rmbg_create, video_upscale_create, 그리고 조립용 timeline_* 도구
• 웹·소셜 읽기: crawl_scrape, crawl_search 같은 crawl_* 계열

에이전트의 과다 지출은 어떻게 막나요?

쓰기 도구와 유료 도구에는 idempotency_key가 필요하므로, 재시도한 호출이 같은 Job을 두 번 제출할 수 없습니다. dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주고, max_spend_usd는 값을 넘기면 그 호출의 상한이 됩니다. 모든 유료 Job은 여전히 지갑 접수를 거칩니다. 에이전트가 이런 경계를 어떻게 다뤄야 하는지는 안전한 자동화 가이드에서 설명합니다.

호스팅 MCP에 없는 것은 무엇인가요?

호스팅 MCP가 HTTP API의 기능을 모두 제공하지는 않습니다. Sume Image 1.0과 Video 1.0(images_create / videos_create)은 REST 전용이므로 Developer API (영문)로 호출하세요. 앱 안의 Sume 에이전트도 별개의 제품 표면이며, 클라이언트에서 설정하는 MCP 서버가 아닙니다.