Picsart GenAI MCP

Server MCP Picsart mengekspos katalog model lengkap sebagai alat Model Context Protocol. Hubungkan ke agen yang kompatibel dengan MCP mana pun dan agen tersebut dapat menghasilkan gambar, video, dan audio di 201 model menggunakan bahasa alami atau panggilan alat terstruktur.

Baru mengenal MCP? Mulailah dengan Apa itu MCP? terlebih dahulu.

Prasyarat

1. Instal CLI gen-ai — lihat Instalasi.
2. Jalankan gen-ai login sekali (membuka browser Anda untuk OAuth).

Itu saja. Server MCP (gen-ai-mcp) sudah termasuk dalam CLI dan menggunakan kredensial yang sama.

Hubungkan ke agen Anda

Claude Code

claude mcp add picsart-gen-ai -- gen-ai-mcp

Kemudian gunakan dalam percakapan apa pun:

"Buat gambar produk dengan latar belakang putih menggunakan Flux 2 Pro, rasio aspek 4:3."

Untuk pengaturan lengkap Claude Code termasuk Skills dan pemecahan masalah, lihat Integrasi Claude Code.

Cursor

Tambahkan berikut ini ke file konfigurasi MCP Cursor Anda (.cursor/mcp.json atau yang setara):

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

Lihat Integrasi Cursor.

Windsurf

Tambahkan ke konfigurasi MCP Windsurf Anda:

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

Lihat Integrasi Windsurf.

VS Code (Copilot)

Tambahkan ke .vscode/mcp.json di workspace Anda atau ke pengaturan pengguna Anda:

{
  "servers": {
    "picsart-gen-ai": {
      "type": "stdio",
      "command": "gen-ai-mcp"
    }
  }
}

Lihat Integrasi VS Code.

Codex (OpenAI)

codex mcp add picsart-gen-ai -- gen-ai-mcp

Lihat Integrasi Codex.

ChatGPT dan klien MCP lainnya

Lihat Integrasi ChatGPT atau halaman resmi di picsart.com/gen-ai-mcp untuk konfigurasi konektor saat ini.

---

Katalog alat

Menghubungkan akan mengekspos alat generasi, katalog, dan Drive di bawah ini, plus picsart_media_* alat untuk membangun video dan gambar dari materi yang sudah Anda miliki.

Lebih suka membangun daripada menghasilkan?

Picsart Media Studio adalah konektor yang didedikasikan untuk jenis pekerjaan itu. Konektor ini ditambahkan dan masuk secara terpisah, dan dapat berdampingan dengan konektor ini.

Setiap alat tersedia untuk agen setelah terhubung. Alat yang tidak menghabiskan kredit gratis untuk dipanggil sebanyak yang diperlukan.

Generasi

Alat	Tujuan	Menghabiskan kredit
picsart_generate	Menjalankan model apa pun secara end-to-end (gambar / video / audio / teks)	ya
picsart_remove_bg	Menghapus latar belakang gambar	ya
picsart_change_bg	Mengganti latar belakang gambar dari prompt	ya
picsart_enhance	Menaikkan skala / meningkatkan kualitas gambar	ya
picsart_vectorize	Mengonversi gambar raster ke SVG	ya
picsart_music_studio	Membuka Music Studio (musik / SFX / sampul album)	tidak¹

¹ Membuka studio gratis; menghasilkan di dalamnya menghabiskan kredit.

Katalog & biaya

Alat	Tujuan	Menghabiskan kredit
picsart_list_models	Widget pemilih model — untuk pengguna menjelajah secara visual	tidak
picsart_model_catalog	Katalog yang sama sebagai data biasa, untuk penalaran agen sendiri	tidak
picsart_model_params	Skema parameter dari satu model (tipe, wajib, enum, min/maks)	tidak
picsart_preflight	Memvalidasi payload params dan mengutip biaya kreditnya — satu dry run gratis	tidak
picsart_credits	Saldo kredit saat ini dan rincian kuota	tidak
picsart_job_status	Memeriksa pekerjaan yang dimulai oleh picsart_generate dengan async: true	tidak

Drive

Alat	Tujuan	Menghabiskan kredit
picsart_drive	Titik masuk tunggal untuk Picsart Drive — perilaku dipilih oleh action	tidak

picsart_drive menerima parameter action; tidak ada alat Drive terpisah per operasi:

action	Apa yang dilakukannya
list	Menelusuri folder (folderUid dihilangkan = root; flat: true mencantumkan setiap file)
create_folder	Membuat folder (name, induk opsional folderUid, description)
upload	Menyimpan file — baik file (lampiran obrolan) atau url + name (URL HTTPS atau URI data: inline). result.url adalah URL CDN yang siap diteruskan ke imageUrls
move	Memindahkan itemUids ke targetFolderUid
delete	Soft-delete itemUids ke tempat sampah (permanent: true untuk menghapus permanen)
update	Mengatur atribut kustom pada satu file (itemUid + attributes)

Setiap tindakan mengembalikan daftar folder saat ini sehingga widget Drive dapat dirender. Lihat File & Drive untuk detailnya, dan File lokal → URL untuk mendapatkan file dari disk Anda sejak awal.

Tidak ada alat yang menerima jalur sistem file

Setiap input gambar/video adalah URL. Tidak ada parameter filePath di mana pun dalam kontrak MCP — lihat File lokal → URL untuk tiga jalur yang benar-benar berfungsi.

Alur generasi yang disarankan

Alat-alat dirancang untuk dirantai. Urutan ini menghindari kejutan:

1. picsart_model_catalog (atau picsart_list_models untuk membiarkan pengguna memilih secara visual) → pilih model
2. picsart_model_params → pelajari inputnya
3. picsart_preflight → validasi payload dan kutip biayanya dalam satu panggilan gratis
4. picsart_generate → benar-benar menjalankannya

Jika Anda sudah memiliki id model, langsung lompat ke picsart_generate.

Contoh panggilan alat

Buat gambar:

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

Buat video:

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

Validasi dan kutip biaya terlebih dahulu:

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

Hapus latar belakang:

{
  "name": "picsart_remove_bg",
  "arguments": {
    "imageUrls": ["https://example.com/product.jpg"]
  }
}

Referensi input

picsart_generate menerima:

• Wajib: model (id model), prompt (prompt teks)
• Opsional umum: aspectRatio, resolution, duration, count (1 hingga 8), quality, style, negativePrompt
• Input gambar: imageUrls (array URL — untuk model image-to-image atau image-to-video)
• Input video: videoUrl (satu URL — untuk model video-to-video)
• Generasi audio: generateAudio (boolean — untuk model video yang mendukung audio asli)
• Peningkatan prompt: enhancePrompt (boolean — dirutekan melalui LLM sebelum generasi)
• Params khusus model: extra (objek bebas — gunakan picsart_model_params untuk melihat apa yang diterima model)

Hasil kembali sebagai results: [{ url, metadata? }]. Aset adalah URL, tidak pernah base64. Setiap hasil juga menyertakan resource_link sehingga agen dapat mereferensikannya dalam panggilan alat lanjutan.

FAQ

Apakah server MCP memerlukan kunci API terpisah?

Tidak. Server ini menggunakan sesi OAuth yang sama dengan CLI. Jalankan gen-ai login sekali; server MCP mengambil kredensial tersebut secara otomatis.

Bisakah saya menggunakan MCP dan CLI di mesin yang sama secara bersamaan?

Ya. Keduanya menggunakan file kredensial yang sama (~/.gen-ai/credentials.json) dan saldo kredit yang sama. Menjalankannya secara paralel tidak masalah.

Agen terhubung tetapi alat tidak muncul.

Mulai ulang agen setelah menambahkan konfigurasi MCP. Sebagian besar agen memuat daftar alat saat startup, bukan secara dinamis.

Model mana yang berfungsi melalui MCP?

Semua 201 model dalam katalog. Tidak ada subset khusus MCP. Gunakan picsart_list_models untuk memfilter berdasarkan mode atau penyedia, atau jelajahi Katalog Model.

Bisakah agen menyimpan file yang dihasilkan ke Drive?

Ya. Teruskan "saveToDrive": true dalam argumen picsart_generate, atau gunakan picsart_drive untuk mengunggah file lokal atau URL. Lihat File dan Drive.

Bagaimana saya tahu biaya model sebelum menjalankannya?

Panggil picsart_preflight dengan id model dan parameter yang ingin Anda gunakan. Ini memvalidasi payload dan mengembalikan perkiraan kredit tanpa menjalankan generasi.

Apa yang terjadi jika saldo kredit saya habis di tengah generasi?

Periksa saldo Anda dengan picsart_credits dan isi ulang di picsart.com sebelum mencoba lagi.