이미지 생성 MCP 서버: Sume generate_image 동작 방식

이미지 생성 MCP 서버는 MCP를 지원하는 어떤 클라이언트에서든 AI 에이전트가 텍스트 프롬프트(선택적으로 레퍼런스 이미지까지)를 이미지 파일로 바꿀 수 있는 도구를 제공합니다. https://mcp.sume.com/mcp의 Sume 호스팅 MCP 서버에는 generate_image가 있습니다. 카탈로그 모델을 지정하지 않으면 sume/auto로 라우팅하는 유료 도구로, Job id로 응답하며 에이전트는 그 Job을 jobs_wait로 기다립니다.

이 계약은 Sume의 MCP 개요, MCP 도구와 게이트, Image API (영문), Job과 결과 (영문) 문서를 바탕으로 하며, 2026-09-28에 확인했습니다. 현재 코드 기준이라고 밝힌 세부 사항은 서버 코드에서 가져왔습니다. 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. 호스팅 MCP는 이미 원격 MCP를 지원하는 에이전트에 맞고, 백엔드는 POST /v1/images를 직접 호출합니다. 영상 버전은 영상 생성 MCP 서버에서 다룹니다.

에이전트는 어떻게 연결하나요?

MCP 클라이언트에 https://mcp.sume.com/mcp를 streamable HTTP 서버로 추가하세요. Sume에는 어떤 클라이언트용으로도 전용 커넥터가 없으며, 이것은 일반적인 원격 MCP 연결입니다. OAuth에서 기본 로그인은 읽기 전용(mcp:read)이며, 동의 화면에서 Write를 켜기 전까지 generate_image 같은 유료 도구는 insufficient_scope를 반환합니다. Authorization: Bearer $SUME_API_KEY나 x-api-key로 보내는 API 키에는 전체 호스팅 도구 세트가 보입니다. 클라이언트 설정은 Claude Code·Cursor·Codex를 Sume에 연결하기에, opencode.json 설정은 OpenCode용 MCP 서버에 있습니다.

generate_image 호출은 어떤 모습인가요?

유료 도구는 idempotency_key와 payload를 받으며, 현재 코드에서 생성 필드는 모두 payload 안에 들어갑니다. 아래 호출은 접수 여부와 비용만 미리 봅니다. 제출하려면 dry_run을 빼거나 false로 두고 다시 보내세요.

{
  "idempotency_key": "desk-mug-001",
  "dry_run": true,
  "max_spend_usd": 1,
  "payload": {
    "prompt": "a ceramic mug on a wooden desk, morning light",
    "aspect_ratio": "16:9"
  }
}

generate_image는 어떤 payload 필드를 받나요?

현재 코드에서 이 도구는 POST /v1/images에 제출하므로, 필드는 그 엔드포인트를 따릅니다. 각 모델은 받는 값을 기능 디스크립터(capability descriptor)로 공개하며, 선택한 모델이 나열하지 않은 파라미터는 무시되지 않고 400 unsupported_parameter로 거부됩니다. 모델을 고정하기 전에 image-models_list로 카탈로그를 확인할 수 있습니다.

에이전트는 완성된 이미지를 어떻게 받나요?

기다린 다음 읽습니다. 현재 코드에서 generate_image는 기본적으로 비동기로 제출하고 수 밀리초 안에 Job id로 응답합니다. 도구 설명에 따르면 스틸 이미지는 보통 10초에서 60초, 대기 한두 번이면 끝납니다.

• jobs_wait는 호출당 최대 55초까지 대기하고 Job id를 최대 20개까지 받으므로, 스틸 이미지 여러 장을 시작한 에이전트는 호출 한 번으로 전부 기다릴 수 있습니다.
• 그다음 jobs_result가 Job을 반환합니다. 완료된 Job에는 아티팩트가 포함될 수 있으며, 아티팩트마다 media.sume.com URL, image 같은 type, content_type이 있습니다.
• 에이전트가 받는 것은 이미지 바이트가 아니라 링크입니다. Sume는 인라인 base64 대신 호스팅 URL을 반환합니다. 보관할 파일은 다운로드하세요. 대기 루프는 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

Sume 이미지 생성 MCP 서버는 무료인가요?

무료가 아닙니다. generate_image는 유료 도구이며, 지출은 워크스페이스 지갑에서 나갑니다. 이미지 생성 과금은 전부 아니면 전무 방식이므로, 완료된 생성은 전액 과금되고 실패하거나 취소된 생성은 과금되지 않습니다. 카탈로그 모델은 엔드포인트의 pricing 항목대로 지갑에서 차감되므로, 지불하는 금액은 cost_usd × n입니다.

• dry_run=true는 접수 여부와 비용 프리뷰를 보여 줄 뿐 Job을 제출하지 않습니다.
• max_spend_usd는 호출 한 번의 상한이며, 값을 보낸 경우에만 적용됩니다.
• idempotency_key는 전송과 중복 제거를 위한 고정 키이며, 사람의 승인이 아닙니다. 키는 같은 payload로 같은 호출을 다시 보낼 때만 재사용하세요.

Sume 이미지 도구가 하지 않는 일은 무엇인가요?

• sume/auto 뒤에 있는 모델을 알려 주지 않습니다. 응답에는 sume/auto가 그대로 표시되며, Sume는 어떤 모델 계열이 실행됐는지 공개하지 않습니다.
• 투명 배경을 반환하지 않습니다. 현재 도구 설명에 따르면 generate_image에서는 투명 출력을 쓸 수 없습니다. 스틸 이미지를 생성한 다음 rmbg_create를 실행하면 알파 채널이 있는 PNG가 반환됩니다(이미지 편집용 MCP 서버).
• 여러분의 컴퓨터에 있는 파일을 읽지 못합니다. 호스팅 MCP는 로컬 파일을 읽을 수 없으므로 레퍼런스는 공개 HTTPS URL이어야 하며, localhost, 사설 네트워크, HTTPS가 아닌 URL은 제출 전에 거부됩니다.