Picsart GenAI MCP

Server MCP Picsart menyediakan model-model yang tersedia sebagai alat Model Context Protocol. Hubungkan server ini ke agen apa pun yang kompatibel dengan MCP, lalu agen tersebut dapat membuat gambar, video, dan audio menggunakan model yang tersedia melalui bahasa alami atau pemanggilan alat terstruktur.

Baru mengenal MCP? Mulailah dengan Apa itu MCP?.

Yang Anda perlukan

• Akun Picsart. Anda masuk ke akun tersebut melalui browser saat pertama kali agen terhubung.
• Kredit di akun tersebut untuk membuat konten. Menelusuri katalog dan melihat perkiraan biaya gratis.
• Agen yang mendukung server MCP jarak jauh (HTTP) dengan autentikasi OAuth. Claude, Claude Code, Cursor, VS Code, Codex, ChatGPT, dan Gemini CLI semuanya mendukungnya.

Hanya itu. Server dihosting oleh Picsart, jadi tidak ada yang perlu dipasang di komputer Anda. Anda tidak memerlukan gen-ai CLI, gen-ai login, atau kunci API untuk menggunakan MCP.

Alamat server:

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

Cara kerja autentikasi

Saat pertama kali agen terhubung, server memberi tahu bahwa autentikasi diperlukan dan mengarahkan agen ke halaman masuk Picsart. Agen membuka jendela browser, Anda masuk ke Picsart dan menyetujui akses, lalu agen menyimpan sesi itu sendiri. Setelah itu, setiap pemanggilan alat dilakukan atas nama Anda dan menggunakan saldo kredit Anda.

Jika sesi kedaluwarsa, hubungkan kembali atau autentikasi ulang server dari pengaturan MCP atau konektor agen Anda. Langkah-langkahnya tersedia di setiap panduan integrasi.

Hubungkan ke agen Anda

Claude (web dan desktop)

Buka Settings → Connectors → Add custom connector, tempel https://api.picsart.com/gen-ai/mcp, lalu masuk ke Picsart di jendela yang terbuka. Jika menggunakan paket Claude Team atau Enterprise, pemilik organisasi dapat menambahkan konektor untuk semua orang.

Claude Code

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

Lalu jalankan /mcp di Claude Code, pilih picsart-gen-ai, dan pilih Authenticate untuk masuk. Gunakan dalam percakapan apa pun:

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

Untuk panduan penyiapan Claude Code lengkap, termasuk Skills dan pemecahan masalah, lihat integrasi Claude Code.

Cursor

Tambahkan berikut ini ke .cursor/mcp.json di proyek Anda, atau ke ~/.cursor/mcp.json untuk semua proyek:

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

Lihat integrasi Cursor.

Windsurf

Tambahkan ke mcp_config.json (buka dari menu ... Cascade → Open MCP config file):

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

Lihat integrasi Windsurf.

VS Code (Copilot)

Tambahkan ke .vscode/mcp.json di ruang kerja Anda atau ke konfigurasi MCP pengguna:

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

Lihat integrasi VS Code.

Codex (OpenAI)

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

Lihat integrasi Codex.

ChatGPT dan klien MCP lainnya

Tambahkan konektor (terkadang disebut server MCP jarak jauh atau kustom) dengan alamat di atas, lalu pilih OAuth sebagai metode autentikasi. Lihat integrasi ChatGPT dan daftar lengkap integrasi.

---

Katalog alat

Setelah terhubung, Anda dapat menggunakan alat pembuatan, katalog, dan Drive di bawah ini, serta alat untuk melihat hasil, serangkaian papan kreatif terpandu, dan alat picsart_media_* untuk membuat video dan gambar dari materi yang sudah Anda miliki.

Menyusun, bukan membuat dari awal?

Picsart Media Studio adalah konektor khusus untuk pekerjaan semacam itu. Konektor ini ditambahkan dan diautentikasi secara terpisah, serta dapat digunakan berdampingan dengan konektor ini.

Setelah terhubung, agen dapat menggunakan semua alat. Alat yang tidak menggunakan kredit dapat dipanggil gratis sebanyak yang diperlukan.

