Hubungkan Asisten AI Anda ke LabelGrid (MCP)

Diperbarui Juli 2026.

LabelGrid menerbitkan server MCP (Model Context Protocol) resmi agar Anda bisa menghubungkan asisten AI Anda sendiri ke akun LabelGrid dan bekerja dalam bahasa sehari-hari. Alih-alih menulis panggilan REST, Anda bisa meminta AI Anda menyusun draft rilis, memvalidasinya, memeriksa status tinjauannya, atau menarik analitik Anda, dan AI itu memakai API LabelGrid di baliknya.

Server ini adalah paket npm @labelgrid/mcp dan bersifat open source dengan lisensi MIT di github.com/labelgrid/labelgrid-mcp. Server ini bekerja dengan Claude Desktop, Claude Code, Cursor, atau klien apa pun yang kompatibel dengan MCP.

Apa saja yang bisa Anda lakukan

Setelah terhubung, Anda bisa meminta asisten AI Anda untuk:

• Membuat dan memperbarui draft rilis dan track — menyusun metadata lewat percakapan
• Mengunggah audio, artwork, dan dokumen lisensi ke rilis dan track Anda
• Memvalidasi rilis sebelum dikirim agar masalah muncul lebih awal
• Memeriksa masalah tinjauan, laporan kualitas, dan status pengiriman
• Menarik analitik streaming, laporan royalti, dan rinciannya
• Mengelola webhook untuk notifikasi asinkron
• Mengirim rilis untuk distribusi atau menariknya kembali — hanya tersedia jika Anda mengaktifkan tindakan ini secara eksplisit (lihat Keamanan dan izin)

Di baliknya, server ini mengekspos satu set tool terkonsolidasi yang ringkas dalam delapan toolset: account, reference, catalog, releases, insights, finance, webhooks, dan distribution. Banyak tool menentukan sasaran kerjanya dari argumen yang Anda berikan. Sebagai contoh, satu tool pencarian katalog mencakup label, artis, penulis, penerbit, rilis, dan track sekaligus. Data referensi seperti genre, bahasa, dan wilayah juga diekspos sebagai resource MCP. Unggahan file merupakan bagian dari toolset catalog dan distribution. Klien AI Anda menampilkan daftar tool yang persisnya ditawarkan kepadanya, jadi Anda selalu bisa melihat cakupan yang berlaku saat itu dari dalam klien tersebut.

---

Yang Anda butuhkan

1. Akun LabelGrid dengan akses API. Akses API adalah bagian dari paket API LabelGrid; lihat Ikhtisar API untuk cara mendapatkannya.
2. Token API. Buat satu di dashboard LabelGrid Anda di bawah Profile → API Tokens.
3. Node.js 20 atau yang lebih baru di komputer yang menjalankan klien AI Anda.

---

Pemasangan

Tambahkan LabelGrid ke konfigurasi MCP klien AI Anda:

{
  "mcpServers": {
    "labelgrid": {
      "command": "npx",
      "args": ["-y", "@labelgrid/mcp"],
      "env": {
        "LABELGRID_API_TOKEN": "your-api-token"
      }
    }
  }
}

Ganti your-api-token dengan token dari dashboard Anda, lalu mulai ulang klien Anda.

Untuk Claude Code, cukup satu perintah:

claude mcp add labelgrid -e LABELGRID_API_TOKEN=your-api-token -- npx -y @labelgrid/mcp

Perhatian

Perintah itu menaruh token Anda di baris perintah, tempat shell Anda mencatatnya ke dalam riwayat dan pengguna lain di mesin tersebut bisa membacanya dari daftar proses. Bersihkan token itu dari riwayat Anda setelahnya, atau tambahkan saja token ke konfigurasi JSON di atas.

---

Penyiapan terpandu

Jika Anda menjalankan server tanpa token, server tidak gagal, melainkan masuk ke mode penyiapan terpandu. Tambahkan LabelGrid ke klien Anda tanpa mengisi nilai LABELGRID_API_TOKEN, lalu minta AI Anda untuk “set up LabelGrid” dan ia akan memandu Anda membuat token dan menentukan di mana token itu diletakkan. Alur penyiapannya menyuruh asisten mengarahkan Anda ke file konfigurasi klien Anda dan tidak pernah meminta token di dalam chat — jadi simpanlah token di sana, dan jangan menempelkannya ke dalam percakapan sekalipun diminta.

---

Keamanan dan izin

Server memakai tiga tingkat izin sehingga Andalah yang menentukan seberapa jauh AI Anda boleh bertindak:

• Pembacaan selalu tersedia. AI Anda bisa mencari rilis, track, tinjauan, analitik, laporan, dan status pengiriman kapan saja.
• Penulisan aman aktif secara default. Membuat dan menyunting draft, memperbarui metadata, dan mengelola webhook sudah aktif sejak awal. Anda bisa mematikannya dengan LABELGRID_ENABLE_WRITES=false, atau memaksa semuanya menjadi hanya-baca dengan LABELGRID_READ_ONLY=true.
• Tindakan berkonsekuensi nonaktif secara default. Mengirim rilis untuk distribusi, menarik kembali rilis, dan mengunggah file yang tak bisa diubah memerlukan LABELGRID_ENABLE_FULL_WRITES=true ditambah satu kalimat persetujuan eksplisit, yang didokumentasikan pada README proyek.

Semua perlindungan akun Anda, mulai dari validasi, batas paket, sampai batas laju permintaan, diberlakukan oleh server LabelGrid. AI tidak bisa menghindarinya, seberapa pun besar izin yang Anda berikan.

