InkRoom
메뉴

InkRoom · Visual & Batch Design Studio

InkRoom MCP Server: Claude / Cursor에서 상품 이미지 제작

InkRoom MCP는 상품 이미지 생성과 참조 편집을 AI 도우미에 연결합니다. 포인트 견적과 승인을 확인해 실행하고, 원래 작업 영수증으로 결과를 이어 받습니다.

이미지 작업별 도구, 입력과 납품 확인

이미지 작업별 도구, 입력과 납품 확인
제작 작업도구와 필수 입력매개변수와 실행 조건납품 전 확인
텍스트로 상품 장면generate_image: prompt, 선택 model·size·quality·countcount는 1–16. 크기와 품질은 실제 모델 목록 및 견적 기준구도, 실제 픽셀, 원본 형식
부분 수정·배경 변경derive_image: 지시와 referenceImages 또는 parentTaskId여러 이미지의 부모 작업은 parentImageIndex 필수. 전용 마스크 누끼 API는 아님상품 비율, 라벨, 수정 제외 영역. 투명 요청은 alpha 확인
여러 SKU·광고 지면batch_generate: 전체 items 견적, 같은 설정은 count총 포인트와 승인을 확인. 서버가 빈 동시 실행 슬롯을 채움작업 ID로 SKU 대응. 성공 항목은 다시 생성하지 않음
상품 확대·애니메이션 보정upscale_image: image 한 장과 operationx2·x4·anime·face. processingOperations로 사용 가능 여부 확인재질, 가장자리, 얼굴 복원 후 인물 특징
중단 후 결과 수령wait_images: 원래 nextAction.arguments 사용requestId / batchId 유지. 저장 실패로 새 견적을 만들지 않음완료 이미지를 먼저 표시하고 저장 원본이 열리는지 확인

From a client connection to your first image quote

  1. Sign in to MCP Server, review MCP access, and create or select your personal Token with the required generation, model and batch Scopes.
  2. Connect to https://mcp.inkroom.ai using the appropriate Claude Code or Cursor format and verify discovery. This setup step does not run paid generation.
  3. Preview the references, prompt, placements and quantity. Check the actual model and credit estimate, execute within saved authorization, and approve the specific order when requested.

Copyable MCP Server JSON configuration

The service uses Streamable HTTP with a Bearer MCP Token. These examples follow the two clients' documented structures. There is no prerequisite public API call or private replacement for an API Key.

Claude Code · .mcp.json

{
  "mcpServers": {
    "inkroom": {
      "type": "http",
      "url": "https://mcp.inkroom.ai",
      "headers": {
        "Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
        "X-InkRoom-Continuation": "receipt-v1"
      }
    }
  }
}

Cursor · mcp.json

{
  "mcpServers": {
    "inkroom": {
      "url": "https://mcp.inkroom.ai",
      "headers": {
        "Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
        "X-InkRoom-Continuation": "receipt-v1"
      }
    }
  }
}

Claude Code uses type:http in a project's .mcp.json; Cursor uses url and headers in its mcp.json. Merge the inkroom entry into existing mcpServers and retain other connections. Replace the placeholder with your personal MCP Token and keep the personal configuration private. X-InkRoom-Continuation enables the existing receipt flow; it belongs to MCP configuration, not public API requests.

This configuration requires a host supporting custom HTTP headers. Check compatibility for OAuth-only web connectors; it does not establish direct access from Claude on the web, Perplexity or every AI assistant.

Tools for generation, reference editing and enhancement

  • list_models — Discover models, processing operations and access
  • generate_image — Text-to-image and cost preview
  • derive_image — Reference editing and derivation from existing images
  • upscale_image — Upscaling, anime enhancement and face restoration
  • batch_generate — Submit multiple generation tasks
  • wait_images — Retrieve completed images and original links

Use derive_image with a source and instructions for detail or background cleanup. There is no dedicated remove_background Tool or mask field. Inspect real alpha for transparent PNG. upscale_image exposes x2/x4/anime/face as separate operations without a prompt or general model parameters; check availability with list_models first.

Where to obtain a MCP Token or API Key

For MCP: sign in, open MCP Server, choose Configuration, create or select a MCP Token, and copy the complete Token. For the API: sign in, open API management, create or select an API Key, and follow its documented authentication. The credentials are distinct; registration, copying an example or completing setup does not grant model access or raise spending limits.

Related workflows and official configuration documentation

Client configuration documentation reviewed:

세 가지 장면별 레시피로 시작하기

링크는 프롬프트만 입력합니다. 필요한 참조를 추가하고 예상 크레딧을 확인한 뒤 생성하세요.

