Picsart GenAI MCP

공식

150개 이상의 모델을 갖춘 AI 비디오, 이미지 및 오디오 생성

Picsart GenAI MCP(으)로 무엇을 할 수 있나요?

미디어 생성 — 선택한 모델을 사용해 프롬프트로 이미지, 동영상 또는 오디오를 만들도록 에이전트에 요청합니다(picsart_generate).
먼저 비용 견적 확인 — picsart_preflight를 사용해 무료 드라이런 한 번으로 모델의 매개변수를 검증하고 크레딧 예상치를 확인합니다.
이미지 편집 — picsart_remove_bg로 이미지 URL의 배경을 제거하거나, 이미지를 변경하고 보정하고 벡터화합니다.
모델 둘러보기 — 사용 가능한 모델을 나열하고 생성 전에 모델 하나의 매개변수 스키마를 확인합니다.
Drive 파일 관리 — picsart_drive 작업을 통해 Picsart Drive에서 파일을 업로드, 나열, 이동 또는 삭제합니다.

문서

Picsart MCP 서버는 사용 가능한 모델을 Model Context Protocol 도구로 제공합니다. MCP 호환 에이전트에 연결하면 해당 에이전트가 자연어 또는 구조화된 도구 호출을 사용해 사용 가능한 모델로 이미지, 동영상, 오디오를 생성할 수 있습니다.

MCP가 처음이신가요? 먼저 MCP란 무엇인가요?를 확인하세요.

필요한 항목

Picsart 계정. 에이전트가 처음 연결될 때 브라우저에서 로그인합니다.
생성에 사용할 계정의 크레딧. 카탈로그 탐색과 비용 확인은 무료입니다.
OAuth 로그인을 지원하는 원격(HTTP) MCP 서버를 지원하는 에이전트. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT, Gemini CLI가 모두 지원합니다.

이것으로 충분합니다. 서버는 Picsart에서 호스팅하므로 컴퓨터에 설치할 것이 없습니다. MCP를 사용하는 데 gen-ai CLI, gen-ai login 또는 API 키는 필요하지 않습니다.

서버 주소:

https://api.picsart.com/gen-ai/mcp

로그인 방식

에이전트가 처음 연결되면 서버는 로그인이 필요하다고 응답하고 Picsart 로그인 페이지로 안내합니다. 에이전트가 브라우저 창을 열면 Picsart에 로그인하고 액세스를 승인합니다. 그러면 에이전트가 세션을 저장합니다. 이후 모든 도구 호출은 사용자의 크레딧 잔액을 사용해 사용자 계정으로 실행됩니다.

세션이 만료되면 에이전트의 MCP 또는 커넥터 설정에서 서버를 다시 연결하거나 재인증하세요. 단계별 안내는 각 통합 가이드에 있습니다.

에이전트에 연결

Claude (웹 및 데스크톱)

Settings → Connectors → Add custom connector로 이동해 https://api.picsart.com/gen-ai/mcp을 붙여넣고, 열리는 창에서 Picsart에 로그인하세요. Claude Team 또는 Enterprise 요금제를 사용하는 경우 조직 소유자가 모든 사용자를 위해 커넥터를 추가합니다.

Claude Code

claude mcp add --transport http picsart-gen-ai https://api.picsart.com/gen-ai/mcp

그런 다음 Claude Code에서 /mcp을 실행하고 picsart-gen-ai을 선택한 뒤 Authenticate를 선택해 로그인하세요. 모든 대화에서 사용할 수 있습니다.

"Flux 2 Pro를 사용해 흰색 배경의 제품 이미지를 4:3 화면 비율로 생성해 줘."

Skills 및 문제 해결을 포함한 전체 Claude Code 설정은 Claude Code 통합을 참조하세요.

Cursor

프로젝트의 .cursor/mcp.json에 다음을 추가하거나, 모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에 추가하세요.

