Setup Vercel MCP untuk Coding Agent: Scope, Audit, dan Guardrail

Setup Vercel MCP untuk coding agent dilakukan dengan mendaftarkan endpoint MCP resmi Vercel pada klien yang kompatibel, lalu menyelesaikan autentikasi OAuth di browser. Setelah terhubung, agent dapat menggunakan tool yang benar-benar diekspos server untuk membaca konteks project, deployment, dokumentasi, dan log yang tersedia—tanpa menyalin token atau secret ke prompt.

Keamanan setup ini bergantung pada tiga lapisan: scope OAuth sebagai batas akses utama, pembatasan project pada instruksi dan sesi agent sebagai guardrail operasional, serta pemeriksaan setiap tool call sebelum dijalankan. Daftar tool dapat berubah, sehingga daftar tool yang ditampilkan klien MCP dan layar persetujuan OAuth harus diperlakukan sebagai sumber kebenaran, bukan asumsi dari prompt atau artikel.

Prasyarat dan model akses

Sebelum menghubungkan coding agent, siapkan komponen berikut:

Akun Vercel yang memiliki akses minimum ke team dan project yang akan diperiksa.
Coding agent atau editor yang mendukung remote MCP server dan autentikasi OAuth.
Browser untuk menyelesaikan login dan persetujuan akses.
Nama team, nama atau ID project, dan deployment yang akan diperiksa.
Kebijakan internal mengenai data apa yang boleh dikirim ke model, terutama source code, log produksi, data pengguna, dan metadata deployment.

Endpoint remote MCP resmi Vercel adalah:

https://mcp.vercel.com

Gunakan endpoint resmi melalui HTTPS. Jangan menggantinya dengan proxy yang tidak diaudit dan jangan menambahkan access token Vercel secara manual ke file konfigurasi jika alur resminya menggunakan OAuth.

Memahami batas scope

Dalam alur OAuth, pengguna diminta masuk ke Vercel dan memilih atau menyetujui cakupan akun/team yang tersedia pada layar otorisasi. Berikan akses hanya ke team yang diperlukan. Jika organisasi menyediakan team khusus development atau staging, pilih scope tersebut daripada production.

Jangan menganggap pemilihan project di dalam prompt sebagai batas keamanan. Instruksi seperti “gunakan hanya project web-staging” membantu mencegah salah target, tetapi tidak mengurangi hak OAuth. Batas keamanan sebenarnya tetap ditentukan oleh akun, keanggotaan team, grant OAuth, dan kontrol yang diterapkan Vercel.

Apabila layar OAuth hanya menawarkan scope pada tingkat team, sementara tugas hanya membutuhkan satu project, gunakan kombinasi berikut:

Pakai akun atau role dengan hak minimum pada team terkait.
Catat dan kunci nama serta ID project dalam instruksi sesi.
Larangan eksplisit untuk mengakses project lain.
Periksa argumen tool call sebelum eksekusi.
Gunakan sesi agent terpisah untuk lingkungan production.

Konfigurasi Vercel MCP pada coding agent

Format konfigurasi berbeda antar-klien. Contoh berikut memakai endpoint yang sama, tetapi nama file dan struktur konfigurasinya mengikuti masing-masing klien. Gunakan dokumentasi klien dan dokumentasi Vercel terbaru jika versi yang terpasang menampilkan skema berbeda.

Claude Code

Pada Claude Code yang mendukung penambahan remote MCP melalui CLI, server dapat didaftarkan dengan transport HTTP:

claude mcp add --transport http vercel https://mcp.vercel.com

Sesudah ditambahkan, buka daftar server MCP atau mulai penggunaan tool Vercel. Klien akan meminta autentikasi melalui browser apabila grant OAuth belum tersedia. Jika opsi CLI berbeda pada versi yang digunakan, tambahkan remote server melalui antarmuka MCP klien dengan nama vercel dan URL yang sama.

Cursor

Cursor menggunakan konfigurasi MCP dengan bagian mcpServers. Konfigurasi umumnya berbentuk:

{
  "mcpServers": {
    "vercel": {
      "url": "https://mcp.vercel.com"
    }
  }
}

