Integrasi Claude Code MCP: Menghubungkan Alat ke Agen

Terakhir diperbarui: June 28, 2026

Secara out of the box, Claude Code dapat membaca dan mengedit file serta menjalankan perintah shell. Ia tidak dapat membaca isu GitHub Anda, menanyakan database Anda, atau menggerakkan browser. Model Context Protocol (MCP) menutup kesenjangan itu: ini adalah plug standar yang memungkinkan agen berbicara dengan alat dan data eksternal. Panduan ini menunjukkan perintah claude mcp add yang tepat, kapan harus memilih server lokal versus jarak jauh, cara kerja scope, server mana yang layak dihubungkan, dan pemeriksaan keamanan yang harus dijalankan sebelum Anda mempercayainya.

Jawaban cepat: bagaimana menambahkan server MCP ke Claude Code?

Anda mendaftarkan server dengan perintah claude mcp add, kemudian Claude Code dapat memanggil alatnya selama sesi berlangsung.

Untuk server lokal yang berjalan sebagai proses di mesin Anda:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Untuk server jarak jauh yang diakses melalui HTTPS:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Setelah menambahkan server, jalankan /mcp di dalam Claude Code untuk melihat status koneksinya dan menyelesaikan tanda masuk OAuth apa pun. Gunakan claude mcp list untuk memastikan pendaftaran berhasil. Referensi perintah resmi terdapat di Claude Code MCP docs.

Apa itu MCP, dan mengapa menghubungkannya ke Claude Code?

MCP adalah protokol terbuka, pertama kali diterbitkan oleh Anthropic, yang mendefinisikan bagaimana klien AI dan server alat bertukar kemampuan. Sebuah server mengiklankan tools (tindakan yang dapat dilakukan agen), resources (data yang dapat dibaca), dan prompts. Setiap klien yang sadar MCP dapat menggunakan setiap server MCP, jadi satu server GitHub berfungsi di Claude Code, IDE, atau agen lain tanpa perlu pengikat khusus. Spesifikasi dan registri server ada di modelcontextprotocol.io.

Manfaat praktisnya: alih-alih menempelkan isi isu ke dalam chat, Anda menghubungkan server GitHub sekali dan meminta agen untuk membaca, memberi label, dan menanggapi isu secara langsung. Untuk latar belakang yang lebih mendalam tentang protokol itu sendiri, lihat MCP explainer kami, dan untuk panduan alat lengkap dalam konteks, baca Claude Code ultimate guide.

Sebuah server bisa berupa skrip stdio kecil yang Anda tulis, Docker image, atau endpoint SaaS yang di-host oleh vendor. Claude Code memperlakukan semuanya dengan cara yang sama setelah mereka berbicara MCP.

Transport mana yang harus Anda gunakan: lokal atau jarak jauh?

Transport adalah bagaimana Claude Code mencapai server. Server lokal berjalan di mesin Anda melalui stdio; server jarak jauh berjalan di tempat lain dan merespons melalui HTTP atau SSE. Pilihan biasanya mengikuti lokasi data berada.

Gunakan server stdio lokal ketika alat memerlukan file atau layanan di laptop Anda, seperti folder aset proyek atau instance Postgres pada localhost. Gunakan server HTTP atau SSE jarak jauh ketika vendor sudah menghostingnya, karena Anda melewati instalasi dan mendapatkan pembaruan tanpa menyentuh konfigurasi Anda. Server jarak jauh hampir selalu meminta tanda masuk melalui OAuth, yang Anda picu dari menu /mcp.

Memilih scope: lokal, proyek, atau pengguna

Scope menentukan siapa yang melihat server dan di mana konfigurasinya disimpan. Claude Code mendukung tiga jenis, dan memilih yang tepat menjaga rahasia tetap di luar repo Anda sambil tetap berbagi server aman dengan tim.

Atur scope dengan flag --scope, misalnya claude mcp add --scope project .... Scope proyek menulis .mcp.json yang sudah diperiksa (checked-in), jadi jangan pernah menaruh token mentah di sana; referensikan variabel lingkungan sebagai gantinya. Scope lokal adalah default dan tempat teraman untuk menguji server baru sebelum Anda berkomitmen untuk membagikannya. Jika Anda juga membangun Claude Code skills, jaga agar scope server dan skill konsisten sehingga rekan tim yang menarik repo mendapatkan pengaturan yang berfungsi.

Bagaimana cara menambahkan server dengan claude mcp add?

Pola ini sama untuk setiap server: nama, flag transport opsional, dan perintah atau URL-nya. Pemisah -- menandai awal dari perintah lokal dan argumennya.

Tambahkan server filesystem lokal yang di-scope ke satu folder agar agen hanya dapat menyentuh apa yang Anda izinkan:

claude mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem ~/projects/my-app

Berikan rahasia sebagai variabel lingkungan alih-alih men-hardcode-nya:

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

Tambahkan server jarak jauh dengan transport dan URL-nya:

claude mcp add --transport sse linear https://mcp.linear.app/sse

Kemudian kelola apa yang Anda miliki:

• claude mcp list menampilkan setiap server terdaftar dan statusnya.
• claude mcp get <name> mencetak konfigurasi satu server.
• claude mcp remove <name> menghapus pendaftarannya.
• /mcp (diketik dalam sesi) menampilkan status koneksi langsung dan menjalankan OAuth.

Jaga penggunaan flag dekat dengan dokumentasi resmi; vendor kadang mengubah nama paket atau URL server, jadi salin nilai saat ini dari README server itu sendiri daripada menebak.

Server MCP umum yang layak dihubungkan