스포이트 병: 배경만 교체

참조 이미지 요건: 라벨과 윤곽이 선명한 정면 원본 한 장. 채팅 축소 이미지를 피하세요.

참조의 갈색 유리 스포이트 병만 상품으로 사용한다. 높이, 어깨 곡선, 뚜껑, 원래 라벨 문자와 로고의 위치 및 비율을 유지한다. 배경만 밝은 회색 무한 배경과 무광 석재 테이블로 바꾼다. 정면 사선 시점, 부드러운 측광, 실제 유리 투과와 자연스러운 접지 그림자. 정사각형 화면 안에 병 전체를 넣고 문자, 소품, 두 번째 병을 추가하지 않는다. 지정하지 않은 상품 영역을 최대한 유지하며 라벨이 변형된 이미지는 게시에서 제외한다.
이미지 작업 공간에서 템플릿 열기 ↗
러닝화: 측면 광고 샘플 한 장

참조 이미지 요건: 같은 신발의 선명한 측면 원본. 색상과 끈을 통일하세요. 다른 지면은 설명을 개별 수정해 MCP 일괄 작업에 넣으세요.

러닝화 참조로 측면 광고 샘플 한 장을 만든다. 연한 베이지 무광 바닥과 같은 색 무한 배경에 신발 하나의 측면 전체를 담는다. 색상, 상표, 재질, 형태와 봉제선을 보존한다. 부드러운 측광과 약한 접지 그림자를 사용한다. 가로 4:3, 신발 앞이 오른쪽을 향하며 전체를 담고 좌측 위에 후편집 여백을 둔다. 문자, 가격, 콜라주나 두 번째 신발을 추가하지 않는다.
이미지 작업 공간에서 템플릿 열기 ↗
보온컵: 흰 배경 상품 이미지

참조 이미지 요건: 뚜껑과 브랜드가 선명하고 금속 하이라이트가 날아가지 않은 전체 사진.

참조 보온컵을 흰 배경 상품 이미지로 정리한다. 원래 배경과 주변 소품을 제거하고 배경 목표를 RGB 255,255,255로 둔다. 뚜껑, 손잡이, 금속 결, 상품 표식과 실제 비율을 유지한다. 컵을 세워 중앙에 완전히 담고 사방에 자르기 여백을 둔다. 새로운 문자, 테두리, 워터마크를 넣지 않는다. 약한 접지 그림자를 남긴다. 흰 배경을 투명으로 간주하지 않으며 게시 전 배경 픽셀, 가장자리와 표식을 확인한다.
이미지 작업 공간에서 템플릿 열기 ↗

게시 전 품질 점검표

  • 필요한 도구와 Scope를 발견하고 선택 모델 및 처리 항목이 실행 가능한지 확인하세요.
  • 실제 모델, 설정, 수량과 총 포인트를 확인하세요. 저장된 승인을 사용하고 요청 시 이번 전체 주문을 승인하세요.
  • 모든 SKU, 로고, 유리·금속 가장자리와 보존 영역을 검사하세요. 흰 픽셀과 alpha는 따로 확인하세요.
  • 원래 영수증으로 결과를 대응하고 원본 열기 및 크기를 확인하세요. 저장 실패 시 다운로드만 복구하세요.

FAQ

Claude Code, Cursor와 Claude 웹에서 같은 설정을 쓰나요?

아래는 Claude Code의 type:http와 Cursor의 url/headers 예시를 나누어 제공합니다. InkRoom은 Streamable HTTP와 개인 Bearer MCP Token을 사용합니다. Claude 웹, Perplexity 등은 사용자 지정 원격 주소와 안전한 Bearer Header를 지원해야 합니다. OAuth만 가능한 연결에 바로 사용할 수 있다고 보장하지 않습니다.

배경 제거와 부분 수정 도구는 무엇이며 투명 PNG를 보장하나요?

derive_image에 원본과 편집 지시를 제공하며 선택 모델 능력에 따라 처리합니다. 전용 remove_background Tool이나 마스크 입력은 없습니다. PNG라고 투명한 것은 아닙니다. 원본 alpha와 라벨, 머리카락, 유리 가장자리를 확인하세요.

MCP Token은 어디서 받으며 API Key로 대신할 수 있나요?

로그인 후 MCP Server 설정에서 본인 Token을 생성 또는 선택해 Bearer 자리표시자를 교체합니다. API Key는 API 관리에서 따로 받아 /v1·/v1beta 표준 API에 사용합니다. 서로 대체할 수 없으며 MCP 견적과 영수증 절차는 공개 API의 사전 조건이 아닙니다.

참고 자료

Last reviewed: