Setup MCP Server Claude Code: Scope, Auth, Budget Tool

Begitu sebuah agen coding bisa membaca issue tracker Anda, mengueri basis data, dan memeriksa monitoring error, sifat pekerjaannya berubah: Anda berhenti menempelkan konteks dan mulai mengajukan pertanyaan. Model Context Protocol adalah standar terbuka yang memungkinkan itu, dan Claude Code berbicara dengannya secara native.

Yang lebih jarang dibahas adalah sisi tata kelolanya. Setiap server yang Anda tambahkan adalah sebuah permukaan — untuk pembengkakan konteks, untuk kredensial, dan untuk konten yang datang dari luar basis kode Anda. Ini cara menyiapkannya dengan benar, beserta bagian-bagian tajamnya.

Apa sebenarnya yang diberikan MCP kepada Claude Code

MCP adalah protokol klien-server. Claude Code adalah kliennya; setiap server menyediakan kombinasi tool yang bisa dipanggil, resource yang bisa dibaca, dan prompt yang bisa ditawarkan sebagai slash command. Protokolnya terbuka dan tidak spesifik untuk Anthropic, dan karena itulah server yang sama bisa melayani beberapa klien berbeda.

Pemicu praktis untuk menambahkannya sederhana: kalau Anda mendapati diri menyalin data ke dalam sesi dari sistem lain — sebuah tiket, log, skema — sistem itu pantas mendapat server. Kalau Anda tidak menyalin apa pun, kemungkinan besar Anda tidak membutuhkannya, dan dokumentasi resminya eksplisit bahwa perkakas baris perintah biasa sering lebih hemat konteks daripada MCP server untuk pekerjaan yang sama.

Tiga scope, dan cara memilihnya

Scope yang Anda pilih menentukan di proyek mana sebuah server dimuat dan apakah tim Anda ikut mendapatkannya. Salah memilih adalah cara eksperimen pribadi berakhir di sesi semua orang, atau cara server tim harus ditambahkan ulang oleh setiap anggota baru.

Patokan saya: scope user untuk hal-hal tentang saya — catatan saya, kalender saya, akun cloud saya. Scope project untuk hal-hal tentang basis kode yang dibutuhkan rekan kerja sejak hari pertama. Scope local untuk apa pun yang eksperimental atau menyimpan kredensial yang tidak berniat saya bagikan.

Menambahkan server, dan memastikan ia benar-benar jalan

Server hadir dalam beberapa transport: proses lokal lewat stdio, endpoint HTTP jarak jauh, endpoint SSE, dan WebSocket untuk server yang mendorong event. Baris perintah menutup semua yang umum, dan bentuk JSON-nya menerima streamable-http sebagai alias http sehingga konfigurasi yang disalin dari dokumen vendor bisa dipakai tanpa diubah.

# Remote HTTP server, shared with the team via .mcp.json
claude mcp add --transport http --scope project sentry https://mcp.sentry.dev/mcp

# Local stdio server: everything after -- is passed to the server untouched
claude mcp add --env DB_URL=postgres://localhost/dev --transport stdio db \
  -- npx -y @company/db-mcp --readonly

# Check what is configured and whether it actually connects
claude mcp list        # ✔ Connected / ! Needs authentication / ✘ Failed
claude mcp get sentry  # one server in detail

Langkah verifikasinya lebih penting daripada kelihatannya. Menambahkan server hanya menulis konfigurasi; kolom statuslah yang memberi tahu apakah ia terhubung, butuh autentikasi, atau gagal. Server yang berhenti di status butuh-autentikasi terlihat sudah terkonfigurasi dan tidak melakukan apa-apa, dan itulah bentuk paling umum dari keluhan sudah saya tambahkan tapi Claude mengabaikannya.

Tool search, dan kenapa konteks tetap murah

Keberatan paling jelas terhadap menghubungkan banyak server adalah konteks. Dulu setiap definisi tool dimuat ke jendela saat sesi dimulai, sehingga beberapa server yang cerewet bisa memakan sebagian besar jendela sebelum Anda mengetik apa pun. Tool search mengubah itu.