Konfigurasi dapat ditempatkan pada scope yang didukung Cursor, misalnya konfigurasi pengguna atau workspace. Untuk akses sensitif, scope pengguna biasanya lebih aman daripada file project yang berpotensi masuk ke Git. Meskipun konfigurasi di atas tidak memuat secret, kebijakan server internal dan metadata lain tetap sebaiknya tidak dikomit tanpa peninjauan.

Visual Studio Code

Pada VS Code yang memiliki dukungan MCP, konfigurasi workspace menggunakan struktur servers:

{
  "servers": {
    "vercel": {
      "type": "http",
      "url": "https://mcp.vercel.com"
    }
  }
}

Simpan pada lokasi konfigurasi MCP yang ditentukan oleh VS Code, kemudian mulai server dari panel atau command yang disediakan editor. Jangan menambahkan header Authorization buatan sendiri kecuali dokumentasi resmi secara eksplisit mensyaratkannya.

Klien lain

Klien lain dapat digunakan apabila mendukung remote MCP melalui HTTPS dan alur OAuth yang diperlukan server. Dukungan terhadap MCP lokal melalui stdio saja belum tentu cukup. Pastikan klien dapat membuka login browser, menyimpan grant secara aman, menampilkan tool yang ditemukan, dan meminta persetujuan sebelum tool dipanggil.

Autentikasi, pemilihan project, dan verifikasi tool

Alur autentikasi yang aman adalah sebagai berikut:

Klien menghubungi https://mcp.vercel.com.
Vercel mengarahkan pengguna ke login dan persetujuan OAuth.
Pengguna memeriksa identitas akun, team, dan scope yang diminta.
Vercel memberikan grant kepada klien tanpa pengguna menempelkan token ke prompt.
Klien menemukan daftar tool yang tersedia dari server MCP.
Agent memanggil tool dengan parameter team, project, atau deployment yang relevan.

Setelah login, jangan langsung memberikan tugas yang luas. Mulailah dengan operasi penemuan dan baca yang sempit:

Tampilkan identitas atau team yang dapat diakses.
Cari project berdasarkan nama.
Konfirmasikan ID project dan environment target.
Batasi pencarian deployment berdasarkan project tersebut.
Ambil detail atau log hanya untuk deployment yang sedang dianalisis.

Instruksi sesi berikut dapat mengurangi salah target:

Gunakan Vercel MCP hanya untuk team acme-staging dan project web-staging.
Mulai dengan operasi baca untuk menemukan ID project yang tepat.
Jangan mengakses project lain atau environment production.
Sebelum setiap tool call, tampilkan nama tool, target, dan tujuannya.
Jangan menjalankan aksi tulis, perubahan konfigurasi, redeploy,
atau pembuatan akses sementara tanpa persetujuan eksplisit saya.
Jangan menampilkan atau menyalin secret, token, cookie, atau nilai env.

Instruksi tersebut adalah guardrail, bukan pengganti kontrol akses. Agent masih dapat membuat kesalahan, dan server hanya dapat menegakkan batas yang memang direpresentasikan oleh autentikasi serta implementasi tool.

Bedakan kemampuan baca dan tulis

Vercel MCP berfokus pada pemberian konteks Vercel kepada agent. Bergantung pada daftar tool yang tersedia saat digunakan, operasi baca dapat mencakup pencarian dokumentasi, penemuan team dan project, daftar deployment, detail deployment, build log, runtime log, atau pengambilan halaman Vercel yang dapat diakses oleh pengguna.

Jangan menyimpulkan bahwa server mendukung aksi tulis hanya karena Vercel API atau CLI mempunyai kemampuan tersebut. Jika daftar tool tidak menampilkan operasi untuk mengubah environment variable, membuat deployment, redeploy, membatalkan deployment, atau mengubah domain, maka agent tidak dapat melakukannya melalui koneksi MCP tersebut.

Jika suatu saat tool mutasi muncul pada daftar tool, perlakukan sebagai kemampuan baru yang harus diaudit. Periksa deskripsi tool, parameter, scope OAuth, dan efek sampingnya. Terapkan persetujuan manual untuk setiap aksi tulis, bukan persetujuan global untuk seluruh sesi.

