Server MCP: Menghubungkan Claude ke Tumpukan Anda
Instal dan konfigurasikan server MCP untuk memberi Claude akses langsung ke Slack, Supabase, Notion, dan GitHub. Tidak diperlukan kode penghubung.
Sebuah skill adalah file markdown dengan frontmatter di ~/.claude/skills/. Claude menemukan skill dengan membaca bidang deskripsinya; ketika permintaan Anda cocok, ia memuat dan mengikuti runbook. Tulis instruksi sekali, dapatkan langkah-langkah yang sama setiap saat.
---
name: translate-pi-jargon
description: Translate PI legal jargon into plain English. Use when the user pastes legal text or references terms like UM/UIM, demand letter, or lien.
---
# Translate PI Jargon
1. Restate the term in one plain sentence.
2. Give a one-sentence example of when it matters.
3. Flag anything with time-pressure (statutes, deadlines).Tulis skill ketiga kalinya Anda menempelkan resep yang sama ke Claude.
Deskripsi adalah mekanisme penemuan. Claude membaca deskripsi dan memutuskan skill mana, jika ada, yang berlaku untuk permintaan Anda.
Buruk: "Skill untuk bekerja dengan dokumen." Claude tidak dapat mengetahui kapan ini berlaku.
Baik: "Gunakan ketika pengguna menempelkan kontrak atau meminta untuk meringkas, menggarisbawahi, atau mengekstrak istilah dari PDF."
Formulanya: "Gunakan ketika [pemicu spesifik]. Berlaku untuk [tipe konten spesifik]."
Skill atau aturan CLAUDE.md? Skill adalah prosedur multi-langkah yang dapat diulang; aturan CLAUDE.md adalah batasan yang selalu aktif. Runbook deploy 10 langkah adalah skill. "Jangan pernah menjalankan migrasi terhadap prod tanpa cadangan" adalah aturan. Keduanya termasuk dalam sistem.
Server MCP (Model Context Protocol) adalah adaptor yang mengekspos alat eksternal ke Claude. Slack, Supabase, Notion, GitHub: Claude memanggil MCP, MCP memanggil API, Anda menulis nol kode penghubung. Alih-alih menyalin-menempel data ke dalam prompt, Claude membaca data langsung dan mengambil tindakan secara langsung.
MCP Basis Data: "Tunjukkan kepada saya pengguna yang mendaftar minggu lalu tetapi belum mengaktifkan" berjalan sebagai kueri langsung.
MCP Slack: "Ringkas apa yang dibahas #engineering hari ini" menarik pesan langsung.
MCP Notion: "Perbarui wiki proyek dengan keputusan hari ini" menulis secara langsung.
MCP GitHub: "Daftar PR terbuka yang lebih dari 7 hari" mengkueri status repo langsung.
Pola instalasi: instal server (npx atau uvx), tambahkan konfigurasi ke ~/.claude/settings.json:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}Aturan keamanan:
Jangan pernah menempelkan token asli ke file publik; suntikkan melalui variabel lingkungan atau penyimpanan rahasia.
MCP Basis Data mendapatkan kredensial hanya-baca yang dicakup ke tabel yang dibutuhkan Claude. Kunci peran layanan dapat menghapus tabel.
Tinjau alat apa yang diekspos setiap MCP sebelum menyebarkan.
MCP yang mengambil tindakan mendapatkan gerbang persetujuan.
Pilih MCP pertama Anda dengan bertanya: apa yang saat ini saya tempelkan ke Claude dari sistem eksternal? Hasil kueri basis data menunjuk ke MCP Supabase; daftar PR ke GitHub; ringkasan saluran ke Slack; catatan ke Obsidian. Satu MCP yang terinstal dan aktif digunakan lebih baik daripada empat yang dikonfigurasi dan diabaikan.
Uji: tutup dan buka kembali Claude Code untuk memicu penemuan, lalu tanyakan: "Alat apa yang Anda miliki dari [nama MCP]?" Jika daftar kosong, periksa sintaks settings.json dan konfirmasi npx atau uvx ada di PATH Anda.
Skill dan MCP saling melengkapi. Skill runbook deploy ditambah MCP GitHub ditambah MCP Slack: Claude mengikuti runbook, membaca status PR langsung, memposting pembaruan kemajuan. Deploy manual 20 menit menjadi 2 menit. Biaya pengaturan kira-kira 30 menit per skill dan 10 per MCP; lima penggunaan pertama membayarnya kembali.
Tidak ada MCP yang diterbitkan untuk alat Anda? Server kustom minimal menggunakan SDK Python resmi mengekspos satu alat dalam sekitar 30-40 baris: definisikan nama alat, deskripsi, dan skema input, lalu tangani panggilan. Berikan deskripsi alat spesifisitas yang sama dengan deskripsi skill. Bangun MCP kustom untuk data langsung yang sering dikueri; untuk data referensi statis, skill yang meminta Anda menempelkannya sudah cukup.
Manajemen kredensial untuk pengaturan tim. Token yang dikodekan secara permanen dalam settings.json bersama adalah insiden yang menunggu untuk terjadi. Dua pola yang lebih aman: pass-through env ("SLACK_TOKEN": "$SLACK_TOKEN", dengan nilai asli di profil shell Anda) atau manajer rahasia yang dikueri server MCP saat startup (Vault, 1Password CLI), sehingga tidak ada yang sensitif tersimpan di disk.
Cakupkan ke minimum: peran Postgres hanya-baca untuk Supabase, token GitHub yang terperinci terbatas pada repo tertentu, token bot Slack terbatas pada saluran yang harus dilihat Claude.
Audit: untuk MCP yang dapat menulis, tambahkan hook PostToolUse yang mencatat stempel waktu, nama alat, argumen, dan status hasil.
Skill adalah runbook markdown yang ditemukan Claude berdasarkan deskripsi; tulis satu kali ketiga kalinya Anda menempelkan instruksi yang sama. MCP menghubungkan Claude ke API eksternal tanpa kode penghubung; gunakan kredensial hanya-baca, hak istimewa paling rendah. Skill pertama terbaik: prosedur yang telah Anda jelaskan dua kali minggu ini. MCP pertama terbaik: sistem yang paling sering Anda salin-tempel.