Hubungkan Claude Code ke alat melalui MCP

​

Apa yang dapat Anda lakukan dengan MCP

• Menerapkan fitur dari pelacak masalah: “Tambahkan fitur yang dijelaskan dalam masalah JIRA ENG-4521 dan buat PR di GitHub.”
• Menganalisis data pemantauan: “Periksa Sentry dan Statsig untuk memeriksa penggunaan fitur yang dijelaskan dalam ENG-4521.”
• Menanyakan database: “Temukan email 10 pengguna acak yang menggunakan fitur ENG-4521, berdasarkan database PostgreSQL kami.”
• Mengintegrasikan desain: “Perbarui template email standar kami berdasarkan desain Figma baru yang diposting di Slack”
• Mengotomatisasi alur kerja: “Buat draf Gmail mengundang 10 pengguna ini ke sesi umpan balik tentang fitur baru.”
• Bereaksi terhadap peristiwa eksternal: Server MCP juga dapat bertindak sebagai saluran yang mendorong pesan ke dalam sesi Anda, sehingga Claude bereaksi terhadap pesan Telegram, obrolan Discord, atau peristiwa webhook saat Anda sedang pergi.

​

Temukan dan bangun server MCP

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

Menginstal server MCP

​

Opsi 1: Tambahkan server HTTP jarak jauh

# Sintaks dasar
claude mcp add --transport http <name> <url>

# Contoh nyata: Terhubung ke Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Contoh dengan token Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

Opsi 2: Tambahkan server SSE jarak jauh

# Sintaks dasar
claude mcp add --transport sse <name> <url>

# Contoh nyata: Terhubung ke Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Contoh dengan header autentikasi
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

​

Opsi 3: Tambahkan server stdio lokal

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

# Contoh nyata: Tambahkan server Airtable
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

Opsi 4: Tambahkan server WebSocket jarak jauh

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

Tambahkan server dari instruksi setup yang ditulis untuk klien lain

• URL seperti https://mcp.example.com/mcp: server adalah jarak jauh.
• Perintah peluncuran seperti npx -y @example/mcp-server: server berjalan di mesin Anda.
• Blok JSON mcpServers: konfigurasi yang ditulis untuk file pengaturan klien lain.

​

Dari URL

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

​

Dari perintah npx, uvx, atau binary

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

Dari blok JSON mcpServers

• url tanpa type: tambahkan "type": "http", "type": "sse", atau "type": "ws" untuk mencocokkan endpoint. Claude Code membaca entri tanpa type sebagai server stdio, jadi entri url tanpa type gagal.
• Kunci dengan karakter selain huruf, angka, tanda hubung, dan garis bawah: pilih nama server yang hanya menggunakan karakter tersebut. Jika tidak, kunci adalah nama server.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

​

Mengelola server Anda

# Daftar semua server yang dikonfigurasi
claude mcp list

# Dapatkan detail untuk server tertentu
claude mcp get notion

# Hapus server
claude mcp remove notion

# (dalam Claude Code) Periksa status server
/mcp

​

Status server

• ⏸ Pending approval (run `claude` to approve): server yang dibatasi proyek dari .mcp.json yang belum Anda setujui. Claude Code menunjukkannya di claude mcp list dan claude mcp get <name>. Jalankan claude secara interaktif untuk meninjau dan menyetujuinya.
• ✘ Rejected (see disabledMcpjsonServers in settings): server .mcp.json yang entri disabledMcpjsonServers tolak. Claude Code menunjukkannya hanya di claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp): server yang daftar disabledMcpServers proyek namakan. Claude Code menunjukkannya di claude mcp list dan claude mcp get <name>. Hidupkan server kembali dari panel /mcp. Sebelum v2.1.238, kedua perintah terhubung ke server yang dinonaktifkan untuk memeriksa kesehatannya dan melaporkan hasil koneksi.

​

Persetujuan server proyek dan kepercayaan ruang kerja

• ~/.claude/settings.json pengguna Anda
• pengaturan yang dikelola
• pengaturan yang diteruskan dengan --settings

​

Detail status server

• Reconnect: pada server cached, Claude Code menghubungkannya sekarang daripada pada panggilan alat pertamanya dan menyimpan entri. Pada server yang terhubung atau gagal, Claude Code menghubungkannya kembali dan juga membuang entri.
• Clear authentication: Claude Code mencabut autentikasi server dan juga membuang entri.

• Jalur dan kueri tidak pernah muncul dalam pesan itu.
• Untuk server di cakupan lokal, proyek, atau pengguna scope atau dalam konfigurasi MCP yang dikelola, asal menunjukkan host seperti yang ditulis dalam konfigurasi itu, jadi referensi ${VAR} di host tidak diperluas dalam pesan.
• Untuk kegagalan tanpa kode status atau kesalahan, Claude Code menunjukkan teks kesalahan tanpa asal.

​

Peringatan konfigurasi

• Whitespace tersembunyi: Claude Code memperingatkan ketika nilai konfigurasi MCP membawa whitespace terkemuka atau tertinggal yang tersembunyi, yang sering berasal dari menempel token dengan newline tertinggal. Claude Code memeriksa command, url, setiap entri args, dan nilai dan nama kunci di bawah env dan headers. Claude Code menunjukkan peringatan dalam output claude mcp list dan di /mcp, menamai bidang yang terpengaruh tanpa menggema nilainya, misalnya Leading or trailing whitespace in: headers.Authorization. Claude Code tidak memangkas whitespace dan menggunakan nilai persis seperti yang ditulis, jadi edit konfigurasi untuk menghapusnya.
• Nama yang sama di lebih dari satu cakupan: jika Anda menentukan nama server yang sama di lebih dari satu scope dengan endpoint yang berbeda, Claude Code memperingatkan tentang konflik dalam output claude mcp list dan di /mcp. Claude Code menyimpan login OAuth per endpoint, jadi ketika Anda mengautentikasi definisi yang dimuat dalam satu proyek, Anda masih perlu masuk secara terpisah di proyek tempat definisi berbeda dimuat. Simpan endpoint yang Anda inginkan dan hapus yang lain dengan claude mcp remove <name> --scope <scope>. Dalam peringatan, Claude Code mengutip endpoint setiap cakupan seperti yang ditulis dalam konfigurasi Anda, dengan referensi ${VAR} yang tidak diperluas, jadi tidak pernah menunjukkan nilai yang diselesaikan seperti kunci API.
• Nama yang dicadangkan: Claude Code mencadangkan nama server bawaan-nya, termasuk workspace, claude-in-chrome, computer-use, Claude Preview, dan Claude Browser. Jika konfigurasi Anda menentukan server dengan nama yang dicadangkan, Claude Code melewatinya saat waktu muat dan menunjukkan peringatan meminta Anda untuk mengganti namanya. claude mcp add menolak nama yang dicadangkan dengan kesalahan. Claude Preview dan Claude Browser keduanya menamai server bawaan yang digunakan panel pratinjau aplikasi desktop Claude Code. Sebelum v2.1.205, Claude Browser tidak dicadangkan, jadi server yang dikonfigurasi pengguna dapat mendaftar di bawah nama itu.
• Variabel lingkungan yang hilang: jika referensi ${VAR} dalam konfigurasi server menamai variabel yang tidak diatur dan tidak memiliki :-default, Claude Code memperingatkan dalam output claude mcp list dan di /mcp, menamai variabel, dan masih memuat server dengan teks ${VAR} yang tidak diperluas. Atur variabel atau tambahkan fallback ${VAR:-default}. Di url dan headers server jarak jauh, beberapa variabel kredensial dibaca sebagai kosong sebagai gantinya, tanpa peringatan.

​

Ketersediaan alat

• Dengan pencarian alat, default: menunggu terjadi di dalam panggilan ToolSearch.
• Tanpa pencarian alat: Claude menggunakan alat WaitForMcpServers sebagai gantinya. Konfigurasi tanpa pencarian alat mencakup ANTHROPIC_BASE_URL khusus, ENABLE_TOOL_SEARCH=false, dan model lebih awal dari generasi Claude 4.5 di Platform Agen Google Cloud.
• Pada penerapan Microsoft Foundry yang dihosting di Azure: Claude dimulai pada jalur pencarian alat daripada dengan WaitForMcpServers, karena Claude Code menemukan penolakan sisi server penerapan hanya dari API. Setelah Claude Code beralih penerapan itu ke pemuatan awal, alat dari server yang selesai terhubung menjadi tersedia pada permintaan Claude berikutnya.

​

Nonaktifkan server tanpa menghapusnya

• disabledMcpServers: daftar opt-out untuk server yang dikonfigurasi pengguna, server plugin, server yang organisasi Anda sediakan melalui pengaturan yang dikelola, konektor claude.ai yang Claude Code ambil sendiri, dan server bawaan yang default ke on. Claude Code tidak terhubung ke server yang Anda cantumkan di sini. Ketika Anda menonaktifkan konektor claude.ai dengan toggle /mcp per proyek yang dijelaskan di Nonaktifkan konektor claude.ai, Claude Code menulisnya ke daftar ini di bawah nama tampilannya, misalnya claude.ai Slack.
• enabledMcpServers: daftar opt-in untuk server bawaan yang default ke off, seperti computer-use. Claude Code terhubung ke server default-off hanya ketika Anda mencantumkannya di sini.

​

Runtime klien MCP

• Sesi di Amazon Bedrock, Claude Platform di AWS, Platform Agen Google Cloud, atau Microsoft Foundry, kecuali platform host yang menyematkan Claude Code menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sesi yang masuk melalui gateway aplikasi Claude
• Sesi tempat Anda mematikan telemetri atau pengambilan flag fitur, misalnya dengan DISABLE_TELEMETRY

• Menanyakan server HTTP apakah mereka mendukung revisi yang lebih baru, dan menggunakannya dengan yang mendukungnya. Ia juga menanyakan server konektor claude.ai dalam sesi tempat ia mengambil flag fitur. Untuk membuatnya menanyakan server stdio, atau server konektor dalam setiap sesi, atur MCP_PROTOCOL_NEGOTIATION ke auto. Ia terhubung ke setiap server lain seperti v1.
• Menerima notifikasi list_changed dari server pada revisi yang lebih baru melalui aliran yang dipegang terbuka.
• Tidak mendaftarkan server channel yang terhubung pada revisi yang lebih baru, karena revisi itu tidak dapat membawa pesan channel.
• Gagal login OAuth MCP yang respons otorisasinya menamai penerbit yang tidak terduga.

​

Pembaruan alat dinamis

​

Aliran notifikasi pada runtime v2

• Aliran ditutup lagi dalam 10 detik: Claude Code membukanya kembali hingga tiga kali, kemudian berhenti untuk koneksi itu.
• Aliran tetap terbuka lebih lama dari 10 detik, kemudian ditutup, seperti aliran ke host serverless yang biasa dilakukan: setelah lima pembukaan kembali dalam satu jam, Claude Code menunggu sekitar enam jam sebelum yang berikutnya.

​

Penghubungan kembali otomatis

​

Putus di tengah sesi dari server jarak jauh

• Dalam sesi interaktif: /mcp menunjukkan server sebagai tertunda saat Claude Code menghubungkan kembali. Setelah lima upaya gagal, Claude Code menandai server sebagai gagal, atau sebagai memerlukan autentikasi ketika server perlu diotorisasi lagi. Ketika menandainya sebagai gagal, Anda melihat notifikasi MCP server "<name>" disconnected · open /mcp to reconnect. Anda dapat mencoba ulang secara manual dari /mcp.
• Dalam menjalankan claude -p dan sesi Agent SDK: Claude Code menghubungkan kembali pada jadwal yang sama, tanpa panel /mcp untuk menunjukkan upaya.

​

Koneksi pertama yang gagal

• Koneksi pertama server WebSocket
• Kesalahan autentikasi atau tidak ditemukan, karena memerlukan perubahan konfigurasi untuk diselesaikan. Ketika headersHelper adalah satu-satunya sumber header Authorization server, Claude Code mencoba ulang kesalahan autentikasi bagaimanapun, karena menjalankan kembali helper pada setiap upaya dan dapat mengambil kredensial segar

​

Permintaan penemuan yang gagal

​

Bagaimana Claude mengetahui bahwa server gagal

• Dengan pencarian alat, Claude Code memberi tahu Claude server mana yang gagal dan kesalahan koneksinya, jadi Claude melaporkan kegagalan koneksi dalam responsnya. Claude Code menyertakan informasi yang sama dalam hasil ToolSearch yang tidak menemukan alat yang cocok.
• Dalam konfigurasi apa pun tanpa pencarian alat, Claude Code tidak melaporkan koneksi server yang gagal ke Claude.

​

Dorong pesan dengan channel

​

Backgrounding otomatis dari panggilan alat yang panjang

