Menghubungkan asisten AI kamu (MCP)

Bernuvia berbicara MCP: asistenmu bisa mencari, membeli, memublikasikan, dan mengecek penjualanmu dengan izin yang kamu berikan, dan tidak pernah menandatangani pembayaran.

Apa itu dan untuk apa

MCP (Model Context Protocol) adalah cara standar sebuah asisten AI (Claude, misalnya) terhubung ke sebuah alat dan benar-benar memakainya. Bernuvia membuka marketplace-nya lewat MCP, jadi asistenmu tidak menjelaskan cara memublikasikan template: dia yang memublikasikannya, di akunmu dan dengan izinmu.

Ini fungsi yang sama dengan yang dipakai web, dengan validasi, peninjauan, dan moderasi yang sama.
Tidak perlu coding: cukup satu baris dan satu token yang kamu buat dan kamu cabut kapan pun kamu mau.
Berfungsi dengan Claude dan dengan klien apa pun yang berbicara MCP.

Penjelasan yang lebih panjang, lengkap dengan contoh, ada di halaman MCP.

Menghubungkannya

1Masuk ke MCP di panelmu dan tekan Buat token.
2Beri nama yang menyebut kegunaannya (“Claude di laptopku”, “penjualan”) dan pilih izinnya. Kalau akunmu punya 2FA, kamu akan diminta kodenya.
3Salin token saat itu juga: demi keamanan, token tidak akan ditampilkan lagi. Kalau hilang, cabut dan buat yang baru.
4Simpan di variabel lingkungan lalu hubungkan klienmu dengan blok yang sesuai (di bawah ada satu per klien).
5Buka sesi baru asistenmu: daftar alat diumumkan saat percakapan dimulai, jadi di sesi yang sudah terbuka alat itu tidak muncul.

Dari direktori resmi MCP: Bernuvia terdaftar di sana sebagai `com.bernuvia/marketplace`. Kalau klienmu membaca direktori itu, kamu menambahkannya dari sana dan yang kamu isi hanya token; blok di bawah untuk klien yang tidak membacanya.

macOS dan Linux: simpan token di variabel `BERNUVIA_TOKEN`. Saat ditempel tidak ada yang tampil dan tidak tersimpan di riwayat.

read -rs BERNUVIA_TOKEN && export BERNUVIA_TOKEN

Windows (PowerShell): sama saja, dalam satu baris.

$BERNUVIA_TOKEN = Read-Host "Bernuvia token"

Claude Code: di terminal, dengan Claude Code terpasang, tempel perintah ini. Tokenmu tidak muncul: variabel yang mengisinya.

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer ${BERNUVIA_TOKEN}"

Claude Desktop dan claude.ai: di Pengaturan › Konektor, "Tambah konektor kustom": tempel URL server dan token-mu di header Authorization. Di sini token masuk ke kolom aplikasinya, jangan pernah ke percakapan.

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

ChatGPT: nyalakan mode pengembang di Pengaturan › Konektor, lalu tambahkan server MCP dengan URL dan token, juga di kolomnya sendiri.

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

Cursor: tambahkan server di ~/.cursor/mcp.json (atau di Pengaturan › MCP) dengan blok ini. Kalau versimu tidak menerjemahkan variabelnya, koneksi gagal di autentikasi dan kamu harus menulis nilainya di berkas itu.

{
  "mcpServers": {
    "bernuvia": {
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${BERNUVIA_TOKEN}"
      }
    }
  }
}

VS Code: di .vscode/mcp.json proyekmu (atau mcp.json penggunamu), server bertipe http. Bentuk `${env:...}` membaca variabel lingkungan.

{
  "servers": {
    "bernuvia": {
      "type": "http",
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BERNUVIA_TOKEN}"
      }
    }
  }
}

Tokenmu tidak ditempel di chat dan tidak ikut terlihat di tangkapan layar. Itu kunci: siapa pun yang memegangnya masuk dengan izinmu. Kalau bocor di percakapan, di tangkapan layar, atau di repositori, cabut di MCP dan buat yang baru.

Kamu bisa punya hingga 3 token aktif sekaligus. Setiap kali ada token yang dibuat atau dihapus, kami memberitahumu lewat email dan lewat notifikasi.

Izin-izinnya

Setiap token membawa izin dan setiap fungsi meminta izinnya sendiri. Kamu hanya memberi apa yang memang kamu mau dia lakukan:

Hanya baca: katalog dan ulasan, pembelianmu, favorit, saldo, notifikasi, referal, dan statistik.
Pembeli: keranjang, menandai favorit, menulis ulasan, melaporkan masalah, menyiapkan pembayaran, menutup pesananmu yang belum dibayar dan sudah tanpa penawaran yang bisa dicairkan, serta membuka, menarik, atau menutup sengketa atas pembelianmu setelah tenggatnya lewat.
Penjual: penjualan dan statistikmu, draf, memublikasikan untuk ditinjau, kode diskon, dan membalas ulasan.

Izin penjual hanya bisa diberikan kalau kamu punya akun penjual dengan langganan yang aktif. Kalau keanggotaanmu kedaluwarsa, fungsi-fungsi itu langsung berhenti merespons walaupun tokennya masih hidup.

Beberapa akun atau beberapa token

Kamu bisa punya beberapa sambungan sekaligus tanpa saling bertabrakan: satu untuk menjual, satu untuk membeli, atau satu untuk tiap akunmu. Yang penting tiap sambungan punya namanya sendiri dan variabelnya sendiri.

Satu nama untuk satu keperluan, di token dan di server dalam klienmu: `bernuvia-ventas` dan `bernuvia-compras` langsung terbedakan.
Satu variabel untuk tiap token: `BERNUVIA_TOKEN_VENTAS` dan `BERNUVIA_TOKEN_COMPRAS`, supaya kamu tidak pernah menempel kunci yang keliru.
Cakupan per folder atau per proyek kalau klienmu mengizinkan: konfigurasinya tinggal bersama proyek dan hanya dimuat saat kamu bekerja di sana. Kalau hanya ada konfigurasi global, nama yang berbeda sudah cukup.
Tiap token membawa izinnya sendiri: token untuk membeli tidak bisa menjual, dan token untuk menjual tidak mengelola agenmu.

Ini token dari akun yang SAMA dan pembayarannya kamu sendiri yang menandatangani. Kalau kamu ingin sebuah program membeli tanpa kamu tunggui, membayar dengan wallet-nya sendiri, itu adalah agen yang dibuat dari akunmu: dia juga bertindak sebagai dirimu, tapi dia yang menandatangani.

Yang TIDAK bisa dilakukan asistenmu

Ini bukan sekadar janji: servernya memang tidak punya fungsi untuk itu, jadi tidak ada agen (bahkan token yang dicuri sekalipun) yang bisa mencobanya.

Menandatangani pembayaran. Dia bisa menyiapkan pembelian dan memberimu tautannya; tanda tangannya kamu yang lakukan di browser dengan wallet-mu. Begitu juga dengan sengketa: dia menyiapkan tautan untuk membukanya, menariknya, atau menutupnya setelah tenggat lewat (saat tenggatnya habis tanpa diputus tim, seluruh dananya kembali utuh kepadamu, tanpa komisi), dan kamu yang menandatangani.
Menarik uangmu. Penarikan butuh tanda tanganmu dan kode yang dikirim ke emailmu.
Menyentuh akunmu. Dia tidak mengubah emailmu, tidak juga 2FA-mu, dan tidak membuat token lain.
Masuk ke panel administrasi. Sebuah agen bekerja sebagai kamu, dan hanya sebagai kamu.

Agen: ada dua jenis. Agen yang kamu buat dari Agen saya bertindak sebagai dirimu, tapi membayar dengan wallet MILIKNYA sendiri, dan dia juga tidak bisa menarik uangmu, meninggalkan ulasan atas namamu, maupun membuat kredensial. Agen otonom adalah akun terpisah yang lahir dengan menandatangani memakai wallet-nya. Dalam kedua kasus, agen menandatangani sendiri dengan wallet-nya; Bernuvia tetap tidak menandatangani apa pun untuknya dan tidak membiarkannya masuk ke panel administrasi.

Kalau ada yang tidak beres

1Masuk ke MCP dan tekan Cabut pada token yang kamu khawatirkan: token langsung berhenti berfungsi.
2Kalau kamu curiga akunmu disusupi, aktifkan 2FA di Keamanan: begitu diaktifkan, SEMUA tokenmu dicabut sekaligus, dan sesi-sesi lain juga ditutup.

Token yang hilang tidak bisa membayar, tidak bisa menarik uang, dan tidak bisa mengubah akunmu: paling jauh dia melakukan, dalam batas izinnya, apa yang bisa kamu lakukan sendiri saat membaca atau mengelola hal-hal milikmu.