Integrasi Claude Code MCP: Sambungkan Alat kepada Agen

Dikemaskini kali terakhir: June 28, 2026

Secara lalai, Claude Code membaca dan menyunting fail serta menjalankan arahan shell. Ia tidak dapat membaca isu GitHub anda, membuat pertanyaan ke pangkalan data anda, atau mengendalikan pelayar web. Model Context Protocol (MCP) menutup jurang itu: ia adalah palam piawai yang membenarkan ejen bercakap dengan alat dan data luaran. Panduan ini menunjukkan arahan claude mcp add yang tepat, bila memilih pelayan tempatan berbanding jarak jauh, cara skop berfungsi, pelayan mana yang patut disambungkan, dan semakan keselamatan yang perlu dijalankan sebelum anda mempercayainya.

Jawapan ringkas: bagaimana anda menambah pelayan MCP ke Claude Code?

Anda mendaftarkan pelayan menggunakan arahan claude mcp add, kemudian Claude Code boleh memanggil alatnya semasa sesi.

Untuk pelayan tempatan yang berjalan sebagai proses pada mesin anda:

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

Untuk pelayan jauh yang diakses melalui HTTPS:

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

Selepas menambah pelayan, jalankan /mcp di dalam Claude Code untuk melihat status sambungannya dan melengkapkan sebarang log masuk OAuth. Gunakan claude mcp list untuk mengesahkan pendaftarannya. Rujukan arahan rasmi terdapat di Claude Code MCP docs.

Apa itu MCP, dan mengapa ia disambungkan kepada Claude Code?

MCP ialah protokol terbuka, yang pertama diterbitkan oleh Anthropic, yang mentakrifkan cara klien AI dan pelayan alat bertukar keupayaan. Sebuah pelayan mengiklankan tools (tindakan yang boleh diambil ejen), resources (data yang boleh dibacanya), dan prompts. Mana-mana klien yang sedar MCP boleh menggunakan mana-mana pelayan MCP, jadi satu pelayan GitHub berfungsi dalam Claude Code, IDE, atau ejen lain tanpa gam khas. Spesifikasi dan pendaftar pelayan boleh didapati di modelcontextprotocol.io.

Manfaat praktikalnya: daripada menampal badan isu ke dalam sembang, anda hanya perlu menyambungkan pelayan GitHub sekali dan meminta ejen untuk membaca, melabel, dan membalas isu secara langsung. Untuk latar belakang yang lebih mendalam mengenai protokol itu sendiri, lihat MCP explainer kami, dan untuk alat penuh dalam konteks, sila rujuk Claude Code ultimate guide.

Sebuah pelayan boleh menjadi skrip stdio kecil yang anda tulis, imej Docker, atau titik akhir SaaS yang dihoskan oleh pembekal. Claude Code melayan kesemuanya dengan cara yang sama setelah mereka bercakap MCP.

Transport Manakah Yang Perlu Digunakan: Tempatan atau Jauh?

Transport adalah bagaimana Claude Code mencapai pelayan. Pelayan tempatan berjalan pada mesin anda melalui stdio; pelayan jauh berjalan di tempat lain dan membalas melalui HTTP atau SSE. Pilihan biasanya mengikut lokasi data itu berada.

Gunakan pelayan stdio tempatan apabila alat itu memerlukan fail atau perkhidmatan pada komputer riba anda, seperti folder aset projek atau pangkalan data Postgres pada localhost. Gunakan pelayan HTTP atau SSE jauh apabila vendor sudah menghoskannya, kerana anda melangkau pemasangan dan mendapatkan kemas kini tanpa menyentuh konfigurasi anda. Pelayan jauh hampir selalu mendaftar masuk melalui OAuth, yang anda picu dari menu /mcp.

Memilih skop: tempatan, projek, atau pengguna

Skop menentukan siapa melihat pelayan dan di mana konfigurasi disimpan. Claude Code menyokong tiga skop, dan memilih yang betul akan mengekalkan rahsia anda di luar repo sambil masih berkongsi pelayan selamat dengan pasukan.