• Panggilan dari subagents; Claude Code hanya melatar belakangkan panggilan percakapan utama
• Panggilan ke server IDE
• Panggilan dalam mode non-interaktif, kecuali CLAUDE_AUTO_BACKGROUND_TASKS diatur ke 1, karena satu kali jalan dapat berakhir sebelum hasil tiba

​

Server MCP yang disediakan plugin

• Plugin menentukan server MCP di .mcp.json di akar plugin atau inline di plugin.json
• Ketika Anda mengaktifkan plugin, Claude Code memulai server MCP-nya secara otomatis
• Claude Code menawarkan alat MCP plugin bersama alat MCP yang dikonfigurasi secara manual
• Anda menambah dan menghapus server plugin dengan memasang atau mencopot plugin, bukan dengan perintah /mcp. Anda masih dapat mengalihkan server plugin yang dipasang ke off di /mcp, yang menghentikan Claude Code dari terhubung ke sana tanpa menghapus plugin

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• Siklus hidup otomatis: server terhubung dan terputus pada titik ini:
  • Saat startup sesi, Claude Code menghubungkan server untuk plugin yang diaktifkan secara otomatis. Di /mcp, server plugin jarak jauh (HTTP atau SSE) yang pernah Anda gunakan sebelumnya dapat menunjukkan status cached sebagai gantinya; Claude Code menghubungkannya ketika Claude pertama kali memanggil salah satu alatnya
  • Jika Anda mengaktifkan atau menonaktifkan plugin selama sesi, Claude Code menghubungkan atau memutuskan server MCP-nya ketika perubahan diterapkan. Terapkan perubahan plugin tanpa memulai ulang menjelaskan kapan itu. Dalam sesi tanpa terminal interaktif, /reload-plugins tidak menghubungkan atau memutuskan server MCP plugin; perubahan itu berlaku dalam sesi Anda berikutnya
  • Ketika Anda memuat ulang, Claude Code menyimpan koneksi langsung server plugin yang konfigurasinya tidak berubah, dan melakukan hal yang sama ketika Anda mengganti daftar server MCP sesi dari Agent SDK tanpa menamakannya
  • Ketika Anda memindahkan sesi dengan /cd pada v2.1.246 atau lebih baru, Claude Code menghubungkan server plugin yang pengaturan direktori baru aktifkan dan memutuskan server plugin yang tidak lagi diaktifkan, jadi Anda tidak perlu menjalankan /reload-plugins setelah perpindahan
  • Dalam sesi cloud, panggilan MCP ke server plugin yang belum terhubung, seperti tepat setelah sesi idle bangun, memulai server sesuai permintaan dan menunggu untuk terhubung
• Placeholder jalur: ${CLAUDE_PLUGIN_ROOT} diselesaikan ke direktori instalasi plugin, ${CLAUDE_PLUGIN_DATA} ke direktori status persisten-nya, dan ${CLAUDE_PROJECT_DIR} ke akar proyek yang stabil. Substitusi berlaku untuk:
  • server stdio: command, args, env
  • server http, sse, dan ws: url, headers, dan headersHelper. Sebelum v2.1.195, headersHelper melewatkan placeholder sebagai string literal
• Akses lingkungan pengguna: akses ke variabel lingkungan yang sama seperti server yang dikonfigurasi secara manual
• Jenis transport berganda: dukungan untuk transport stdio, SSE, HTTP, dan WebSocket, meskipun dukungan transport mungkin bervariasi menurut server

mcp__plugin_my-plugin_database-tools__query

​

Cakupan instalasi MCP

​

Cakupan lokal

# Tambahkan server dengan cakupan lokal (default)
claude mcp add --transport http stripe https://mcp.stripe.com

# Tentukan cakupan lokal secara eksplisit
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

Cakupan proyek

# Tambahkan server dengan cakupan proyek
claude mcp add --transport http shared-server --scope project https://example.com/mcp

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

• Tambahkan ke disabledMcpjsonServers, yang memblokir server di setiap mode izin.
• Kecualikan pengaturan proyek sepenuhnya dengan --setting-sources atau opsi settingSources SDK.
• Mulai sesi dengan --strict-mcp-config. Claude Code kemudian hanya menggunakan server MCP yang Anda teruskan dengan --mcp-config. Melewati prompt persetujuan untuk server dengan cakupan proyek yang Claude Code tidak memuat memerlukan Claude Code v2.1.246 atau lebih baru; sebelum v2.1.246, sesi ketat masih menunggu persetujuan untuk mereka, yang membuat sesi latar belakang menunggu saat startup. Lihat Kontrol eksklusif dengan managed-mcp.json untuk apa yang dilakukan flag di bawah file MCP terkelola.

