Pelayan MCP untuk Claude Code pada 2026: 7 integrasi dan pemasangan

Arahan tambahan untuk bekerja dengan Ailoot terdapat dalam dokumentasi.

Apakah Pelayan MCP dan Mengapa Claude Code Memerlukannya?#

Anthropic mengumumkan MCP pada 25 November 2024 sebagai piawaian terbuka. Dalam tempoh setahun, protokol ini menjadi piawaian industri: OpenAI, Google DeepMind dan Microsoft menyokongnya. Repositori rasmi modelcontextprotocol/servers mengandungi pelayan rujukan daripada projek MCP sendiri (Filesystem, Memory, Sequential Thinking, Fetch dan lain-lain); vendor—GitHub, Notion, Stripe, Linear, Cloudflare dan Sentry—menerbitkan pelayan MCP dalam repositori masing-masing. Jumlah pelayan mencecah ribuan dalam indeks komuniti.

Dari segi teknikal, MCP berjalan melalui JSON-RPC 2.0. Seni binanya ringkas: Claude Code anda ialah klien, mana-mana perkhidmatan ialah pelayan, dan pelayan MCP di antaranya mempunyai tiga entiti: tools (perkara yang boleh dipanggil oleh AI), resources (perkara yang boleh dibaca oleh AI) dan prompts (templat siap guna).

Mengapa perkara ini penting bagi seorang vibe coder: sebelum MCP, setiap sambungan antara Claude dengan perkhidmatan pihak ketiga merupakan integrasi berasingan dengan wrapper tersendiri. Dengan MCP, menyambungkan Postgres, Slack dan GitHub hanya memerlukan tiga arahan yang serupa, dan memutuskan sambungannya juga semudah itu apabila anda tidak lagi memerlukan perkhidmatan tersebut.

Apakah Perbezaan MCP dengan Skills dan Subagen?#

Jadual ringkas untuk membezakan semuanya:

Kesimpulan praktikal: jika tugasan telah ditentukan sekali dan berulang dalam bentuk teks, itu ialah skill. Jika AI memerlukan respons langsung daripada sistem luaran, itu ialah MCP. Jika tugasan panjang, bercabang dan memerlukan minda yang berasingan, itu ialah subagen.

Ketahui lebih lanjut tentang dua mekanisme yang berkaitan: Claude Code Skills: Cara Membina Pustaka Anda Sendiri dan Claude Code Subagents: 5 Contoh Sedia Guna.

Cara Memasang Pelayan MCP: Arahan Pertama Anda dalam 5 Minit#

Sintaks penuh daripada dokumentasi rasmi:

claude mcp add <name> [options] -- <command> [args...]

Tiga pengangkutan disokong: --transport stdio (lalai, proses setempat), --transport http (HTTP jauh) dan --transport sse (ditandakan sebagai lapuk; gunakan hanya jika pelayan belum berpindah).

Tiga skop disokong melalui bendera --scope:

• local — hanya dalam folder projek semasa (lalai).
• project — ditulis ke .mcp.json, dikomit ke repositori dan tersedia untuk seluruh pasukan.
• user — global untuk semua projek pada mesin.

Contoh minimum menggunakan pelayan rujukan Filesystem daripada projek MCP. Ia boleh dimulakan dalam setengah minit:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list

Selepas list, anda akan melihat filesystem dalam senarai jika folder yang dinyatakan dalam arahan itu wujud; tanpanya, pelayan tidak akan bermula. Pelayan itu dapat melihat folder kerja Claude Code—iaitu folder tempat anda melancarkannya. Saya menerangkan sebabnya dan bila pelayan ini benar-benar berguna di bawah dalam bahagian 5.2.

Untuk memastikan MCP disambungkan, jalankan /mcp dalam sesi Claude Code. Arahan itu akan memaparkan semua pelayan, status masing-masing dan senarai alatnya. Arahan tambahan untuk bekerja dengan Ailoot tersedia dalam dokumentasi. Semak README pelayan MCP yang dipilih untuk melihat arahan khususnya.

stdio atau HTTP: Pengangkutan Mana Patut Dipilih?#

Perbandingan mengikut kriteria utama:

Panduan ringkas: apa-apa yang disimpan pada cakera anda atau dalam pangkalan data setempat menggunakan stdio. Apa-apa yang berada dalam awan menggunakan HTTP. SSE secara rasmi lapuk; jangan pilihnya.

7 Pelayan MCP Sedia Guna untuk Usahawan#

5.1. GitHub MCP — Pelayan Rasmi daripada GitHub

Fungsinya: memberikan Claude Code akses kepada issues, pull request, fail repositori dan larian tindakan. Pelayan ini sumber terbuka dan mempunyai lebih 30,000 bintang di GitHub.

Pemasangan (HTTP melalui OAuth):

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

Sebagai alternatif, gunakan stdio melalui Docker jika anda memerlukan token PAT dan bukannya OAuth.

Contoh: “Baca issues terbuka yang berlabel bug, kumpulkannya mengikut komponen dan cadangkan susunan untuk menutupnya.” Claude akan memanggil GitHub MCP, membaca semua issues dan memberikan senarai mengikut keutamaan.

Repositori: github/github-mcp-server.

5.2. Filesystem MCP — Pelayan Rujukan Projek MCP

Fungsinya: memberikan AI akses kepada fail pada komputer dalam folder yang diluluskan. Pelayan ini dikeluarkan oleh projek MCP sendiri; pendaftaran npm menyenaraikan Model Context Protocol a Series of LF Projects, LLC sebagai pengarang.

Pemasangan (stdio) dengan versi yang dipinkan:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects

Apabila Claude Code bersambung, ia menghantar folder kerjanya kepada pelayan, lalu menggantikan semua yang dinyatakan dalam arahan. Folder kerja Claude Code ialah folder tempat anda melancarkannya serta folder yang ditambahkan dengan arahan /add-dir atau bendera --add-dir. Anda tidak boleh memberikan folder berasingan yang mengandungi mockup kepada pelayan melalui arahan itu. Folder dalam arahan tetap perlu wujud, jika tidak pelayan tidak akan bermula.

Jadi, dalam Claude Code, pelayan ini kebanyakannya menggandakan alat terbina dalam. Untuk mengakses fail dalam folder lain, /add-dir sudah memadai: selepas itu, alat Claude Code sendiri juga boleh membaca folder tersebut. Pelayan ini lebih berguna untuk program yang tidak mempunyai akses fail sendiri. Dalam Claude Desktop, masalah lain mungkin berlaku: alat pelayan ditolak kerana penerangannya menggunakan format skema lama; isu ini masih terbuka.

Berikan akses hanya kepada folder yang benar-benar diperlukan, sama ada dalam arahan atau melalui /add-dir. Jangan berikan akses kepada akar cakera—itulah lubang keselamatan yang pertama.

Contoh: mula-mula /add-dir ~/Documents/design, kemudian “Pindahkan semua mockup daripada ~/Documents/design/landing-v3/ ke dalam projek semasa dan namakannya semula mengikut konvensyen hero-*.png.”

5.3. Postgres MCP — DBHub (Bytebase)

Fungsinya: menyambungkan Claude kepada Postgres, MySQL, SQL Server, MariaDB atau SQLite. Ia menyokong mod baca sahaja supaya ejen AI tidak dapat menggugurkan pangkalan data dengan satu arahan. Ia sering digunakan sebagai pengganti pelayan rujukan Anthropic yang diarkibkan, server-postgres.

Pemasangan (HTTP, baca sahaja):

claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly

Untuk pangkalan data produksi, sentiasa gunakan pengguna berasingan dengan kebenaran baca sahaja dan anonimumkan data peribadi melalui VIEW atau laluan API perantara. Jangan sambungkan pangkalan data produksi dengan kebenaran menulis.

Contoh: “Tanya pangkalan data tentang pelanggan yang mempunyai status langganan expired dari bulan lalu, kemudian senaraikan 20 teratas mengikut jumlah bayaran.”

Repositori: bytebase/dbhub.

5.4. Slack MCP — Komunikasi Pasukan

Fungsinya: memberikan Claude akses untuk membaca saluran Slack dan menghantar mesej. Berguna untuk automasi: “Apabila binaan berjaya, hantar mesej ke #releases”; “Sediakan ringkasan mingguan daripada #engineering.”

Pemasangan (stdio melalui wrapper npx, seperti @modelcontextprotocol/server-slack atau yang setara daripada vendor):

claude mcp add slack \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -e SLACK_TEAM_ID=T0... \
  -- npx -y @modelcontextprotocol/server-slack

Kebenaran menggunakan Slack Bot Token; akses dihadkan melalui skop pada pihak Slack. Anda boleh memberikan AI hanya chat:read dan chat:write:user; dalam keadaan itu, AI tidak akan dapat mengubah tetapan ruang kerja. Semak README pelayan yang dipilih untuk arahan terkini; ekosistem ini berubah dengan pantas.

Contoh: “Setiap pagi pada 9:00, hantar senarai PR yang digabungkan semalam ke #daily.”

5.5. Notion MCP — Pangkalan Pengetahuan

Fungsinya: memberikan Claude akses kepada halaman dan pangkalan data Notion. Ia ialah pangkalan pengetahuan di luar projek anda: jika anda menyimpan nota, daftar pelanggan atau dasar editorial di situ, AI boleh membacanya.

Pemasangan (HTTP melalui OAuth):

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

Sebagai alternatif, gunakan plugin rasmi Anthropic @makenotion/claude-code-notion-plugin.

Contoh: “Dalam pangkalan data Notion ‘Customers’, cari semua orang yang statusnya ‘active’ dan tidak membuat panggilan dalam tempoh lebih daripada dua minggu. Sediakan e-mel untuk setiap seorang.”

Panduan daripada Notion: developers.notion.com/guides/mcp.

5.6. Sentry MCP — Penjejakan Ralat

Fungsinya: menyambungkan Claude kepada ralat dalam sistem produksi anda. Apabila halaman gagal dengan ralat 500, anda boleh bertanya, “Tunjukkan 10 isu terkini dalam Sentry untuk projek ini dan terangkan punca asas setiap satunya,” lalu mendapat analisis serta-merta.

Pemasangan (HTTP):

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Kebenaran dibuat melalui Sentry OAuth. Akses boleh dihadkan kepada projek tertentu.

Contoh: “Ambil tiga isu yang paling kerap berlaku dalam tempoh 24 jam yang lalu. Terangkan dengan bahasa yang mudah apa yang berlaku dan cadangkan cara membaikinya.”

Repositori: getsentry/sentry-mcp.

5.7. Playwright MCP — Aliran Kerja Pelayar

Fungsinya: memberikan Claude sebuah pelayar. AI boleh membuka halaman, mengklik, mengisi borang dan mengambil tangkapan skrin. Berguna untuk pemeriksaan UI, ujian manual selepas penerbitan dan menghuraikan aliran kerja.

Pemasangan (stdio):

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

Versi v0.0.75, yang dikeluarkan pada 7 Mei 2026, diselenggara secara aktif oleh Microsoft (lebih 32,000 bintang).

Contoh: “Buka halaman utama laman web kami, pastikan semua kad dipaparkan dengan betul dan ambil tangkapan skrin pada desktop serta mudah alih.”

Repositori: microsoft/playwright-mcp.

Semak README bagi versi Playwright MCP yang dipilih untuk arahan dengan versi dipinkan, bendera bagi beberapa sesi serentak dan ralat pemasangan yang lazim.

