MCP server untuk Claude Code: command dan jebakan di 8 server

Terbit pada
7 menit baca.
Tags: AIClaude Code

Tiap MCP server untuk Claude Code cukup dipasang dengan satu command, tapi delapan server di halaman ini punya masalahnya sendiri-sendiri. Playwright tidak menemukan Chrome, Grafana gagal kalau nama server ditaruh setelah -e, Sentry minta Sentry-Bearer alih-alih Bearer, dan PagerDuty sudah meng-archive server lokalnya. Dokumentasi vendor tidak membandingkannya satu sama lain, jadi command dan jebakannya saya jejerkan di sini, lalu kesalahan setup yang terulang di semua server.

Sekarang yang masih saya pakai cuma Datadog.

Ringkasan delapan server

ServerJalan diAuthYang bikin gagal
GitHubhosted, HTTPpersonal access tokentanda kutip ganda membuat token tertulis di config
Playwrightlokal, npxtidak perlutool call pertama gagal kalau Google Chrome tidak ada
Sentryhosted, HTTPOAuth, atau tokentoken perlu prefix Sentry-Bearer, bukan Bearer
Datadoghosted, HTTPOAuthendpoint beda per site Datadog, dan admin org harus menyalakan MCP Access
PagerDutyhosted, atau lokal uvxAPI keyserver lokal sudah di-archive, dan akun EU pakai host lain
Grafanalokal, uvxservice account tokennama server harus sebelum flag -e
Context7lokal, npxtidak perlu (key opsional)belum tentu dipanggil Claude kecuali prompt menyebut use context7
Sequential Thinkinglokal, npxtidak perlususah tahu ada gunanya kalau tool call-nya tidak kelihatan

Command singkat

# GitHub (export GITHUB_PAT first)
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp/","headers":{"Authorization":"Bearer ${GITHUB_PAT}"}}'

# Playwright
claude mcp add playwright -- npx @playwright/mcp@latest

# Sentry (then log in through /mcp)
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# Datadog, US1 site (then log in through /mcp)
claude mcp add --transport http datadog https://mcp.datadoghq.com/v1/mcp

# PagerDuty, hosted (export PAGERDUTY_API_KEY first)
claude mcp add-json pagerduty '{"type":"http","url":"https://mcp.pagerduty.com/mcp","headers":{"Authorization":"Token token=${PAGERDUTY_API_KEY}"}}'

# Grafana (this form stores the token in plain text, see below)
claude mcp add grafana \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token \
  -- uvx mcp-grafana

# Context7
claude mcp add context7 -- npx -y @upstash/context7-mcp

# Sequential Thinking
claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Bagian di bawah membahas kesalahan yang sama di semua command ini. Token, permission, dan troubleshooting per server ada di post masing-masing, tautannya di tabel.

Server hosted perlu --transport http

GitHub, Sentry, Datadog, dan PagerDuty versi hosted jalan di server vendor, dan Claude Code tinggal tersambung ke URL-nya. Tanpa --transport http (atau "type":"http" di add-json), Claude Code menyimpan URL itu sebagai command lokal. Claude Code 2.1.330 tetap menambahkan server-nya dan cuma menampilkan peringatan:

Warning: The command "https://mcp.sentry.dev/mcp" looks like a URL, but is treated as a stdio server because --transport wasn't set.

Server-nya tetap masuk ke config, dan nanti claude mcp get sentry menampilkan Failed to connect dengan ENOENT ... posix_spawn 'https://mcp.sentry.dev/mcp'. Hapus server itu, lalu tambahkan lagi dengan flag-nya.

Playwright, Grafana, Context7, Sequential Thinking, dan server PagerDuty lokal yang lama jalan di mesin kamu. Claude Code sendiri yang menjalankan prosesnya, jadi kamu perlu Node.js untuk npx atau uv untuk uvx.

Server lokal: nama, -e, lalu --

Untuk server lokal, pakai urutan ini: claude mcp add <name> [-e KEY=value ...] -- <command> [server flags].

-e menerima lebih dari satu nilai. Kalau nama server ditaruh setelahnya, nama itu bisa ikut dibaca sebagai environment variable. Ini output command Grafana waktu urutannya salah:

Invalid environment variable format: grafana, environment variables should be added as: -e KEY1=value1 -e KEY2=value2

Semua yang ada setelah -- diteruskan ke server apa adanya. Kalau -- tidak ditulis, CLI Claude Code mencoba membaca flag milik server sebagai flag-nya sendiri:

$ claude mcp add playwright npx @playwright/mcp@latest --headless
error: unknown option '--headless'
(Did you mean --header?)

Dengan claude mcp add playwright -- npx @playwright/mcp@latest --headless, flag itu sampai ke Playwright. Begitu juga --disable-write di Grafana.

Jangan simpan token di ~/.claude.json

claude mcp add -e TOKEN=... dan -H "Authorization: ..." menulis secret ke config Claude Code sebagai teks biasa. Supaya token tetap di shell, pakai add-json dengan placeholder ${VAR} di dalam tanda kutip tunggal:

export GITHUB_PAT=ghp_your_token_here
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp/","headers":{"Authorization":"Bearer ${GITHUB_PAT}"}}'

