Claude Code와 Sume MCP로 웹사이트 이미지 생성하기

Claude Code로 웹사이트용 이미지를 생성하려면 Write 권한으로 https://mcp.sume.com/mcp의 Sume 호스팅 MCP 서버에 연결하고, prompt, aspect_ratio, idempotency_key를 넣어 generate_image를 호출하게 한 다음, jobs_wait로 Job을 기다렸다가 완성된 이미지를 하나씩 저장소에 저장하게 하세요.

아래 내용은 2026-09-27에 확인한 Sume의 MCP 빠른 시작, MCP 도구와 게이트, Image API (영문) 문서를 바탕으로 합니다. Sume 기초는 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명하므로, Claude Code 같은 MCP 클라이언트에서 작업할 때 호스팅 MCP를 쓰세요. 백엔드에서라면 같은 호출이 Developer API의 POST /v1/images입니다. 설정 방법은 Claude Code·Cursor·Codex를 Sume에 연결하기에서 다룹니다.

Claude Code에는 어떤 권한이 필요한가요?

Write 권한이 필요합니다. 설정 가이드에서 설명하듯 기본 호스팅 OAuth는 읽기 전용(mcp:read)이며, 동의 화면에서 Write를 켜거나 API 키 세션을 쓰기 전까지 generate_image 같은 유료 도구는 insufficient_scope를 반환합니다.

첫 이미지를 만들기 전에 Claude Code에게 엔드포인트, 인증 출처, 안전 설정을 확인하는 mcp_health를 호출하게 하고, tools_list에 generate_image가 있는지 확인하세요. mcp:read만 있으면 유료 도구는 숨겨집니다. API 키는 채팅에 넣지 마세요. 빠른 시작 문서는 인터랙티브 클라이언트에 OAuth 커넥터 플로를 권장합니다.

Claude Code는 어떤 Sume 도구를 어떤 순서로 호출하나요?

도구 id는 밑줄을 씁니다. 세션에서 보이는 도구는 tools_list로 확인할 수 있으며, 이미지 하나를 만드는 경로는 다음과 같습니다.

이미지를 생성하기 전에 비용은 어떻게 확인하나요?

Sume의 결제 전 확인 플레이북을 따르세요. 스키마를 읽고, dry_run: true를 넣은 generate_image(또는 generation_admission_preview)를 호출해 추정치, 잔액, 큐 동작을 확인한 다음, dry_run 없이 새 idempotency_key를 넣어 다시 제출합니다. max_spend_usd는 그 호출의 상한이며, 보낸 경우에만 적용됩니다.

payload.model을 생략하면 Sume가 sume/auto로 패밀리를 고르며, 어떤 패밀리가 실행됐는지는 공개하지 않습니다. 모델을 고정하려면 image-models_list에서 찾은 카탈로그 id를 넘기세요. 다음은 가로로 넓은 히어로 이미지를 프리뷰하는 인수입니다.

{
  "idempotency_key": "site-hero-2026-09-27",
  "dry_run": true,
  "max_spend_usd": 1,
  "payload": {
    "prompt": "Wide hero illustration of a tidy home office at sunrise, soft light, no text",
    "aspect_ratio": "16:9"
  }
}

어떤 크기와 형식을 요청해야 하나요?

비율부터 정하고, 모델에 등급이 있다면 등급도 정하세요. 모델은 카탈로그 디스크립터에 나열된 값만 받으므로, 아래 값을 고정하기 전에 Claude Code가 image-models_get으로 supported_parameters를 읽게 하세요.

• aspect_ratio: 가로로 넓은 히어로에 쓰는 16:9, 그리고 1:1, 4:5, 9:16 같은 정규화된 비율입니다. auto는 선택을 프로바이더에 맡깁니다.
• resolution: 해상도 디스크립터가 있는 모델에서 512, 1K, 2K, 4K 중 하나입니다.
• output_format: png, jpeg, webp, svg 중 하나입니다.
• n: 호출당 최대 10장이며, 모델별 상한은 이보다 낮습니다.
• 투명 배경 컷아웃이 필요하면 완성된 이미지에 rmbg_create를 실행하세요. Sume API 레퍼런스에 따르면 RMBG 1.0은 알파 채널이 있는 PNG 아티팩트를 반환하며, 호출 방법은 배경 제거 API에서 다룹니다.

이미지는 어떻게 저장소에 들어가나요?

현재 코드에서 generate_image는 기본적으로 POST /v1/images를 비동기 Job으로 제출하므로, 도구는 이미지가 아니라 Job으로 응답합니다. 그 job_id로 jobs_wait를 호출하세요. 대기 한 번은 최대 55초(기본값 50초)까지 이어지며, wait_slice_expired가 오면 같은 id로 jobs_wait를 다시 호출하고 유료 create는 절대 다시 제출하지 마세요. 50초가 지나도 실행 중인 이미지는 대개 느린 것이 아니라 멈춘 것입니다. 그다음 jobs_result가 이미지를 반환합니다.

호스팅 MCP는 노트북의 파일을 읽을 수 없는 원격 서버이므로, 이미지를 저장하는 일은 Claude Code의 몫입니다. 이미지를 하나씩 저장소 안, 예를 들어 public/images/ 아래에 내려받게 하고, 페이지에서는 Sume URL 대신 그 경로를 참조하세요. Image API는 결과 URL을 Sume에 호스팅되고 서명된 URL이라고 설명하며, Sume의 안전한 자동화 가이드는 서명된 URL을 로그에 남기면 안 되는 항목으로 꼽습니다.

사이트 이미지 전체를 한 번에 생성하려면 어떻게 하나요?

페이지 섹션마다 generate_image를 한 번씩 호출하는 경우처럼, 한 턴에 같은 모양의 호출이 세 번 이상 필요하면 script_run을 쓰세요. script_run은 Sume 쪽에서 같은 게이트 아래 짧은 JavaScript 프로그램을 실행하며, 그 안의 유료 호출에도 각각 idempotency_key가 필요합니다. 실행은 timeout_seconds(5–55), max_calls, max_paid_calls로 제한되고 자식 jobs[]를 반환합니다. 예산은 프로그래밍 방식 도구 호출에서 다룹니다.

그다음에는 한 번만 기다리면 됩니다. jobs_wait는 id 1–20개를 담은 job_ids를 받으며, 기본값은 wait_for: "all"입니다. 이미지 모델은 이미지 단위로 계량되며, 완료된 생성은 전액 과금되고 실패하거나 취소된 생성은 과금되지 않습니다. 커스텀 픽셀 크기는 이미지 화면 비율과 커스텀 크기에서 다룹니다.