---

Apa yang dilihat klien AI Anda

Server ini berjalan di komputer Anda sendiri dan berbicara dengan API LabelGrid memakai token Anda. Ia tidak punya hubungan apa pun dengan LabelGrid selain panggilan API yang diminta AI Anda, dan LabelGrid tidak menerima percakapan Anda.

Aliran datanya justru berjalan ke arah sebaliknya, dan ini layak Anda sikapi dengan sadar: apa pun yang dibaca AI Anda lewat server ini — metadata rilis, masalah tinjauan, analitik, laporan royalti — diteruskan ke klien AI yang Anda konfigurasikan, lalu dari sana ke model apa pun yang dipakai klien tersebut. Memilih klien yang Anda percayai untuk katalog dan data akun Anda, serta mengungkapkan aliran itu bila perjanjian Anda sendiri mengharuskannya, adalah tanggung jawab Anda.

Ada dua konsekuensi praktisnya:

• Jika sebagian data Anda tidak boleh sampai ke penyedia AI, gunakan LABELGRID_TOOLSETS untuk menahan area itu sepenuhnya alih-alih berharap AI tidak menanyakannya. Tool yang tidak ditawarkan tidak bisa dipanggil.
• Data keuangan termasuk di dalamnya. Toolset finance membaca laporan dan rincian royalti, jadi tinggalkan toolset itu kecuali Anda memang ingin data tersebut masuk ke percakapan.

---

Membatasi tool yang tersedia

Jika Anda hanya ingin mengekspos sebagian akun Anda, atur LABELGRID_TOOLSETS untuk membatasi area tool yang ditawarkan server. Ini menjaga AI tetap fokus pada area yang Anda pilih. Toolset webhooks nonaktif secara default; tambahkan ke LABELGRID_TOOLSETS untuk mengaktifkannya.

---

Pemecahan masalah

• Token tidak valid atau ditolak — buat ulang tokennya di dashboard Anda di bawah Profile → API Tokens lalu perbarui di konfigurasi MCP Anda.
• Anda tidak melihat halaman “API Tokens” — akun Anda belum memiliki akses API. Lihat Ikhtisar API untuk cara mengaktifkannya.
• Tidak yakin servernya sudah terhubung — server mencetak statusnya saat dijalankan, jadi periksa log MCP pada klien Anda.
• Anda ingin memutus koneksi — cabut tokennya dari dashboard Anda kapan saja. Tindakan itu seketika menghentikan segala hal yang memakai token tersebut, termasuk server ini. Token lain di akun Anda tidak terpengaruh, jadi cabut satu per satu token yang ingin Anda hentikan penggunaannya, dan hapus juga nilainya dari konfigurasi MCP Anda.

---

FAQ

”Apakah LabelGrid punya server MCP?”

Ya. LabelGrid menerbitkan server MCP resmi sebagai paket npm @labelgrid/mcp, open source dengan lisensi MIT di github.com/labelgrid/labelgrid-mcp. Server ini menghubungkan Claude Desktop, Claude Code, Cursor, atau klien AI apa pun yang kompatibel dengan MCP ke akun LabelGrid Anda sehingga Anda bisa bekerja dalam bahasa alami.

”Apa saja yang bisa saya lakukan dengannya?”

Membuat dan memperbarui draft rilis dan track; mengunggah audio, artwork, dan dokumen lisensi; memvalidasi rilis sebelum dikirim; memeriksa masalah tinjauan, laporan kualitas, dan status pengiriman; menarik analitik streaming, laporan royalti, dan rinciannya; serta mengelola webhook. Mengirim rilis untuk distribusi dan menariknya kembali hanya tersedia jika Anda mengaktifkannya secara eksplisit.

”Apakah aman membiarkan AI mengelola akun saya?”

Server ini memiliki tiga tingkat izin. Pembacaan selalu tersedia; penulisan aman (draft, metadata, webhook) aktif secara default dan bisa dimatikan; dan tindakan berkonsekuensi (pengiriman untuk distribusi, penarikan, unggahan file yang tak bisa diubah) nonaktif secara default serta mengharuskan Anda mengaktifkan penulisan penuh ditambah pernyataan persetujuan yang eksplisit. Semua perlindungan akun, yaitu validasi, batas paket, dan batas laju permintaan, diberlakukan oleh server LabelGrid dan tidak bisa dihindari oleh AI.

Izin mengatur apa yang boleh dilakukan AI. Pertimbangkan secara terpisah apa yang bisa dilihatnya: apa pun yang dibacanya lewat server ini sampai ke klien AI Anda dan model di baliknya. Lihat Apa yang dilihat klien AI Anda.

”Apakah saya perlu paket API?”

Ya. Server MCP terhubung melalui API publik LabelGrid, jadi akun Anda memerlukan akses API, yang merupakan bagian dari paket API LabelGrid. Lihat Ikhtisar API untuk cara mendapatkan aksesnya.

”Aplikasi AI apa saja yang didukung?”

Klien apa pun yang kompatibel dengan MCP, termasuk Claude Desktop, Claude Code, dan Cursor.

---

Terkait

• Ikhtisar API dan Panduan Cepat — cara mendapatkan akses API dan mengautentikasi
• Alat Baris Perintah LabelGrid (CLI) — tindakan yang sama dari terminal atau skrip Anda
• Webhooks — notifikasi peristiwa asinkron
• @labelgrid/mcp di npm
• labelgrid-mcp di GitHub

---

Butuh bantuan?

Jika Anda punya pertanyaan tentang server MCP, hubungi tim dukungan kami.