Claude Code mengganti placeholder itu setiap kali server dijalankan. Ada dua hal yang bisa salah:

  • Dengan tanda kutip ganda, shell sudah mengganti ${GITHUB_PAT} sebelum Claude Code melihatnya. Hasilnya token asli (atau string kosong) tersimpan di config.
  • Variable-nya harus ada di shell yang menjalankan Claude Code. Kalau tidak ada, claude mcp list diakhiri peringatan [Warning] [github] mcpServers.github: Missing environment variables: GITHUB_PAT. Taruh export-nya di ~/.zshrc atau ~/.bashrc.

claude mcp get <name> menampilkan config yang tersimpan. Header-nya harus tetap berisi ${GITHUB_PAT}, bukan token.

Server lokal juga bisa memakai placeholder yang sama di bagian env. Ini command Grafana di atas, tapi tokennya tidak tersimpan sebagai teks biasa:

export GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token
claude mcp add-json grafana '{"type":"stdio","command":"uvx","args":["mcp-grafana"],"env":{"GRAFANA_URL":"https://myinstance.grafana.net","GRAFANA_SERVICE_ACCOUNT_TOKEN":"${GRAFANA_SERVICE_ACCOUNT_TOKEN}"}}'

Server OAuth (Sentry, Datadog) tidak perlu semua ini. Jalankan /mcp di Claude Code, pilih server-nya, lalu login di browser. Claude Code menyimpan token OAuth-nya sendiri.

Di Windows, panduan install GitHub mencatat add-json bisa gagal dengan Invalid input untuk HTTP server. Bentuk add yang bisa dipakai sebagai gantinya ada di post GitHub.

claude mcp list cuma mengecek server bisa jalan

claude mcp list menampilkan ✓ Connected begitu proses berjalan atau URL-nya merespons. (Server OAuth tampil "needs authentication" di /mcp sampai kamu login.) Status Connected tidak mengecek token, permission, atau browser. Playwright tetap Connected di mesin tanpa Chrome, lalu gagal di tool call pertama. Grafana tetap Connected dengan token yang sudah kedaluwarsa, lalu query pertamanya dibalas 401 atau 403.

Jadi coba tanya Claude soal data yang pasti ada, misalnya "list my open pull requests" atau "what are the triggered monitors in Datadog". Kalau jawabannya kosong, biasanya akun di balik token tidak punya akses ke data itu. Cek permission-nya dulu sebelum mengubah command.

Scope: satu project, semua project, atau satu tim

claude mcp add secara default memakai scope local, jadi server hanya dimuat di folder tempat command itu dijalankan. --scope user memuatnya di semua project. --scope project menulisnya ke .mcp.json di root repo, yang bisa di-commit. Dengan placeholder ${VAR}, tiap anggota tim mengisi token sendiri dan tidak ada secret yang masuk ke git. Claude Code minta persetujuan tiap orang saat server project pertama kali dimuat.

Mulai dari read-only

Kebanyakan server ini punya akses tulis. Claude bisa membuka PR, mengubah dashboard, atau membuat dan mengubah incident. Pengecualiannya server PagerDuty lokal, yang tetap read-only sampai kamu menambahkan --enable-write-tools. Matikan akses tulis sampai workflow-nya memang butuh:

  • GitHub: URL /mcp/readonly atau header X-MCP-Readonly: true, ditambah token read-only.
  • Grafana: --disable-write, ditambah service account dengan role Viewer.
  • PagerDuty: jangan pakai --enable-write-tools di server lokal.
  • Datadog: role dengan mcp_read tanpa mcp_write, dan biarkan setting MCP Write Access di org tetap mati.
  • Sentry: pilih tool group saat login OAuth, atau batasi dengan ?skills= kalau pakai token.

Ada bonusnya juga: Makin sedikit tool, makin sedikit definisi tool yang memenuhi context Claude. Header X-MCP-Toolsets di GitHub, ?toolsets= di Datadog, dan --disable-<category> di Grafana bisa memangkas daftarnya.

Context7

Context7 buatan Upstash mengambil dokumentasi dan contoh code terbaru sesuai versi library, lalu memasukkannya ke context Claude. Server ini berguna kalau code dari Claude masih memakai API versi lama.

claude mcp add context7 -- npx -y @upstash/context7-mcp

Claude tidak selalu memakainya sendiri. Tambahkan use context7 di prompt:

Create a Next.js proxy that checks for a valid JWT in cookies
and redirects unauthenticated users to /login. use context7

Kalau Claude memanggil tool Context7 sebelum menjawab, berarti sudah jalan. Command-nya bisa dipakai tanpa akun. README Context7 menyarankan API key gratis dari context7.com/dashboard supaya rate limit-nya lebih longgar. Caranya, tambahkan --api-key YOUR_API_KEY setelah nama package.

Sequential Thinking

Sequential Thinking adalah reference server dari project Model Context Protocol. Server ini memberi Claude tool untuk memecah masalah jadi langkah pemikiran bernomor, yang bisa direvisi atau dicabangkan di tengah jalan. README-nya menyebut server ini cocok untuk masalah yang cakupannya belum jelas dari awal.

claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Kalau Claude memakainya, tool call-nya muncul di sesi. Untuk prompt yang pendek dan sederhana, bedanya mungkin tidak terasa.

Saya sudah tidak memasangnya lagi. Claude Code sekarang sudah punya extended thinking sendiri.

Referensi

Urutan setup singkat

Server hosted perlu --transport http. Server lokal perlu nama sebelum -e dan flag server setelah --. Simpan token sebagai placeholder ${VAR} di dalam tanda kutip tunggal, lalu tes dengan pertanyaan nyata setelah claude mcp list menampilkan Connected.