Tetapkan skop dengan bendera --scope, contohnya claude mcp add --scope project .... Skop projek menulis .mcp.json yang disemak masuk (checked-in), jadi jangan pernah letakkan token mentah di sana; rujuk pemboleh ubah persekitaran pula. Skop tempatan adalah lalai dan tempat paling selamat untuk menguji pelayan baharu sebelum anda komited untuk berkongsinya. Jika anda juga membina Claude Code skills, kekalkan skop pelayan dan skop kemahiran konsisten supaya rakan sepasukan yang menarik (pulls) repo mendapat persediaan yang berfungsi.

Bagaimana cara menambah pelayan dengan claude mcp add?

Pola yang sama digunakan untuk setiap pelayan: nama, bendera transport pilihan, dan arahan atau URL. Pemisah -- menandakan permulaan arahan tempatan dan hujah-hujahnya.

Tambah pelayan sistem fail tempatan yang dihadkan kepada satu folder supaya ejen hanya boleh mengakses apa yang anda benarkan:

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

Hantar rahsia sebagai pembolehubah persekitaran berbanding dengan pengekodannya secara keras (hardcoding):

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

Tambah pelayan jauh dengan transport dan URL-nya:

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

Kemudian uruskan apa yang anda ada:

• claude mcp list menunjukkan setiap pelayan berdaftar dan statusnya.
• claude mcp get <name> mencetak konfigurasi satu pelayan.
• claude mcp remove <name> menyahdaftar ia.
• /mcp (ditaip dalam sesi) menunjukkan keadaan sambungan langsung dan menjalankan OAuth.

Pastikan penggunaan bendera adalah dekat dengan dokumentasi rasmi; vendor kadangkala menukar nama pakej atau URL pelayan, jadi salin nilai semasa dari README pelayan itu sendiri daripada membuat tekaan.

Pelayan MCP Biasa yang Berbaloi Dihubungkan

Mulakan dengan satu pelayan yang menghilangkan tugas yang benar-benar rumit, buktikan ia berfungsi, kemudian tambah lagi. Ini adalah antara pelayan yang dicari oleh pembangun pada mulanya, dan apa yang setiap satunya buka kunci.

Pelayan Playwright MCP server menonjol untuk kerja front-end: ejen membuka halaman anda, mengklik melalui aliran (flow), dan melaporkan apa yang rosak dengan tangkapan skrin. Pelayan pangkalan data berguna untuk soalan skema bacaan sahaja (read-only), tetapi hadkan ia kepada replika bacaan supaya sebarang pertanyaan tersasar tidak boleh menulis. Apabila anda mula menyambungkan beberapa pelayan bersama, salurkan kerja berat ke pekerja khusus menggunakan Claude Code subagents agar sesi utama kekal responsif.

Senario: menyambungkan pelayan MCP GitHub untuk membuka PRs

Bayangkan anda ingin ejen itu menyaring isu dan membuka pull requests dalam satu repo. GitHub menghoskan pelayan MCP jauh rasmi, jadi anda tidak perlu memasang apa-apa secara tempatan.

1. Daftar pelayan yang dihoskan:

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

2. Taip /mcp dalam Claude Code, pilih github, dan lengkapkan log masuk OAuth dalam pelayar anda. Token itu kekal dengan GitHub; anda tidak pernah menampalnya ke dalam fail.

3. Sahkan alat yang dimuatkan dengan claude mcp list.

4. Sekarang tanya dalam bahasa biasa:

   • "Senaraikan isu terbuka yang dilabel bug dan ringkaskan tiga teratas."
   • "Buka draf PR dari fix/login-redirect ke main dengan penerangan ringkas."
   • "Baca PR #214 dan tandakan apa-apa yang menyentuh pengesahan (authentication)."

Ejen itu membaca utas isu, membuat draf badan PR, dan menghubungkan isu yang betul, semuanya tanpa anda meninggalkan terminal. Berikan akses aplikasi GitHub kepada satu repositori dahulu, semak apa yang dicadangkan oleh ejen, dan perluaskan akses hanya setelah anda percaya aliran kerja tersebut. Senarai alat penuh pelayan dan pilihan self-hosting didokumentasikan dalam GitHub MCP server repo.