​

Cakupan pengguna

# Tambahkan server pengguna
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

Hierarki cakupan dan prioritas

1. Cakupan lokal
2. Cakupan proyek
3. Cakupan pengguna
4. Server yang disediakan plugin
5. Konektor claude.ai

​

Ekspansi variabel lingkungan dalam .mcp.json

​

Sintaks yang didukung

• ${VAR}: berkembang menjadi nilai variabel lingkungan VAR
• ${VAR:-default}: berkembang menjadi VAR jika diatur, jika tidak menggunakan default

​

Lokasi ekspansi

• command: jalur executable server
• args: argumen baris perintah
• env: variabel lingkungan yang diteruskan ke server
• url: untuk jenis server HTTP
• headers: untuk autentikasi server HTTP

​

Contoh dengan ekspansi variabel

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

​

Variabel yang tidak diatur tanpa default

​

Variabel kredensial yang dibaca sebagai kosong

• Kredensial Claude Code sendiri, seperti ANTHROPIC_API_KEY dan ANTHROPIC_AUTH_TOKEN
• Kredensial penyedia cloud Anda, seperti AWS_BEARER_TOKEN_BEDROCK
• Kredensial lain yang dibawa lingkungan Anda, seperti HTTPS_PROXY dan NPM_TOKEN

​

Bagaimana referensi muncul dalam output /mcp dan CLI

• URL atau baris perintah dalam tampilan detail /mcp server
• Output claude mcp list dan claude mcp get

​

Contoh praktis

​

Contoh: Hubungkan ke GitHub untuk tinjauan kode

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Review PR #456 and suggest improvements

Create a new issue for the bug we just found

Show me all open PRs assigned to me

​

Contoh: Tanyakan database PostgreSQL Anda

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

What's our total revenue this month?

Show me the schema for the orders table

Find customers who haven't made a purchase in 90 days

​

Autentikasi dengan server MCP jarak jauh

• Untuk server yang belum Anda masuki, salah satu kode status ini menandainya di /mcp sehingga Anda dapat menyelesaikan alur OAuth.
• Untuk konektor claude.ai, 401 yang disebabkan oleh claude.ai menolak token sesi Anda tidak menandai konektor, karena mengotorisasi ulang konektor tidak dapat memperbaiki login Anda. Claude Code menampilkan status token-sesi-ditolak sebagai gantinya.
• Untuk server yang header Authorization Anda konfigurasi, di headers atau melalui headersHelper, 401 atau 403 saat menghubungkan tidak menandai server, karena kredensial untuk diperbaiki adalah yang Anda konfigurasi. Claude Code melaporkan koneksi sebagai gagal sebagai gantinya. Jika Anda menetapkan header tersebut dari referensi ${VAR}, periksa apakah variabel itu adalah salah satu yang Claude Code baca sebagai kosong.
• Untuk konektor yang dikirimkan ke sesi cloud, Claude Code tidak menjalankan alur sign-in, karena proxy sesi mengautentikasi ke konektor dengan otorisasi yang Anda berikan di claude.ai. Ketika konektor di sana memerlukan otorisasi lagi, hubungkan kembali di claude.ai/customize/connectors daripada dari sesi.

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

/mcp

​

Autentikasi dari baris perintah

claude mcp login sentry

claude mcp login sentry --no-browser

​

Gunakan port callback OAuth tetap

# Port callback tetap dengan pendaftaran klien dinamis
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Gunakan kredensial OAuth yang telah dikonfigurasi sebelumnya

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Ganti penemuan metadata OAuth

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

Batasi cakupan OAuth

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

Gunakan header dinamis untuk autentikasi khusus

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• Perintah harus menulis objek JSON dari pasangan kunci-nilai string ke stdout
• Claude Code menjalankan perintah dalam shell dan menyerah padanya setelah 10 detik
• Claude Code memilih direktori kerja perintah dengan tempat Anda mengonfigurasi server, jadi berikan skrip sebagai jalur absolut atau letakkan di PATH
• Header dinamis mengganti headers statis apa pun dengan nama yang sama