Operasi baca bukan berarti tanpa risiko. Build log dan runtime log dapat memuat URL internal, alamat email, payload, header, atau secret yang tidak sengaja dicetak aplikasi.

Mendiagnosis kegagalan build secara aman

Kasus penggunaan yang tepat untuk Vercel MCP adalah mengumpulkan bukti kegagalan deployment tanpa memberikan agent akses yang lebih luas dari kebutuhan diagnosis.

Alur diagnosis yang disarankan

Temukan team dan project target, lalu konfirmasikan identitasnya.
Ambil daftar deployment terbaru pada project tersebut.
Pilih deployment berstatus gagal dan catat ID, branch, commit, waktu, serta environment.
Ambil detail deployment dan build log yang terkait.
Cari error pertama yang relevan, bukan hanya pesan kegagalan terakhir.
Hubungkan error dengan file atau konfigurasi repository lokal.
Minta agent mengusulkan patch, tetapi tinjau perubahan sebelum commit atau deployment ulang.

Contoh prompt diagnosis:

Gunakan tool baca Vercel MCP untuk project web-staging saja.
Cari deployment gagal terbaru dari branch fix/checkout.
Tampilkan ID deployment dan metadata ringkas sebelum mengambil build log.
Dari log, kutip hanya baris yang diperlukan dan redaksi token, cookie,
header autentikasi, nilai environment, serta data pengguna.
Jelaskan akar masalah dan usulkan perubahan kode lokal.
Jangan melakukan redeploy atau mengubah konfigurasi Vercel.

Pendekatan ini bekerja karena pencarian dipersempit sebelum log diambil. Agent memperoleh konteks yang cukup untuk menghubungkan error build dengan source code, tetapi tidak diberi izin implisit untuk mengubah infrastruktur.

Membaca log dengan benar

Build log digunakan untuk dependency yang gagal dipasang, perintah build yang berhenti, type error, file hilang, atau konfigurasi framework yang tidak valid.
Runtime log lebih relevan ketika deployment berhasil tetapi request menghasilkan error saat aplikasi berjalan.
Metadata deployment diperlukan untuk memastikan log berasal dari commit, branch, region, dan environment yang dimaksud.

Jangan meminta semua log production jika satu deployment staging sudah cukup. Bila log mengandung secret, hentikan analisis, redaksi data dari percakapan, perbaiki logging aplikasi, dan rotasi secret yang mungkin telah terekspos.

Least privilege, audit, dan guardrail

Kontrol akses minimum

Gunakan akun dengan role paling rendah yang masih dapat membaca konteks yang diperlukan.
Pilih team staging atau development bila diagnosis tidak membutuhkan production.
Pisahkan sesi dan konfigurasi agent antara organisasi atau lingkungan berbeda.
Jangan membagikan cache OAuth, cookie browser, access token, atau file kredensial.
Hindari konfigurasi agent tanpa batas pada runner CI atau mesin bersama.

Larangan menyalin secret ke prompt

Agent tidak memerlukan nilai environment variable untuk mengetahui bahwa sebuah variabel belum tersedia atau salah konfigurasi. Berikan nama variabel, bukan nilainya. Contohnya, tulis DATABASE_URL tidak tersedia saat build, bukan connection string lengkap.

Jangan menempelkan token Vercel ke prompt untuk “membantu login”. Prompt, transcript, telemetry klien, dan log debugging dapat memiliki siklus penyimpanan berbeda dari secret manager. Gunakan OAuth serta penyimpanan kredensial yang disediakan klien.

Pemeriksaan aksi sebelum eksekusi

Untuk setiap tool call, tinjau sedikitnya:

Nama dan deskripsi tool.
Team, project, deployment, dan environment target.
Rentang waktu serta volume log.
Apakah operasi hanya membaca atau mempunyai efek samping.
Data yang akan dikirim kembali ke model.
Apakah tujuan dapat dicapai dengan scope yang lebih sempit.