Cara Mengawal Keselamatan dengan Hook PreToolUse#

Senarai sekat awalan SQL bukan sempadan kebenaran baca sahaja: SQL huruf kecil, komen, UPDATE, INSERT, ALTER, berbilang pernyataan dan fungsi berkesa sampingan tidak diliputi tiga awalan huruf besar. Berikan sambungan pangkalan data peranan berasingan dengan geran baca sahaja serta sahkan geran pada pangkalan data ujian boleh dibuang. Hook ialah kawalan tambahan panggilan alat, bukan pengganti kebenaran itu.

Berikut contoh kuarantin yang sengaja sempit: tolak semua panggilan melalui tiga keluarga pelayan MCP dinamakan sehingga dasar lebih khusus disemak dan diuji. Ia menyekat bacaan serta tulisan. Padankan nama pelayan/alat sebenar; pelayan dinamakan semula, Bash terbina dalam atau connector lain berada di luar corak ini.

Letakkan peraturan berasingan ini dalam .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}

Simpan skrip ini sebagai .claude/hooks/deny-unapproved-mcp.sh. Ia memulangkan kontrak keputusan PreToolUse didokumenkan, bukan bentuk aras atas lama decision: approve/block:

#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'

Skrip ini tidak menghuraikan atau mengelaskan SQL. Bagi panggilan sepadan, ia sentiasa menolak. Periksa padanan dan hasil hook dalam sesi terasing sebelum menyambungkan data bernilai: SELECT 1, delete huruf kecil, UPDATE berawalan komen, alat Slack baca atau hantar dan Filesystem baca .env semuanya mesti ditolak apabila nama alat sepadan. Alat keluarga pelayan berbeza mesti kekal di luar contoh ini; sahkan sempadan berasingan itu secara jelas.

Untuk membenarkan kerja pangkalan data baca sahaja, gunakan geran pangkalan data disahkan dan gantikan kuarantin dengan dasar disemak untuk alat sebenar. Untuk Slack, gunakan kelayakan tanpa hak menghantar jika tugasan hanya membaca. Untuk fail, hadkan akar dibenarkan pelayan serta kebenaran sistem fail proses. Jangan dakwa hook ini menghalang akses melalui alat lain, arahan shell, lampiran prompt atau fail dasar yang boleh disunting ejen.

Pendekatan yang sama dibincangkan dengan lebih terperinci dalam panduan Plan Mode dalam Claude Code—logiknya serupa dengan “semak sebelum melaksanakan”.

Apa yang Perlu Dilakukan Jika Anda Mempunyai 40+ Alat dan Claude Keliru?#

Menurut dokumentasi Claude Code, ciri ini kini didayakan secara lalai dan tidak perlu dihidupkan secara manual.

Keadaan apabila Claude Code memuatkan semua alat serta-merta: penggunaan melalui proksi pihak ketiga (apabila ANTHROPIC_BASE_URL ditetapkan kepada alamat selain alamat Anthropic), model yang lebih lama daripada generasi 4.5 dalam Google Cloud dan penggunaan Microsoft Foundry di Azure. Pemboleh ubah ENABLE_TOOL_SEARCH mengubah tingkah laku:

• tidak ditetapkan — semua alat MCP ditangguhkan dan dimuatkan apabila diperlukan;
• true — sama seperti di atas, serta Claude Code cuba menghidupkan carian melalui proksi;
• auto — mod ambang: selagi semua penerangan alat menggunakan kurang daripada 10% tetingkap konteks, alat dimuatkan serta-merta; selebihnya ditangguhkan;
• auto:N — sama, tetapi dengan ambang peratusan tersuai, contohnya auto:5;
• false — tingkah laku lama; semua alat dimasukkan ke dalam konteks serta-merta.