Adakah selamat untuk menyambungkan pelayan MCP?

Pelayan MCP boleh menjalankan kod pada mesin anda atau bertindak ke atas akaun anda, jadi anggap setiap satu seperti memasang kebergantungan: hanya sambungkan pelayan yang anda percayai. Risikonya adalah nyata kerana pelayan yang berniat jahat atau rosak boleh mengeksfiltrasi fail atau mengambil tindakan merosakkan dengan kelayakan anda.

Jalankan semakan senarai ini sebelum menambah pelayan:

• Sahkan sumbernya. Lebih baik menggunakan pelayan vendor rasmi (GitHub, Sentry) atau pelayan rujukan yang diterbitkan berbanding pakej yang tidak diketahui.
• Baca alat apa yang ia dedahkan. Pelayan "baca isu saya" seharusnya tidak meminta akses tulis ke seluruh cakera anda.
• Skopkan dengan ketat. Arahkan pelayan sistem fail pada satu folder projek dan pelayan pangkalan data pada replika bacaan (read replica).
• Jauhkan rahsia daripada .mcp.json. Gunakan pembolehubah persekitaran dan jangan sekali-kali komit token sebenar.
• Berikan hak istimewa paling minimum pada OAuth. Beri aplikasi GitHub satu repositori, bukan keseluruhan organisasi anda, sehingga anda mempercayainya.
• Semak tindakan sebelum meluluskan. Baca PR atau pertanyaan yang dicadangkan oleh ejen; jangan luluskan secara automatik penulisan daripada pelayan baharu.

Anthropic menandakan risiko prompt-injection untuk pelayan yang mengambil kandungan web yang tidak dipercayai, jadi berhati-hati dengan sebarang pelayan yang menarik halaman rawak. Panduan keselamatan semasa terdapat di Claude Code MCP docs.

Penyelesaian Masalah Sambungan MCP

Kebanyakan kegagalan adalah konfigurasi atau autentikasi, bukan protokolnya. Ikuti langkah-langkah ini mengikut urutan:

• Server tidak disenaraikan: jalankan semula claude mcp list. Jika ia hilang, arahan add mungkin gagal; semak sama ada terdapat salah ejaan pada pemisah -- atau nama pakej.

• Status menunjukkan gagal dalam /mcp: proses itu tidak dapat dimulakan. Untuk pelayan stdio, jalankan arahan mentah (contohnya baris npx) di terminal anda untuk melihat ralat sebenar.

• Autentikasi gagal: buka /mcp, pilih pelayan, dan ulangi aliran OAuth. Untuk pelayan berasaskan token, sahkan pemboleh ubah persekitaran ditetapkan dalam shell yang melancarkan Claude Code.

• Alat tidak muncul: mulakan semula sesi Claude Code supaya ia memuat semula keupayaan pelayan, kemudian sahkan skop adalah yang boleh dilihat oleh projek semasa.

• Skop salah: pelayan yang ditambah dengan --scope local tidak akan muncul untuk rakan sepasukan; tambah semula dengan --scope project jika ia perlu dikongsi.

Apabila pelayan jauh menukar URLnya atau pakej diubah namanya, konfigurasi anda yang disimpan menjadi lapuk (stale). Ambil nilai semasa daripada README pelayan dan tambah semula berbanding menyunting secara membuta tuli.

Intipati Utama

MCP mengubah Claude Code dari ejen fail dan shell menjadi ejen yang bercakap dengan alat sebenar anda. Tambah pelayan menggunakan claude mcp add, pilih stdio untuk data tempatan dan HTTP/SSE untuk perkhidmatan yang dihoskan, dan tetapkan skop berdasarkan siapa yang patut melihat pelayan itu. Sambungkan satu pelayan berguna dahulu; pelayan GitHub adalah permulaan yang kukuh, dan sahkan sumber serta kebenaran setiap pelayan sebelum anda mempercayainya. Simpan token dalam pemboleh ubah persekitaran (environment variables), skop akses sistem fail dan pangkalan data secara ketat, dan semak tindakan ejen sehingga pelayan baharu itu layak.