{
  "mcpServers": {
    "picsart-gen-ai": {
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Cursor 통합을 참조하세요.

Windsurf

mcp_config.json에 추가하세요(Cascade의 ... 메뉴 → Open MCP config file에서 엽니다).

{
  "mcpServers": {
    "picsart-gen-ai": {
      "serverUrl": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

Windsurf 통합을 참조하세요.

VS Code (Copilot)

작업 공간의 .vscode/mcp.json 또는 사용자 MCP 구성에 추가하세요.

{
  "servers": {
    "picsart-gen-ai": {
      "type": "http",
      "url": "https://api.picsart.com/gen-ai/mcp"
    }
  }
}

VS Code 통합을 참조하세요.

Codex (OpenAI)

codex mcp add picsart-gen-ai --url https://api.picsart.com/gen-ai/mcp
codex mcp login picsart-gen-ai

Codex 통합을 참조하세요.

ChatGPT 및 기타 MCP 클라이언트

위 주소를 사용해 커넥터(원격 또는 사용자 지정 MCP 서버라고도 함)를 추가하고 인증 방식으로 OAuth를 선택하세요. ChatGPT 통합과 전체 통합 목록을 참조하세요.

도구 카탈로그

연결하면 아래의 생성, 카탈로그, Drive 도구와 보기 도구, 안내형 크리에이티브 보드 모음, 그리고 이미 보유한 자료로 동영상과 이미지를 만드는 picsart_media_* 도구를 사용할 수 있습니다.

생성이 아니라 제작을 원하시나요?

**Picsart Media Studio**는 이러한 작업을 위한 전용 커넥터입니다. 별도로 추가하고 로그인해야 하며, 이 커넥터와 함께 사용할 수 있습니다.

연결 후에는 모든 도구를 에이전트에서 사용할 수 있습니다. 크레딧을 사용하지 않는 도구는 필요한 만큼 무료로 호출할 수 있습니다.

생성

도구	용도	크레딧 사용
`picsart_generate`	모든 모델을 처음부터 끝까지 실행(이미지 / 동영상 / 오디오 / 텍스트)	예
`picsart_remove_bg`	이미지 배경 제거	예
`picsart_change_bg`	프롬프트를 사용해 이미지 배경 교체	예
`picsart_enhance`	이미지 업스케일 / 보정	예
`picsart_vectorize`	래스터 이미지를 SVG로 변환	예

카탈로그 및 비용

도구	용도	크레딧 사용
`picsart_list_models`	사용자가 시각적으로 탐색할 수 있는 모델 선택기 위젯	아니요
`picsart_model_catalog`	에이전트의 자체 추론을 위한 동일한 카탈로그의 일반 데이터	아니요
`picsart_model_params`	단일 모델의 매개변수 스키마(유형, 필수 여부, 열거형, 최소/최대)	아니요
`picsart_model_choice`	사용자가 선택할 수 있도록 후보 모델의 짧은 목록을 카드로 표시	아니요
`picsart_preflight`	무료 드라이 런 한 번으로 params 페이로드를 검증하고 크레딧 비용 확인	아니요
`picsart_credits`	현재 크레딧 잔액 및 할당량 내역	아니요
`picsart_job_status`	`picsart_generate`에서 시작한 작업 폴링	아니요
`picsart_render_monitor`	실행 중인 생성 작업 묶음의 실시간 진행 패널	아니요

보기

도구	용도	크레딧 사용
`picsart_view_image`	에이전트가 결과를 평가하거나 참조 이미지를 설명할 수 있도록 Picsart에서 호스팅하는 이미지 최대 6개를 보여 줌	아니요

Drive

도구	용도	크레딧 사용
`picsart_drive`	Picsart Drive의 단일 진입점. 동작은 `action`에서 선택	아니요

picsart_drive은 action 매개변수를 사용합니다. 작업별로 분리된 Drive 도구는 없습니다.

`action`	기능
`list`	폴더 탐색(`folderUid` 생략 시 루트, `flat: true`은 모든 파일 표시)
`create_folder`	폴더 생성(`name` 또는 슬래시로 구분된 `path`, 선택적 상위 폴더 `folderUid`, `description`)
`upload`	파일 저장: `file`(채팅 첨부 파일), `url` + `name`(HTTPS URL 또는 인라인 `data:` URI), 또는 한 번에 최대 10개까지 `files` 사용. `result.url`은 `imageUrls`에 전달할 수 있는 CDN URL입니다.
`move`	`itemUids`을 `targetFolderUid`로 이동
`delete`	`itemUids`을 휴지통으로 이동(완전히 삭제하려면 `permanent: true`)
`update`	파일 하나에 사용자 지정 속성 설정(`itemUid` + `attributes`)

모든 작업은 현재 폴더 목록을 반환하므로 Drive 위젯에서 렌더링할 수 있습니다. 자세한 내용은 파일 및 Drive를 참조하고, 처음에 디스크의 파일을 가져오는 방법은 로컬 파일 → URL을 참조하세요.

크리에이티브 보드 및 미디어 제작

일부 도구는 텍스트로 응답하는 대신 대화에 인터랙티브 패널을 엽니다. 예를 들어 영화 설정 콘솔, 샷 목록 보드, 에셋 검토 보드, 모션 설정 콘솔, 장면 편집기 등이 있습니다. 이러한 도구는 단편 영화나 모션 디자인 동영상 같은 다단계 프로젝트를 안내합니다. picsart_media_* 도구(업로드, 장면 템플릿, 자막, 전사, 리프레이밍, 내보내기)는 Media Studio → 할 수 있는 작업에 문서화된 것과 동일한 도구군입니다. 에이전트가 이 도구를 모두 자동으로 검색하므로 이름을 직접 호출할 필요가 없습니다.

파일 시스템 경로를 받는 도구는 없습니다

모든 이미지/동영상 입력은 URL입니다. MCP 계약 어디에도 filePath 매개변수는 없습니다. 실제로 사용할 수 있는 경로는 로컬 파일 → URL을 참조하세요.

권장 생성 흐름

도구는 서로 연결해 사용할 수 있도록 설계되었습니다. 다음 순서를 따르면 예상치 못한 상황을 피할 수 있습니다.

picsart_model_catalog(또는 사용자가 시각적으로 선택하도록 하려면 picsart_list_models) → 모델 선택
picsart_model_params → 입력 항목 확인
picsart_preflight → 무료 호출 한 번으로 페이로드 검증 및 비용 확인
picsart_generate → 실행 시작
picsart_job_status → 결과 가져오기(미디어 모델은 기본적으로 비동기 실행)

이미 모델 ID가 있다면 바로 picsart_generate로 건너뛰세요.

도구 호출 예시

이미지 생성:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting",
    "aspectRatio": "4:3",
    "count": 1
  }
}

동영상 생성:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "seedance-2.0",
    "prompt": "a cat skiing down a mountain",
    "duration": 8,
    "aspectRatio": "16:9",
    "generateAudio": true
  }
}

먼저 검증하고 비용 확인:

{
  "name": "picsart_preflight",
  "arguments": {
    "model": "veo-3.1",
    "params": { "prompt": "a drone shot over a snowy ridge", "duration": 8, "resolution": "1080p" }
  }
}

배경 제거:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance, picsart_vectorize은 각각 image URL 하나를 받아 적합한 모델을 자동으로 선택합니다. 모델을 직접 지정하려면 model을 전달하세요.

입력 항목 참조

picsart_generate은 다음 항목을 받습니다.

필수: model(모델 ID), prompt(텍스트 프롬프트)
일반 선택 항목: aspectRatio, resolution, duration, count(1~10), quality, style, negativePrompt
이미지 입력: imageUrls(이미지-이미지 또는 이미지-동영상 모델용 URL 배열)
동영상 입력: videoUrl(동영상-동영상 모델용 단일 URL)
오디오 생성: generateAudio(네이티브 오디오를 지원하는 동영상 모델용 불리언)
프롬프트 향상: enhancePrompt(불리언, 생성 전에 LLM을 통해 처리)
Drive: saveToDrive(기본값 true) 및 folderUid(결과를 저장할 Drive 폴더)
비동기: async(모든 미디어 모델에서 기본값은 true). 호출은 작업 핸들을 즉시 반환하며, 에이전트는 결과를 가져오기 위해 picsart_job_status을 폴링합니다.
모델별 매개변수: extra(자유 형식 객체. 모델이 허용하는 항목은 picsart_model_params으로 확인)

완료된 결과는 assets: [{ id, type, url, ... }]로 반환되며, 각 파일에는 에이전트가 후속 도구 호출에서 참조할 수 있는 resource_link도 포함됩니다. 에셋은 항상 HTTPS URL이며 base64가 아닙니다. 텍스트 모델은 생성된 텍스트를 반환합니다.

FAQ

MCP를 사용하려면 gen-ai CLI가 필요한가요?

아니요. MCP 서버는 Picsart에서 호스팅되며 에이전트는 HTTPS를 통해 서버에 연결합니다. CLI는 터미널에서 사용하는 별도의 도구입니다. 셸에서 생성하거나 Skills를 사용하려는 경우에만 설치하세요.

MCP 서버에 API 키가 필요한가요?

아니요. 에이전트를 통해 Picsart 계정으로 로그인합니다. 복사하거나 교체할 키는 없습니다.

MCP와 CLI를 동시에 사용할 수 있나요?

네. 각각 별도로 로그인하지만 동일한 Picsart 계정과 크레딧 잔액을 사용합니다.

에이전트가 연결되었지만 도구가 표시되지 않습니다.

로그인을 완료했는지 확인한 다음 에이전트를 다시 시작하거나 새로고침하세요. 대부분의 에이전트는 계속해서 도구 목록을 불러오는 것이 아니라 연결 시점에 목록을 불러옵니다.

MCP에서 사용할 수 있는 모델은 무엇인가요?

SDK 카탈로그 참조에는 252개 모델이 포함되어 있습니다. MCP에서 사용할 수 있는 모델은 서버 버전에 따라 다릅니다. picsart_model_catalog 또는 picsart_list_models를 사용해 모드, 제공업체 또는 용도별로 필터링하거나 모델 카탈로그를 살펴보세요.

생성된 파일은 어디에 저장되나요?

기본적으로 각 미디어 결과는 Drive 루트의 picsart-genai-mcp 폴더에도 저장됩니다. 다른 위치에 저장하려면 folderUid을 전달하고, 저장하지 않으려면 "saveToDrive": false을 전달하세요. picsart_drive을 사용하면 URL이나 채팅 첨부 파일을 직접 업로드할 수 있습니다. 파일 및 Drive를 참조하세요.

모델을 실행하기 전에 비용을 확인하려면 어떻게 하나요?

사용하려는 모델 ID와 매개변수를 지정해 picsart_preflight을 호출하세요. 생성 작업을 실행하지 않고 페이로드를 검증한 뒤 예상 크레딧 비용을 반환합니다.

크레딧 잔액이 부족해지면 어떻게 되나요?

picsart_credits으로 잔액을 확인하고, 다시 시도하기 전에 picsart.com에서 크레딧을 충전하세요.