Untuk alat kritikal yang mesti sentiasa kelihatan, terdapat bendera alwaysLoad: true dalam .mcp.json bersebelahan penerangan pelayan. Setiap alat sedemikian menggunakan ruang konteks sejak minit pertama, jadi gunakan pilihan ini hanya untuk alat yang diperlukan Claude dalam hampir setiap respons.

Jika anda mempunyai lima atau lebih pelayan MCP dan Claude keliru tentang alat yang perlu dipanggil, semak dahulu sama ada carian dimatikan: cari ENABLE_TOOL_SEARCH=false dalam tetapan dan pastikan sama ada anda menggunakan proksi.

Anda juga boleh mengurangkan konteks dengan /compact.

Bilakah Anda Tidak Memerlukan MCP: Adakah Skill, Subagen atau CLI Lebih Sesuai?#

Susunan mengikut kos token dan kerumitan:

1. Arahan CLI melalui Bash — hampir percuma. AI menjalankan gh pr list, psql -c atau curl dan menerima respons seperti pengguna terminal biasa.
2. Skill — murah. Templat prompt sedia guna dengan arahan tentang perkara yang perlu dipanggil dan cara memproses hasilnya. Dimuatkan berdasarkan pencetus dalam nama folder.
3. Subagen — sederhana. Konteks berasingan untuk tugasan panjang, dengan sesi tokennya sendiri.
4. Pelayan MCP — mahal. Hanya nama alat kekal dalam konteks, tetapi penerangan alat dimuatkan apabila Claude menemuinya sebelum panggilan; respons perkhidmatan boleh menjadi besar: Claude Code memberi amaran apabila respons alat melebihi 10,000 token. Selain itu, sesi OAuth diperlukan untuk HTTP.

Nasihat yang mungkin berlawanan dengan jangkaan: untuk menghuraikan halaman web, bekerja dengan git, membuka PDF dan menggunakan utiliti sumber terbuka, pilih CLI, bukan MCP. AI boleh memanggil arahan terminal sama seperti manusia, dan token hanya digunakan untuk arahan serta responsnya, tanpa penerangan alat atau overhed pelayan.

MCP berbaloi dalam dua keadaan:

• Perkhidmatan itu tertutup: Slack, Notion, Sentry, Linear. Alat CLI juga tersedia, tetapi MCP memberikan akses yang lebih terperinci melalui OAuth dan kawalan skop.
• Komunikasi dua hala secara langsung diperlukan: AI menyambung ke Postgres, memeriksa skema, mengemukakan pertanyaan susulan, mendapatkan data dan mengambil langkah seterusnya. Dengan CLI, ini akan memerlukan 10 arahan manual.

6 Antipola Sambungan MCP#

1. Kabinet MCP. Anda menyambungkan 10 pelayan “untuk berjaga-jaga”; Claude keliru tentang alat yang perlu dipanggil dan responsnya memenuhi konteks. Penyelesaian: kekalkan 3–5 pelayan untuk projek semasa dan buang yang lain dengan claude mcp remove.

2. Akses tulis ke pangkalan data produksi. Anda menyambungkan Postgres MCP kepada pangkalan data produksi tanpa --readonly, pengguna berasingan atau hook senarai benarkan. Satu prompt—“padam rekod ujian”—dan data produksi pun terpadam. Penyelesaian: peranan pangkalan data berasingan dengan geran baca sahaja disahkan, mod baca sahaja pelayan jika berkenaan dan kawalan panggilan alat diuji. Senarai sekat awalan DROP|TRUNCATE|DELETE bukan kebenaran yang mencukupi.

3. PII tanpa penyamaran. Anda menyambungkan terus pangkalan data yang mengandungi e-mel, nombor telefon dan butiran pasport pelanggan. Claude melihat data tersebut dan data itu berakhir dalam log Anthropic. Penyelesaian: gunakan VIEW atau laluan API perantara yang memulangkan data bertopeng seperti j***@gmail.com.