​

Tempat helper berjalan

​

Variabel mana yang dapat dibaca helper

• Dihapus: server di .mcp.json proyek atau di plugin, dan server inline di file agen dari proyek Anda atau dari direktori --add-dir
• Tidak dihapus: server di cakupan pengguna atau cakupan lokal, di MCP terkelola, dari konektor claude.ai, atau disediakan oleh SDK atau --mcp-config, dan server inline di file agen dari ~/.claude/agents/, dari pengaturan terkelola, atau diteruskan dengan --agents

​

Percayai folder sebelum headersHelper-nya berjalan

• Kepercayaan yang tidak dihitung: kepercayaan folder induk, dan kepercayaan otomatis yang diterima sesi claude -p atau SDK untuk hooks di file pengaturan
• Sampai Anda mempercayai folder: Claude Code menghubungkan server dengan headers statis saja. Dalam sesi claude -p atau SDK itu juga mencetak satu baris headersHelper not run per server ke stderr, memberi tahu Anda cara memberikan kepercayaan.
• Kepercayaan tanpa dialog: atur projects["<path>"].hasTrustDialogAccepted ke true di ~/.claude.json. <path> adalah folder yang Project allow rules and workspace trust katakan Claude Code kunci kepercayaan padanya.

​

Tambahkan server MCP dari konfigurasi JSON

# Sintaks dasar
claude mcp add-json <name> '<json>'

# Contoh: Menambahkan server HTTP dengan konfigurasi JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Contoh: Menambahkan server stdio dengan konfigurasi JSON
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# Contoh: Menambahkan server HTTP dengan kredensial OAuth yang telah dikonfigurasi sebelumnya
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

Impor server MCP dari Claude Desktop

# Sintaks dasar 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Gunakan server MCP dari claude.ai

/mcp

• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper aktif
• Penyedia pihak ketiga seperti Amazon Bedrock atau Agent Platform Google Cloud aktif
• ANTHROPIC_PROFILE, variabel federasi, atau profil Anthropic aktif menyediakan kredensial
• CLAUDE_CODE_OAUTH_TOKEN menyimpan token dari claude setup-token, yang hanya dapat membuat permintaan model

1. Jalankan /login untuk masuk lagi.
2. Hubungkan kembali connector dari /mcp.

​

Bagaimana connector mencapai Claude Code

• Sesi cloud: Entri allowedMcpServers dan deniedMcpServers yang mencapai sesi, misalnya melalui pengaturan yang dikelola server, juga memfilter connector yang dikirimkan. Proxy sesi menulis ulang URL setiap connector, jadi pola serverUrl yang ditulis untuk URL connector itu sendiri tidak cocok. Untuk mengakui connector yang dikirimkan bersama allowlist URL di lingkungan yang dihosting sendiri, tambahkan entri serverUrl yang tercantum di bawah Lalu lintas Connector meninggalkan jaringan Anda. Claude Code menghapus connector yang dikirimkan ketika managed-mcp.json ada di host yang menjalankan sesi, seperti host runner yang dihosting sendiri, terlepas dari apakah Anda menetapkan allowAllClaudeAiMcps.
• Sesi lokal dan SSH aplikasi desktop: aplikasi desktop mendaftarkan connector sebagai server type: "sdk" dalam proses, dan tidak ada pengaturan MCP atau managed-mcp.json yang mencapainya. Pengguna menjaga connector keluar dari sesi mereka sendiri dengan memutusnya di claude.ai/customize/connectors. Organisasi memblokir alat connector atau mematikan Claude Code di aplikasi desktop sepenuhnya.

​

Kontrol organisasi pada alat connector

• Alat diatur ke ask: Claude Code meminta pada setiap panggilan dengan alasan Your organization requires approval for this tool. Prompt muncul bahkan dalam mode izin acceptEdits, auto, dan bypassPermissions, dan tidak pernah menawarkan opsi untuk mengingat pilihan Anda. Aturan Allow yang cocok dengan alat tidak melewati prompt juga. Dalam mode dontAsk, yang tidak pernah meminta, Claude Code menolak panggilan sebagai gantinya.
• Alat diatur ke blocked: Claude Code memfilter alat keluar sebelum Claude melihatnya, jadi tidak pernah muncul dalam daftar alat. Aplikasi desktop dan chat claude.ai menerapkan pengaturan blocked yang sama, jadi Claude tidak dapat menggunakan alat di sana juga, dan Anda tidak dapat menahan alat dari sesi aplikasi desktop sambil membuatnya tersedia di chat. Aplikasi desktop melewati connector yang semua alatnya diblokir.