• Definisi tool ditunda secara default. Hanya nama tool dan instruksi server yang dimuat di awal, dan Claude mencari tool ketika sebuah tugas membutuhkannya.
• Ada mode ambang batas kalau Anda lebih menyukainya: definisi dimuat sekaligus selama totalnya tetap di bawah sekitar sepersepuluh context window, dan ditunda setelah melewatinya.
• Instruksi server menjadi penting ketika tool search aktif, karena instruksi itulah yang memberi tahu Claude kapan harus mencari tool Anda sama sekali.

Ini layak diresapi karena membalik nasihat lama. Menambahkan server yang dideskripsikan dengan baik kini murah; yang mahal adalah menambahkan server dengan instruksi kabur dan empat puluh tool yang mirip satu sama lain, karena Claude tidak bisa menilai kapan harus memakainya.

Kepercayaan, persetujuan, dan prompt injection

Server ber-scope project adalah konfigurasi yang datang bersama sebuah repositori, artinya meng-clone repositori tidak boleh diam-diam memberinya kemampuan menjalankan proses di mesin Anda. Claude Code menanganinya lewat workspace trust: sampai Anda memercayai sebuah folder, persetujuan yang di-commit di dalam repositori itu diabaikan dan servernya tetap berstatus menunggu alih-alih terhubung.

Risiko yang lebih dalam adalah kontennya, bukan konfigurasinya. Server mana pun yang mengambil materi eksternal — halaman web, komentar issue, surel pelanggan — bisa membawa instruksi yang ditujukan kepada model, bukan kepada Anda. Panduan resminya tegas soal memastikan Anda memercayai sebuah server sebelum menghubungkannya, dan panduan itu berlaku untuk data yang ia kembalikan sama seperti untuk kode yang ia jalankan.

Checklist tata kelola untuk sebuah tim

Empat keputusan menutup sebagian besar hal yang perlu disepakati tim soal MCP sebelum ia menyebar.

1. Putuskan apa yang pantas masuk ke .mcp.json yang di-commit. Uji saya: apakah anggota baru akan terhambat tanpanya di hari pertama? Kalau tidak, itu scope local atau user.
2. Jauhkan kredensial dari berkas itu. Lewatkan melalui variabel lingkungan atau header helper yang mengambil token saat koneksi, jangan pernah sebagai literal di konfigurasi yang di-commit.
3. Setel timeout per server untuk apa pun yang menyentuh sistem lambat, agar satu integrasi yang tidak responsif tidak bisa menghentikan sesi.
4. Tinjau daftarnya setiap kuartal. Server menumpuk; jalankan perintah daftar, nonaktifkan yang tak pernah dipakai siapa pun, dan hapus yang tak bisa dijelaskan siapa pun.

Langkah terakhir itulah yang paling sering dilewati, dan justru itu yang menjaga semuanya berkelanjutan. Empat server terpilih yang rapi lebih berguna daripada lima belas yang tak seorang pun percayai.

Kapan tidak perlu menambahkan server

MCP tidak gratis, dan tiga situasi ini biasanya lebih baik ditangani dengan cara lain.

• Sistemnya sudah punya perkakas baris perintah yang bagus. CLI tidak menambah daftar tool ke konteks dan Claude bisa menjalankannya langsung.
• Anda butuh datanya sekali saja. Tempelkan, atau minta Claude mengambilnya dengan skrip; integrasi permanen untuk pertanyaan sekali pakai hanyalah beban.
• Server itu akan memegang akses tulis ke sesuatu yang tidak bisa dibatalkan. Kalau radius ledakannya mencakup data produksi, skrip yang dijalankan manusia dengan langkah tinjauan adalah bentuk yang lebih aman.

MCP mengubah agen yang menalar tentang kode Anda menjadi agen yang juga bisa melihat sistem Anda, dan implementasi Claude Code sudah menghapus sebagian besar biaya konteksnya. Yang tidak bisa dihapus adalah pertimbangan manusianya: server mana yang pantas berada di konfigurasi bersama, kredensial apa yang mereka pegang, dan seberapa jauh Anda memercayai konten yang mereka kembalikan.