4. MCP dan bukannya skill. Anda perlu “mencipta laporan jualan dalam format X”—tugasan rutin yang boleh diselesaikan dengan skill dan prompt sedia guna. Jangan cipta pelayan MCP.

5. MCP dan bukannya CLI sumber terbuka. Anda perlu menukar PDF kepada teks. pdftotext sudah tersedia. Jangan bina “PDF MCP”—ia hanya membazirkan token.

6. Tidak menjejaki kos token. Anda boleh melihat pelayan yang disambungkan dalam claude mcp list, tetapi tidak tahu jumlah penggunaannya dalam setiap perbualan. Selepas seminggu, anda langsung tidak sedar bahawa “MCP menggunakan 40% konteks, dan saya membayarnya selama ini.” Penyelesaian: nyahdayakan pelayan yang tidak digunakan secara berkala dan perhatikan perubahan penggunaan melalui penjejakan had penggunaan Claude Code.

Cara Menyahpepijat Kegagalan Sambungan MCP#

Senarai semak langkah demi langkah:

1. Adakah pelayan kelihatan dalam senarai?

   claude mcp list
   

   Jika tidak, claude mcp add tidak selesai. Punca yang paling lazim ialah --scope: anda menambahkannya kepada local dan sedang menyemaknya daripada projek lain.

2. Adakah status pelayan berwarna hijau?

   claude mcp status <name>
   

   Merah bermakna proses tidak bermula (untuk stdio) atau pelayan tidak memberi respons (untuk HTTP).

3. Adakah log pelayan menunjukkan sesuatu yang berguna?

   claude mcp logs <name>
   

   Jika anda melihat jejak tindanan, masalah biasanya berkaitan dengan pakej (npx tidak dapat menemuinya atau versi Node lebih rendah daripada 20).

4. Panggil balik OAuth tidak kembali? Masalahnya biasanya berkaitan dengan --callback-port atau penapis rangkaian. Majukan port tertentu:

   claude mcp add --transport http --callback-port 8765 [name] [url]
   

5. Konflik nama alat? Dua pelayan mendedahkan alat dengan nama yang sama dan Claude memanggil alat yang salah. Gunakan Tool Search (lihat H2 sebelumnya) atau buang pelayan tambahan secara manual menggunakan claude mcp remove.

6. Tidak dapat melihat sambungan (connectors) claude.ai? Ini masalah yang diketahui: sambungan (connectors) daripada antara muka web claude.ai tidak tersedia kepada Claude Code apabila ia menggunakan kunci API. Penyelesaian: sambungkan MCP melalui CLI, bukan antara muka web.

Langkah Seterusnya: OAuth, Pelayan MCP Anda Sendiri dan Plugin Marketplace#

Plugin Marketplace mempercepatkan kerja bagi sesiapa yang tidak mahu mengingati arahan pemasangan. Formatnya ialah manifes .claude-plugin/marketplace.json yang menerangkan sekumpulan pelayan dalam satu pakej.

Pasang plugin daripada marketplace:

claude plugin install <plugin-name>

Sesuatu plugin boleh mengandungi beberapa pelayan MCP, skills dan subagen sekali gus—persediaan berpakej untuk senario khusus: e-dagang, pemasaran atau jabatan undang-undang.

Tulis pelayan MCP sendiri mengikut spesifikasi modelcontextprotocol.io. Templat minimum menggunakan SDK Python atau TypeScript Anthropic; kemudian huraikan alat dan sambungkan pengangkutan. Kerumitannya setanding dengan menulis REST API menggunakan FastAPI.

Jika projek anda sudah mempunyai CLAUDE.md yang dikonfigurasikan dan memahami kejuruteraan konteks, menambah MCP sendiri mengambil masa sehari. Jika belum, lebih baik pelajari asasnya dahulu.

Untuk meneruskan kerja dengan model, pergi ke Ailoot.