​

Nonaktifkan connectors claude.ai

{
  "disableClaudeAiConnectors": true
}

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

Gunakan Claude Code sebagai server MCP

# Mulai Claude sebagai server MCP stdio
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Batas dan peringatan output MCP

• Ambang batas peringatan output: Claude Code menampilkan peringatan ketika output alat MCP apa pun melebihi 10.000 token
• Batas yang dapat dikonfigurasi: Anda dapat menyesuaikan token output MCP maksimum yang diizinkan menggunakan variabel lingkungan MAX_MCP_OUTPUT_TOKENS
• Batas default: maksimum default adalah 25.000 token
• Cakupan: variabel lingkungan berlaku untuk alat yang tidak mendeklarasikan batas mereka sendiri. Alat yang menetapkan anthropic/maxResultSizeChars menggunakan nilai tersebut sebagai gantinya untuk konten teks, terlepas dari apa yang ditetapkan MAX_MCP_OUTPUT_TOKENS. Alat yang mengembalikan data gambar masih tunduk pada MAX_MCP_OUTPUT_TOKENS
• Melampaui batas: ketika hasil tanpa konten gambar melebihi batas, Claude Code menyimpannya ke file dan menggantinya dalam percakapan dengan pesan yang menyebutkan jalur file, sehingga Claude membaca file ketika membutuhkan konten. File tersebut berada di direktori tool-results sesi di bawah ~/.claude/projects/.

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

Tingkatkan batas untuk alat tertentu

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

Gambar dalam hasil alat

​

Skema input tool dengan combinator tingkat root

• allOf: properti dari setiap cabang digabungkan, dan daftar required setiap cabang masih berlaku
• anyOf dan oneOf: properti dari setiap cabang digabungkan, dan daftar required setiap cabang dijelaskan dalam deskripsi tool alih-alih diterapkan oleh skema

​

Tools dengan skema input yang tidak valid

• Nama properti tingkat atas harus panjangnya 1 hingga 64 karakter dan hanya menggunakan huruf ASCII dan angka, _, ., dan -
• Skema harus valid terhadap meta-skema JSON Schema draft 2020-12. Claude Code menerapkan pemeriksaan ini pada skema yang tidak mendeklarasikan $schema dan skema yang mendeklarasikan draft 2020-12. Skema yang mendeklarasikan dialek lain melewati pemeriksaan ini, meskipun pemeriksaan nama properti di atas tetap berlaku

​

Memerlukan persetujuan untuk alat tertentu

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

Merespons permintaan elicitation MCP

• Form mode: Claude Code menampilkan dialog dengan bidang formulir yang ditentukan oleh server (misalnya, prompt nama pengguna dan kata sandi). Isi bidang dan kirimkan.
• URL mode: Claude Code menanyakan apakah akan membuka tautan di browser Anda dan membukanya ketika Anda menerima. Server menggunakan mode ini untuk alur yang selesai di luar terminal, seperti sign-in.

​

Gunakan sumber daya MCP

​

Referensikan sumber daya MCP

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

Compare @postgres:schema://users with @docs:file://database/user-model

​

Skalakan dengan pencarian tool MCP

​

Untuk penulis server MCP

• Kategori tugas apa yang ditangani tool Anda
• Kapan Claude harus mencari tool Anda
• Kemampuan utama yang disediakan server Anda

​

Konfigurasi pencarian tool

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5, dan yang lebih baru: pencarian tool aktif secara default, sama seperti di Anthropic API.
• Model Agent Platform sebelumnya: Claude Code memuat semua tool MCP di awal, karena stack penyajian mereka menolak header beta yang diperlukan. ENABLE_TOOL_SEARCH=true tidak mengesampingkan ini.

# Gunakan ambang khusus 5%
ENABLE_TOOL_SEARCH=auto:5 claude

# Nonaktifkan pencarian tool sepenuhnya
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

​

Bebaskan server dari penundaan

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

Gunakan MCP prompts sebagai perintah

​

Jalankan MCP prompts

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

Konfigurasi MCP yang dikelola