Mulailah dengan satu server yang menghilangkan tugas nyata, buktikan fungsinya, lalu tambahkan yang lain. Ini adalah yang pertama kali dicari oleh pengembang, dan apa yang dibuka oleh masing-masing.

Playwright MCP server adalah yang menonjol untuk pekerjaan front-end: agen membuka halaman Anda, mengklik melalui alur, dan melaporkan apa yang rusak dengan tangkapan layar. Server database berguna untuk pertanyaan skema baca-saja, tetapi atur scope-nya ke replika baca agar kueri yang menyimpang tidak pernah menulis. Ketika Anda mulai merangkai beberapa server bersamaan, arahkan pekerjaan berat ke pekerja khusus menggunakan Claude Code subagents sehingga sesi utama tetap responsif.

Skenario: menghubungkan server MCP GitHub untuk membuka PR

Misalnya Anda ingin agen melakukan triase isu dan membuka pull request di satu repo. GitHub menghosting server MCP jarak jauh resmi, jadi Anda tidak perlu menginstal apa pun secara lokal.

1. Daftarkan server yang di-host:

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/
   

2. Ketik /mcp di Claude Code, pilih github, dan selesaikan tanda masuk OAuth di browser Anda. Token tetap berada di GitHub; Anda tidak pernah menempelkannya ke dalam file.

3. Konfirmasi alat yang dimuat dengan claude mcp list.

4. Sekarang tanyakan dalam bahasa biasa:

   • "Daftar isu terbuka berlabel bug dan ringkas tiga teratas."
   • "Buka PR draf dari fix/login-redirect ke main dengan deskripsi singkat."
   • "Baca PR #214 dan tandai apa pun yang menyentuh otentikasi."

Agen membaca utas isu, membuat draf isi PR, dan menautkan isu yang tepat, semua tanpa Anda meninggalkan terminal. Berikan akses aplikasi GitHub ke satu repositori terlebih dahulu, tinjau apa yang diusulkan agen, dan perluas akses hanya setelah Anda mempercayai alur kerjanya. Daftar alat lengkap server dan opsi self-hosting-nya didokumentasikan di GitHub MCP server repo.

Apakah aman menghubungkan server MCP?

Server MCP dapat menjalankan kode di mesin Anda atau bertindak atas akun Anda, jadi perlakukan masing-masing seperti menginstal dependensi: hubungkan hanya server yang Anda percayai. Risikonya nyata karena server yang berbahaya atau buggy dapat mengekfiltrasi file atau melakukan tindakan destruktif dengan kredensial Anda.

Lalui daftar periksa ini sebelum menambahkan server:

• Konfirmasi sumbernya. Lebih disukai server vendor resmi (GitHub, Sentry) atau server referensi yang diterbitkan daripada paket yang tidak dikenal.
• Baca alat apa yang diekspos. Server "baca isu saya" seharusnya tidak meminta akses tulis ke seluruh disk Anda.
• Scope dengan ketat. Arahkan server filesystem ke satu folder proyek dan server database ke replika baca.
• Jauhkan rahasia dari .mcp.json. Gunakan variabel lingkungan dan jangan pernah meng-commit token nyata.
• Berikan hak istimewa paling minimum pada OAuth. Beri aplikasi GitHub satu repo, bukan seluruh org Anda, sampai Anda mempercayainya.
• Tinjau tindakan sebelum menyetujui. Baca PR atau kueri yang diusulkan agen; jangan setuju secara otomatis untuk penulisan dari server baru.

Anthropic menandai risiko prompt-injection untuk server yang mengambil konten web yang tidak tepercaya, jadi berhati-hatilah ekstra dengan server apa pun yang menarik halaman arbitrer. Panduan keamanan saat ini ada di Claude Code MCP docs.

Pemecahan Masalah koneksi MCP

Sebagian besar kegagalan adalah konfigurasi atau otentikasi, bukan protokolnya. Kerjakan ini secara berurutan:

• Server tidak terdaftar: jalankan ulang claude mcp list. Jika hilang, perintah add kemungkinan gagal; periksa kesalahan ketik pada pemisah -- atau nama paket.

• Status menunjukkan gagal di /mcp: prosesnya tidak dapat dimulai. Untuk server stdio, jalankan perintah mentah (misalnya baris npx) di terminal Anda untuk melihat error yang sebenarnya.

• Otentikasi gagal: buka /mcp, pilih server, dan ulangi alur OAuth. Untuk server berbasis token, konfirmasi bahwa variabel lingkungan telah diatur di shell yang meluncurkan Claude Code.

• Alat tidak muncul: mulai ulang sesi Claude Code agar ia memuat ulang kemampuan server, lalu verifikasi bahwa scope-nya adalah yang dapat dilihat oleh proyek saat ini.

• Scope salah: server yang ditambahkan dengan --scope local tidak akan terlihat oleh rekan tim; tambahkan lagi dengan --scope project jika seharusnya dibagikan.

Ketika server jarak jauh mengubah URL-nya atau paket diubah namanya, konfigurasi Anda tersimpan menjadi usang (stale). Tarik nilai saat ini dari README server dan tambahkan kembali daripada mengedit secara membabi buta.

Poin penting

MCP mengubah Claude Code dari agen file-dan-shell menjadi agen yang berbicara dengan alat nyata Anda. Tambahkan server dengan claude mcp add, pilih stdio untuk data lokal dan HTTP/SSE untuk layanan hosted, serta atur scope berdasarkan siapa yang harus melihat server tersebut. Hubungkan satu server berguna terlebih dahulu, server GitHub adalah awal yang kuat, dan verifikasi sumber serta izin setiap server sebelum Anda mempercayainya. Simpan token di variabel lingkungan, batasi akses filesystem dan database secara sempit, dan tinjau tindakan agen sampai server baru telah membuktikannya.