Pembuatan

Alat	Tujuan	Menggunakan kredit
picsart_generate	Menjalankan model apa pun dari awal hingga akhir (gambar / video / audio / teks)	ya
picsart_remove_bg	Menghapus latar belakang gambar	ya
picsart_change_bg	Mengganti latar belakang gambar berdasarkan prompt	ya
picsart_enhance	Memperbesar / menyempurnakan gambar	ya
picsart_vectorize	Mengonversi gambar raster ke SVG	ya

Katalog & biaya

Alat	Tujuan	Menggunakan kredit
picsart_list_models	Widget pemilih model agar pengguna dapat menelusuri model secara visual	tidak
picsart_model_catalog	Katalog yang sama dalam bentuk data biasa untuk penalaran agen	tidak
picsart_model_params	Skema parameter satu model (jenis, wajib, enum, min/maks)	tidak
picsart_model_choice	Menampilkan daftar singkat model kandidat sebagai kartu untuk dipilih pengguna	tidak
picsart_preflight	Memvalidasi payload params dan memperkirakan biaya kredit dalam satu uji coba gratis	tidak
picsart_credits	Saldo kredit saat ini dan rincian kuota	tidak
picsart_job_status	Memeriksa status tugas yang dimulai oleh picsart_generate	tidak
picsart_render_monitor	Panel progres langsung untuk sekumpulan proses pembuatan yang sedang berjalan	tidak

Melihat hasil

Alat	Tujuan	Menggunakan kredit
picsart_view_image	Memungkinkan agen melihat hingga 6 gambar yang dihosting Picsart agar dapat menilai hasil atau mendeskripsikan referensi	tidak

Drive

Alat	Tujuan	Menggunakan kredit
picsart_drive	Satu titik akses untuk Picsart Drive; perilaku ditentukan oleh action	tidak

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

action	Fungsinya
list	Menelusuri folder (folderUid dihilangkan = root; flat: true menampilkan setiap file)
create_folder	Membuat folder (name, atau path yang dipisahkan garis miring, induk opsional folderUid, description)
upload	Menyimpan file: file (lampiran chat), url + name (URL HTTPS atau URI data: sebaris), atau hingga 10 file sekaligus dengan files. result.url adalah URL CDN yang siap diteruskan ke imageUrls
move	Memindahkan itemUids ke targetFolderUid
delete	Memindahkan itemUids ke sampah secara lunak (permanent: true untuk menghapus permanen)
update	Menetapkan atribut kustom pada satu file (itemUid + attributes)

Setiap tindakan mengembalikan daftar folder terkini agar widget Drive dapat menampilkannya. Lihat File & Drive untuk detail, dan File lokal → URL untuk mengetahui cara mendapatkan file dari disk Anda.

Papan kreatif dan pembuatan media

Beberapa alat membuka panel interaktif dalam percakapan, bukan membalas dengan teks: konsol penyiapan film, papan daftar pengambilan gambar, papan peninjauan aset, konsol penyiapan gerakan, dan editor adegan, serta alat lainnya. Alat-alat ini memandu proyek bertahap seperti film pendek atau video desain gerak. Alat picsart_media_* (unggah, templat adegan, teks, transkripsi, pembingkaian ulang, ekspor) termasuk dalam keluarga yang sama dengan yang didokumentasikan di Media Studio → Yang dapat Anda lakukan. Agen Anda akan menemukan semuanya secara otomatis; Anda tidak perlu memanggilnya berdasarkan nama.

Tidak ada alat yang menerima jalur sistem file

Setiap input gambar/video harus berupa URL. Tidak ada parameter filePath di mana pun dalam kontrak MCP. Lihat File lokal → URL untuk mengetahui cara yang benar-benar dapat digunakan.

Alur pembuatan yang disarankan

Alat-alat ini dirancang untuk digunakan secara berantai. Urutan ini membantu menghindari kejutan:

1. picsart_model_catalog (atau picsart_list_models agar pengguna dapat memilih secara visual) → pilih model
2. picsart_model_params → pelajari inputnya
3. picsart_preflight → validasi payload dan perkirakan biaya dalam satu pemanggilan gratis
4. picsart_generate → mulai proses
5. picsart_job_status → ambil hasilnya (model media berjalan secara asinkron secara default)

Jika Anda sudah memiliki ID model, langsung lanjut ke picsart_generate.

Contoh pemanggilan alat

Buat gambar:

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting",
    "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 perkirakan 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": {
    "image": "https://example.com/product.jpg"
  }
}

picsart_remove_bg, picsart_change_bg, picsart_enhance dan picsart_vectorize masing-masing menerima satu URL image dan memilih model yang sesuai secara otomatis. Berikan model untuk menggantinya.

Referensi input

picsart_generate menerima:

• Wajib: model (ID model), prompt (prompt teks)
• Opsional yang umum: aspectRatio, resolution, duration, count (1 hingga 10), quality, style, negativePrompt
• Input gambar: imageUrls (array URL, untuk model gambar-ke-gambar atau gambar-ke-video)
• Input video: videoUrl (satu URL, untuk model video-ke-video)
• Pembuatan audio: generateAudio (boolean, untuk model video yang mendukung audio bawaan)
• Penyempurnaan prompt: enhancePrompt (boolean, meneruskan prompt melalui LLM sebelum pembuatan)
• Drive: saveToDrive (default true) dan folderUid (folder Drive tempat hasil disimpan)
• Asinkron: async (defaultnya true untuk setiap model media: pemanggilan langsung mengembalikan handle tugas, lalu agen memeriksa picsart_job_status untuk mendapatkan hasil)
• Parameter khusus model: extra (objek bebas; gunakan picsart_model_params untuk melihat parameter yang diterima model)

Hasil yang selesai dikembalikan sebagai assets: [{ id, type, url, ... }], beserta resource_link untuk setiap file agar agen dapat merujuknya dalam pemanggilan alat berikutnya. Aset berupa URL HTTPS, bukan base64. Model teks mengembalikan teks yang dihasilkan.

FAQ

Apakah saya memerlukan gen-ai CLI untuk menggunakan MCP?

Tidak. Server MCP dihosting oleh Picsart dan agen Anda terhubung ke server tersebut melalui HTTPS. CLI adalah alat terpisah untuk terminal. Pasang hanya jika Anda ingin membuat konten dari shell atau menggunakan Skills.

Apakah server MCP memerlukan kunci API?

Tidak. Anda masuk menggunakan akun Picsart melalui agen Anda. Tidak ada kunci yang perlu disalin atau dirotasi.

Bisakah saya menggunakan MCP dan CLI secara bersamaan?

Ya. Keduanya diautentikasi secara terpisah, tetapi menggunakan akun Picsart dan saldo kredit yang sama.

Agen sudah terhubung, tetapi alatnya tidak muncul.

Pastikan Anda sudah menyelesaikan proses masuk, lalu mulai ulang atau muat ulang agen. Kebanyakan agen memuat daftar alat saat terhubung, bukan secara terus-menerus.

Model apa saja yang dapat digunakan melalui MCP?

Referensi katalog SDK mencakup 251 model. Ketersediaan MCP bergantung pada versi server. Gunakan picsart_model_catalog atau picsart_list_models untuk memfilter berdasarkan mode, penyedia, atau tujuan, atau telusuri Katalog Model.

Ke mana file yang dihasilkan disimpan?

Secara default, setiap hasil media juga disimpan ke Picsart Drive Anda, di folder picsart-genai-mcp pada root Drive. Berikan folderUid untuk menyimpannya di tempat lain, atau "saveToDrive": false untuk melewati penyimpanan. Gunakan picsart_drive untuk mengunggah URL atau lampiran chat sendiri. Lihat File dan Drive.

Bagaimana cara mengetahui biaya model sebelum menjalankannya?

Panggil picsart_preflight dengan ID model dan parameter yang ingin Anda gunakan. Alat ini memvalidasi payload dan memberikan perkiraan kredit tanpa menjalankan proses pembuatan.

Apa yang terjadi jika saldo kredit saya habis?

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