AI 에이전트용

에이전트가 Sparkles로 이미지를 만들게 하세요

Claude Code, Claude Desktop, Cursor 또는 다른 MCP 클라이언트를 Sparkles 계정에 연결하세요. 오픈 소스 Sparkles Image MCP를 설치하고 한 번 로그인하면 에이전트가 프롬프트로 이미지와 GIF를 생성할 수 있습니다.

Sparkles Image MCP는 로컬 MCP 서버입니다. 기존 Sparkles 계정과 Credits를 사용하며, 에이전트에 비밀번호나 API 키를 줄 필요가 없습니다. MCP로 만든 이미지는 웹사이트에서 만든 이미지와 같은 라이브러리에 표시됩니다.

약 1분이면 설치됩니다 GitHub 저장소

약 1분이면 설치됩니다

한 가지 방법만 선택하세요. Claude Code 플러그인이 가장 빠르며, Claude Desktop, Cursor 또는 다른 MCP 클라이언트는 수동 구성을 사용합니다.

Claude Code 플러그인

Claude Code에서 두 명령을 차례로 실행하세요. 플러그인에 MCP 서버와 sparkles-image 스킬이 포함되어 있습니다.

/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcp

수동 MCP 구성

이 서버를 MCP 클라이언트 구성에 추가하세요. stdio MCP 서버를 지원하는 클라이언트에서 사용할 수 있습니다.

{
  "mcpServers": {
    "sparkles-image": {
      "command": "npx",
      "args": ["-y", "github:sparkles-mcp/sparkles-image-mcp", "serve"]
    }
  }
}

또는 설치 CLI 사용

CLI는 에이전트 스킬을 설치하고 클라이언트 구성을 출력한 뒤 브라우저 로그인을 시작합니다. 언제든지 doctor로 연결을 확인할 수 있습니다.

npx -y github:sparkles-mcp/sparkles-image-mcp init
npx -y github:sparkles-mcp/sparkles-image-mcp doctor

에이전트에게 이 내용을 보내세요

클라이언트 구성이 어렵다면 아래 프롬프트를 복사해 에이전트에게 보내세요. 서버를 추가하고 로그인을 시작합니다.

에이전트에게 이 내용을 보내세요

이 클라이언트에 Sparkles Image MCP를 구성해 주세요.

서버 명령: npx
서버 인수: -y github:sparkles-mcp/sparkles-image-mcp serve

Claude Code라면 다음을 실행하세요:
claude mcp add --scope user sparkles-image -- npx -y github:sparkles-mcp/sparkles-image-mcp serve

그다음 sparkles-image의 login 도구를 시작하고, 제가 브라우저에서 접근을 승인할 때까지 기다려 주세요. 제가 요청하기 전에는 이미지를 생성하지 마세요. 생성할 때마다 제 Sparkles Credits가 사용됩니다.

Claude Code 플러그인과 같은 이름의 수동 서버를 동시에 설치하지 마세요. 하나만 사용해야 합니다.

한 번 로그인하고 권한을 승인하세요

로그인하면 브라우저에서 sparkles-editor.com이 열리고 127.0.0.1의 로컬 콜백을 기다립니다. 동의 화면에 앱과 로그인한 계정이 표시됩니다. 토큰은 내 컴퓨터에만 저장되며, 계정 → 연결된 MCP 앱에서 언제든지 접근을 취소할 수 있습니다. 액세스 토큰은 15분 후 만료되고 자동으로 갱신됩니다.

images:generate이미지 작업을 제출하고 취소합니다.
images:read작업 상태, 라이브러리, 생성된 이미지를 읽습니다.
account:readCredits 잔액과 사용량을 읽습니다.

에이전트가 할 수 있는 일

로그인 후 사용할 수 있는 도구입니다. 이미지 생성은 Credits를 사용하고, 읽기 도구는 사용하지 않습니다.

generate_image프롬프트로 이미지 1-4장 또는 GIF 1개를 생성합니다.
get_image작업 하나를 확인하고 완료되면 이미지를 반환합니다.
list_images최근 이미지와 작업 상태를 나열합니다.
check_image_jobs이미지를 내려받지 않고 최대 50개 작업을 확인합니다.
cancel_image_jobs대기 중인 작업을 취소합니다.
list_image_models사용 가능한 모델, 품질, GIF 지원을 나열합니다.
get_credit_balance사용 가능한 Credits 잔액을 읽습니다.
get_credit_usage최근 청구와 환불 내역을 읽습니다.
login권한이 필요할 때 브라우저 로그인을 엽니다.

이미지는 Sparkles 라이브러리에 표시됩니다

MCP로 생성한 이미지는 일반 Sparkles 이미지입니다. 라이브러리 → 작품과 이미지 작업 공간의 최근 작품 목록에 표시되며, 웹사이트와 같은 보관 기간을 따릅니다. 생성 완료 후 1일, 구독 중에는 28일입니다. 오래 보관하려면 영구 저장하세요.

라이브러리 → 작품 열기

Credits와 검수

생성할 때마다 로그인한 계정에서 Credits가 차감됩니다. 사용량 기반 모델은 카탈로그에 0으로 표시될 수 있으며, 실제 청구 금액은 get_credit_usage와 결제 내역에서 확인할 수 있습니다. 프롬프트는 웹사이트와 같은 검수를 거칩니다. 거부된 프롬프트는 오류로 반환되며, 검수를 피하려고 표현을 바꾸지 마세요.

자주 묻는 질문

로그인 페이지가 열리지 않음: CLI의 login 명령을 실행하세요. 인증 URL이 출력되면 직접 열 수 있습니다.
login_required 또는 login_expired: 다시 로그인하세요. 반복되면 계정 → 연결된 MCP 앱에서 이전 권한을 취소하세요.
insufficient_credits: 충전하거나 요청을 줄이세요. 에이전트가 무작정 재시도해서는 안 됩니다.
이미지가 아직 생성 중: 에이전트가 작업 ID로 get_image를 호출하게 하세요. 같은 프롬프트를 다시 제출하지 마세요.
image_too_large: 이미지가 6 MB 인라인 한도를 넘습니다. 라이브러리 → 작품에서 보거나 내려받으세요.
잘못된 사이트가 열림: 스테이징 또는 자체 호스팅 사이트라면 SPARKLES_ISSUER를 확인하세요.

링크

MCP 클라이언트는 MIT 라이선스로 공개되어 있으며 공개 /api/mcp API만 사용합니다. Sparkles 웹사이트 코드, 결제 로직, 검수 규칙 또는 비밀 정보는 포함하지 않습니다.