Aktifkan mode persetujuan per-tool pada klien jika tersedia. Tolak mode yang mengizinkan seluruh tool secara otomatis untuk sesi production. Tool yang membuat akses sementara ke URL terlindungi juga perlu dianggap sensitif meskipun tidak mengubah source code.

Audit yang berguna

Catat aktivitas pada tingkat yang cukup untuk investigasi tanpa menduplikasi data sensitif:

Identitas operator dan klien MCP.
Waktu autentikasi dan pencabutan grant.
Team, project, dan deployment yang diakses.
Nama tool, tujuan, dan hasil umum.
Persetujuan untuk operasi sensitif atau aksi yang memiliki efek samping.

Gunakan log lokal klien dan audit log organisasi Vercel jika tersedia pada paket serta kebijakan organisasi. Hindari menyimpan respons log mentah sebagai bagian audit apabila ringkasan dan referensi deployment sudah memadai.

Troubleshooting, verifikasi, dan teardown

Masalah koneksi yang umum

Server tidak terdeteksi: periksa URL, dukungan remote MCP, struktur konfigurasi, dan apakah file dimuat pada scope pengguna atau workspace yang benar.
Browser login tidak terbuka: mulai autentikasi melalui panel MCP klien. Pada lingkungan headless, gunakan mekanisme login yang resmi didukung klien; jangan mengganti OAuth dengan token di prompt.
OAuth berulang: periksa penyimpanan kredensial klien, cookie browser, kebijakan SSO, waktu sistem, serta kemungkinan grant dicabut.
Team atau project tidak terlihat: pastikan akun memiliki akses dan team yang benar dipilih saat otorisasi. Logout lalu otorisasi ulang bila scope awal keliru.
Tool tidak tersedia: refresh koneksi dan periksa daftar tool aktual. Jangan meminta agent menggunakan nama tool dari contoh lama.
Log kosong: konfirmasikan ID deployment, environment, rentang waktu, dan jenis log. Build log dan runtime log melayani fase yang berbeda.
Akses ditolak pada URL deployment: deployment mungkin dilindungi atau grant tidak memiliki akses. Gunakan hanya mekanisme akses yang diekspos server dan disetujui organisasi.

Checklist verifikasi

Endpoint adalah https://mcp.vercel.com.
Login dilakukan melalui OAuth, bukan token yang ditempel ke prompt.
Akun dan team pada layar persetujuan sudah benar.
Daftar tool diperiksa sebelum agent mulai bekerja.
Project dan environment target sudah dikonfirmasi dengan ID atau metadata unik.
Tool call sensitif memerlukan persetujuan manual.
Agent dilarang membaca project lain dan menampilkan secret.
Diagnosis diuji terlebih dahulu pada deployment non-production bila memungkinkan.
Aktivitas penting tercatat tanpa menyimpan log mentah yang sensitif.

Teardown dan pencabutan akses

Setelah investigasi selesai, lakukan teardown berlapis:

Hentikan atau nonaktifkan server Vercel MCP pada klien.
Hapus entri vercel dari konfigurasi MCP jika koneksi tidak lagi diperlukan.
Keluar atau bersihkan sesi autentikasi melalui fitur yang disediakan klien.
Buka pengaturan akun atau organisasi Vercel, cari aplikasi terotorisasi atau koneksi OAuth, lalu cabut grant terkait. Nama menu dapat berubah, jadi verifikasi bahwa grant benar-benar hilang.
Periksa audit log untuk aktivitas yang tidak diharapkan.
Jika token, cookie, atau secret pernah masuk ke prompt atau log, anggap terekspos dan lakukan rotasi; menghapus percakapan saja tidak cukup.

Penghapusan konfigurasi lokal tidak selalu mencabut grant OAuth di sisi Vercel, sedangkan pencabutan grant tidak selalu menghapus cache dari klien. Keduanya perlu dilakukan agar teardown lengkap.

Dengan scope yang sempit, verifikasi tool aktual, persetujuan per-aksi, dan prosedur pencabutan yang jelas, Vercel MCP dapat dipakai sebagai jalur diagnosis deployment yang terkontrol tanpa menjadikan coding agent sebagai pemegang akses infrastruktur yang tidak terbatas.

Quick Search

shopping_cart Keranjang