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: Menambahkan server HTTP jarak jauh

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

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

​

Opsi 2: Menambahkan server SSE jarak jauh

# Basic syntax
claude mcp add --transport sse <name> <url>

# Real example: Connect to Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

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

​

Opsi 3: Menambahkan server stdio lokal

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

# Real example: Add Airtable server
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

Cara Claude Code menghentikan server stdio

• Di macOS dan Linux: Claude Code mengirim SIGINT, lalu SIGTERM jika proses masih berjalan 100 milidetik kemudian, lalu SIGKILL setelah 400 milidetik berikutnya.
• Di Windows: Claude Code menutup stdin server, lalu mengakhiri pohon proses server jika proses masih berjalan 300 milidetik kemudian.

​

Opsi 4: Menambahkan server WebSocket jarak jauh

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

​

Menambahkan server dari instruksi penyiapan yang ditulis untuk klien lain

• URL seperti https://mcp.example.com/mcp: server tersebut adalah server 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.

​

Menambahkan server dari URL

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

​

Menambahkan server dari perintah npx, uvx, atau biner

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

​

Menambahkan server dari blok JSON mcpServers

• url tanpa type: tambahkan "type": "http", "type": "sse", atau "type": "ws" sesuai endpoint. Claude Code membaca entri tanpa type sebagai server stdio, sehingga entri url tanpa type akan gagal.
• Kunci dengan karakter selain huruf, angka, tanda hubung, dan garis bawah: pilih nama server yang hanya menggunakan karakter tersebut. Jika tidak, kunci tersebut 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

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/mcp

​

Status server

• ⏸ Pending approval (run `claude` to approve): server dengan cakupan proyek dari .mcp.json yang belum Anda setujui. Claude Code menampilkannya 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 ditolak oleh entri disabledMcpjsonServers. Claude Code hanya menampilkannya di claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp): server yang disebutkan dalam daftar disabledMcpServers proyek. Claude Code menampilkannya di claude mcp list maupun claude mcp get <name>. Aktifkan kembali server dari panel /mcp.
• ✘ Blocked by enterprise managed policy: server yang ditolak oleh salah satu kebijakan organisasi Anda. Claude Code menampilkannya di claude mcp list dan claude mcp get <name>. Server yang diblokir oleh allowlist, denylist, atau pembatasan lain dalam konfigurasi MCP terkelola disembunyikan dari kedua perintah alih-alih ditampilkan dengan status ini. Tanyakan kepada administrator Anda kebijakan mana yang memblokir server tersebut.

​

Persetujuan server proyek dan kepercayaan workspace

• ~/.claude/settings.json pengguna Anda
• pengaturan terkelola
• pengaturan yang diberikan dengan --settings

​

Detail status server

• Path dan query tidak pernah muncul dalam pesan tersebut.
• Untuk server di cakupan lokal, proyek, atau pengguna, atau dalam konfigurasi MCP terkelola, origin menampilkan host sebagaimana ditulis dalam konfigurasi tersebut, sehingga referensi ${VAR} di host tidak diekspansi dalam pesan.
• Untuk kegagalan tanpa status atau kode kesalahan, Claude Code menampilkan teks kesalahan tanpa origin.

​

Peringatan konfigurasi

• Spasi tersembunyi: Claude Code memberikan peringatan ketika nilai konfigurasi MCP membawa spasi tersembunyi di awal atau akhir, yang sering berasal dari menempelkan token dengan baris baru di akhir. Claude Code memeriksa command, url, setiap entri args, serta nilai dan nama kunci di bawah env dan headers. Claude Code menampilkan peringatan di output claude mcp list dan di /mcp, dengan menyebutkan field yang terpengaruh tanpa menampilkan nilainya, misalnya Leading or trailing whitespace in: headers.Authorization. Claude Code tidak memangkas spasi tersebut dan menggunakan nilai persis seperti yang ditulis, jadi edit konfigurasi untuk menghapusnya.
• Nama yang sama di lebih dari satu cakupan: jika Anda mendefinisikan nama server yang sama di lebih dari satu cakupan dengan endpoint yang berbeda, Claude Code memberikan peringatan tentang konflik tersebut di output claude mcp list dan di /mcp. Claude Code menyimpan login OAuth per endpoint, sehingga ketika Anda mengautentikasi definisi yang dimuat di satu proyek, Anda tetap perlu login secara terpisah di proyek tempat definisi lain dimuat. Pertahankan endpoint yang Anda inginkan dan hapus yang lainnya dengan claude mcp remove <name> --scope <scope>. Dalam peringatan tersebut, Claude Code mengutip endpoint setiap cakupan sebagaimana ditulis dalam konfigurasi Anda, dengan referensi ${VAR} yang tidak diekspansi, sehingga tidak pernah menampilkan nilai yang sudah di-resolve seperti kunci API.
• Nama yang dicadangkan: Claude Code mencadangkan nama-nama server bawaannya, termasuk workspace, claude-in-chrome, computer-use, Claude Preview, dan Claude Browser. Jika konfigurasi Anda mendefinisikan server dengan nama yang dicadangkan, Claude Code melewatinya saat pemuatan dan menampilkan peringatan yang meminta Anda mengganti namanya. claude mcp add menolak nama yang dicadangkan dengan kesalahan. Claude Preview dan Claude Browser keduanya menamai server bawaan yang digunakan oleh panel pratinjau aplikasi desktop Claude Code.
• Environment variable yang hilang: jika referensi ${VAR} dalam konfigurasi server menyebutkan variabel yang tidak ditetapkan dan tidak memiliki :-default, Claude Code memberikan peringatan di output claude mcp list dan di /mcp, dengan menyebutkan variabel tersebut, dan tetap memuat server dengan teks ${VAR} yang tidak diekspansi. Tetapkan variabel tersebut atau tambahkan fallback ${VAR:-default}. Di url dan headers server jarak jauh, beberapa variabel kredensial dibaca sebagai kosong sebagai gantinya, tanpa peringatan.

​

Ketersediaan tool

• Dengan tool search, yang merupakan default: penungguan terjadi di dalam panggilan ToolSearch.
• Tanpa tool search: Claude menggunakan tool WaitForMcpServers sebagai gantinya. Konfigurasi tanpa tool search mencakup ENABLE_TOOL_SEARCH=false dan model yang lebih lama dari Claude Opus 4.5, Claude Sonnet 4.5, dan Claude Haiku 4.5 di Agent Platform Google Cloud. Untuk gateway ANTHROPIC_BASE_URL, lihat Tool search melalui LLM gateway.
• Pada deployment yang di-host di Azure Microsoft Foundry: Claude memulai pada jalur tool search alih-alih dengan WaitForMcpServers, karena Claude Code hanya mengetahui penolakan sisi server deployment tersebut dari API. Setelah Claude Code mengalihkan deployment tersebut ke pemuatan di awal, tool dari server yang selesai terhubung menjadi tersedia pada permintaan Claude berikutnya.

​

Menonaktifkan server tanpa menghapusnya

• disabledMcpServers: daftar opt-out untuk server yang dikonfigurasi pengguna, server plugin, server yang disediakan organisasi Anda melalui pengaturan terkelola, konektor claude.ai yang diambil Claude Code sendiri, dan server bawaan yang aktif secara default. 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 Menonaktifkan konektor claude.ai, Claude Code menuliskannya ke daftar ini dengan nama tampilannya, misalnya claude.ai Slack.
• enabledMcpServers: daftar opt-in untuk server bawaan yang nonaktif secara default, seperti computer-use. Claude Code hanya terhubung ke server yang nonaktif secara default ketika Anda mencantumkannya di sini.

​

Runtime klien MCP

• Sesi di Amazon Bedrock, Claude Platform di AWS, Agent Platform Google Cloud, atau Microsoft Foundry, kecuali platform host yang menyematkan Claude Code menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sesi yang login melalui Claude apps gateway
• Sesi di mana Anda mematikan telemetri atau pengambilan feature flag, misalnya dengan DISABLE_TELEMETRY

• Menanyakan kepada server HTTP, stdio, dan konektor claude.ai apakah mereka mendukung revisi yang lebih baru, dan menggunakannya dengan server yang mendukung. Ini mencakup konektor dari sesi cloud dan sesi Remote Control. Claude Code terhubung ke setiap server lainnya seperti yang dilakukan v1.
• Menerima notifikasi list_changed dari server pada revisi yang lebih baru melalui stream yang dibiarkan terbuka.
• Tidak mendaftarkan server channel yang terhubung pada revisi yang lebih baru, karena revisi tersebut tidak dapat membawa pesan channel.
• Menggagalkan login MCP OAuth yang respons otorisasinya menyebutkan issuer yang tidak terduga.
• Mengirim kredensial MCP OAuth hanya ke token endpoint yang dilayani melalui HTTPS atau di localhost, 127.0.0.1, atau ::1. Login gagal untuk server yang token endpoint-nya adalah http:// biasa di tempat lain, seperti perangkat di jaringan lokal Anda. Lihat Refusing to send credentials to non-https token endpoint.

​

Pembaruan tool dinamis

• Dalam sesi terminal interaktif, Claude Code mengambil daftar yang diperbarui dari server tersebut, sehingga Anda tidak perlu menghubungkannya ulang.
• Dalam mode non-interaktif dengan flag -p dan di Agent SDK, Claude Code hanya memperbarui daftar tool pada notifikasi ini.

​

Stream notifikasi pada runtime v2

• Stream ditutup lagi dalam 10 detik: Claude Code membukanya kembali hingga tiga kali, lalu berhenti untuk koneksi tersebut.
• Stream tetap terbuka lebih dari 10 detik, lalu ditutup, seperti yang umum terjadi pada stream ke host serverless: setelah lima kali dibuka kembali dalam satu jam, Claude Code menunggu sekitar enam jam sebelum pembukaan berikutnya.

​

Koneksi ulang otomatis

​

Server jarak jauh yang terputus di tengah sesi

• Dalam sesi interaktif: /mcp menampilkan server sebagai tertunda selama Claude Code menghubungkan ulang. Setelah lima upaya gagal, Claude Code menandai server sebagai gagal, atau sebagai memerlukan autentikasi ketika server perlu diotorisasi lagi. Ketika Claude Code menandai server sebagai gagal, Anda melihat notifikasi MCP server "<name>" disconnected · open /mcp to reconnect. Anda dapat mencoba ulang secara manual dari /mcp.
• Dalam eksekusi claude -p dan sesi Agent SDK: Claude Code melakukan lima upaya yang sama, tanpa panel /mcp untuk menampilkannya. Jika kelimanya gagal, eksekusi berlanjut tanpa tool server tersebut:
  • Setelah kesalahan sementara, seperti respons 5xx atau timeout: Claude Code terus mencoba ulang server HTTP atau SSE di latar belakang. Retry berlangsung hingga sekitar setengah jam, dan tool server menjadi tersedia kembali ketika salah satunya berhasil terhubung. Hingga saat itu, sesi Agent SDK melaporkan status failed, dan kode Anda dapat menghubungkan ulang server. Untuk menghubungkannya ulang di claude -p, mulai eksekusi lagi.
  • Ketika server mengharuskan Anda login lagi: Claude Code berhenti mencoba ulang, dan sesi Agent SDK melaporkan status server sebagai needs-auth. Login dengan claude mcp login <name> di shell Anda. Kemudian mulai eksekusi lagi atau, dalam sesi Agent SDK, hubungkan ulang server sebagai gantinya.

​

Koneksi pertama yang gagal

• Koneksi pertama server stdio. Untuk mencobanya lagi, lihat Server stdio yang keluar atau gagal dimulai
• Koneksi pertama server WebSocket. Untuk mencobanya lagi dalam sesi terminal interaktif, pilih Reconnect dari menu server di /mcp
• Kesalahan autentikasi atau not-found, karena memerlukan perubahan konfigurasi untuk menyelesaikannya. Ketika headersHelper adalah satu-satunya sumber header Authorization server, Claude Code tetap mencoba ulang kesalahan autentikasi, karena Claude Code menjalankan ulang helper pada setiap upaya dan dapat memperoleh kredensial baru

​

Server stdio yang keluar atau gagal dimulai

​

Permintaan penemuan yang gagal

​

Mencoba ulang server yang gagal sendiri

​

Cara Claude mengetahui bahwa server gagal

• Dengan tool search, Claude Code memberi tahu Claude server mana yang gagal beserta kesalahan koneksinya, sehingga Claude melaporkan kegagalan koneksi dalam responsnya. Claude Code menyertakan informasi yang sama dalam hasil ToolSearch yang tidak menemukan tool yang cocok.
• Dalam konfigurasi apa pun tanpa tool search, Claude Code tidak melaporkan koneksi server yang gagal kepada Claude.

​

Mendorong pesan dengan channel

​

Batas waktu pada panggilan tool MCP

• Per server: tambahkan field timeout dalam milidetik ke entri konfigurasi server tersebut
• Lintas server: tetapkan MCP_TOOL_TIMEOUT

​

Pemindahan otomatis panggilan tool yang panjang ke latar belakang

• Tetapkan environment variable CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS dalam milidetik untuk mengubah ambang, atau tetapkan ke 0 untuk mematikan pemindahan otomatis ke latar belakang. Dengan 0, Claude juga menunggu tugas MCP dalam sesi interaktif
• Atur CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ke 1 untuk mematikan pemindahan otomatis ke latar belakang dan perintah latar belakang

• Panggilan dari subagent; Claude Code hanya memindahkan panggilan percakapan utama ke latar belakang
• Panggilan ke server IDE
• Panggilan dalam mode non-interaktif, kecuali CLAUDE_AUTO_BACKGROUND_TASKS ditetapkan ke 1, karena eksekusi sekali jalan dapat berakhir sebelum hasilnya tiba

​

Tugas MCP yang berjalan di server

​

Menghentikan tugas MCP atau mendapatkan hasilnya

MCP task <server task id> (<server>/<tool>) completed.

​

Menjawab pertanyaan dari tugas MCP

​

Keluar, membersihkan, atau melanjutkan saat tugas MCP berjalan

​

Yang diperlukan agar panggilan menjadi tugas MCP

• Server mendukung tugas
• Server adalah server HTTP, stdio, atau konektor claude.ai yang terhubung pada revisi protokol 2026-07-28. Menetapkan MCP_SDK_GENERATION=v1 atau MCP_PROTOCOL_NEGOTIATION=legacy mengecualikan hal tersebut
• Sesi mengambil feature flag, jadi tidak pada penyedia pihak ketiga seperti Amazon Bedrock, dan tidak dengan telemetri atau pengambilan flag dimatikan
• Anthropic telah mengaktifkan tugas MCP untuk jenis sesi Anda. Pada v2.1.304 atau yang lebih baru, ini mencakup sesi CLI terminal, sesi Agent SDK, dan eksekusi GitHub Actions. Surface lain, seperti ekstensi VS Code dan aplikasi desktop, tidak memiliki tugas MCP
• Panggilan berasal dari percakapan utama, bukan dari subagent
• Sesi bersifat interaktif, atau sesi Agent SDK atau eksekusi claude -p yang membaca --input-format stream-json memiliki:
  • CLAUDE_AUTO_BACKGROUND_TASKS bernilai 1
  • CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND tidak bernilai 1
  • CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS tidak bernilai 0

​

Pesan status pada tugas MCP

​

Batas waktu pada tugas MCP

​

Membuat Claude menunggu hasil tugas MCP

• CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS ditetapkan ke 0: Claude menunggu setiap panggilan tool MCP sampai panggilan selesai
• CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND ditetapkan ke 1: Claude menunggu hasil tugas. Selama pemindahan otomatis ke latar belakang aktif, panggilan dipindahkan setelah dua menit secara default, sehingga tugas singkat selesai di tempat dan tugas panjang tidak memblokir Anda. Panggilan yang dipindahkan adalah panggilan latar belakang biasa, bukan tugas MCP. Panggilan tersebut tidak bertahan setelah keluar dari sesi

{
  "env": {
    "CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS": "0"
  }
}

​

Tugas MCP untuk pembuat server

​

Menjawab panggilan dengan tugas

{
  "resultType": "task",
  "taskId": "build-7f3a9c2e",
  "status": "working",
  "statusMessage": "Compiling, 40 of 212 files done",
  "createdAt": "2026-10-22T14:03:07Z",
  "lastUpdatedAt": "2026-10-22T14:03:07Z",
  "ttlMs": null,
  "pollIntervalMs": 5000
}

​

Melaporkan status, hasil, dan pertanyaan

{
  "resultType": "complete",
  "taskId": "build-7f3a9c2e",
  "status": "completed",
  "createdAt": "2026-10-22T14:03:07Z",
  "lastUpdatedAt": "2026-10-22T14:09:41Z",
  "ttlMs": null,
  "result": {
    "content": [{ "type": "text", "text": "Build succeeded: 212 files, 0 warnings" }]
  }
}

​

Server MCP yang disediakan plugin

• Plugin mendefinisikan server MCP di .mcp.json pada root plugin atau secara inline di plugin.json
• Ketika Anda mengaktifkan plugin, Claude Code memulai server MCP-nya secara otomatis
• Claude Code menawarkan tool MCP plugin bersama dengan tool MCP yang dikonfigurasi secara manual
• Anda menambahkan dan menghapus server plugin dengan menginstal atau menghapus instalasi plugin, bukan dengan perintah /mcp. Anda tetap dapat menonaktifkan server plugin yang terinstal di /mcp, yang menghentikan Claude Code terhubung ke server tersebut 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-titik berikut:
  • 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 dapat menampilkan status cached sebagai gantinya; Claude Code menghubungkannya ketika Claude pertama kali memanggil salah satu tool-nya. Ketika koneksi server plugin stdio gagal kurang dari 15 menit sebelumnya, Claude Code melewati koneksi tersebut
  • Jika Anda mengaktifkan atau menonaktifkan plugin selama sesi, Claude Code menghubungkan atau memutuskan server MCP-nya ketika perubahan diterapkan. Menerapkan perubahan plugin tanpa memulai ulang menjelaskan kapan hal itu terjadi. Dalam sesi tanpa terminal interaktif, /reload-plugins tidak menghubungkan atau memutuskan server MCP plugin; perubahan tersebut berlaku di sesi berikutnya
  • Saat Anda memuat ulang, Claude Code mempertahankan koneksi aktif server plugin yang konfigurasinya tidak berubah, dan melakukan hal yang sama ketika Anda mengganti daftar server MCP sesi dari Agent SDK tanpa menyebutkan server tersebut
  • Ketika Anda memindahkan sesi dengan /cd pada v2.1.246 atau yang lebih baru, Claude Code menghubungkan server plugin yang diaktifkan oleh pengaturan direktori baru dan memutuskan server plugin yang tidak lagi diaktifkan, sehingga Anda tidak perlu menjalankan /reload-plugins setelah pemindahan
  • Dalam sesi cloud, panggilan MCP ke server plugin yang belum terhubung, seperti tepat setelah sesi idle aktif kembali, memulai server sesuai permintaan dan menunggunya terhubung
• Placeholder path: ${CLAUDE_PLUGIN_ROOT} di-resolve ke direktori instalasi plugin, ${CLAUDE_PLUGIN_DATA} ke direktori state persisten-nya, dan ${CLAUDE_PROJECT_DIR} ke root proyek yang stabil. Substitusi berlaku untuk:
  • Server stdio: command, args, env
  • Server http, sse, dan ws: url, headers, dan headersHelper
• Akses lingkungan pengguna: akses ke environment variable yang sama seperti server yang dikonfigurasi secara manual
• Beberapa jenis transport: dukungan untuk transport stdio, SSE, HTTP, dan WebSocket, meskipun dukungan transport dapat bervariasi menurut server

• Server stdio: mencetak Command: stdio, baris Args: kosong, dan setiap environment variable sebagai NAME=[REDACTED]
• Server WebSocket: mencetak URL: ws dan setiap header sebagai <name>: [REDACTED], dan claude mcp list menampilkan ws sebagai pengganti URL

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

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

​

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 yang diatur ke string kosong

​

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 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 otorisasi 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 itu dari referensi ${VAR}, periksa apakah variabel itu adalah salah satu yang Claude Code baca sebagai kosong.
• Untuk konektor dikirimkan ke sesi cloud, Claude Code tidak menjalankan alur masuk, karena proxy sesi mengautentikasi ke konektor dengan otorisasi yang Anda berikan di claude.ai. Ketika konektor di sana perlu diotorisasi lagi, sambungkan 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

​

Timpa 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 scope OAuth

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

​

Gunakan OAuth dengan server di balik proxy yang melakukan autentikasi

• Header proxy: teruskan dengan --header, bidang headers, atau headersHelper, dengan nama yang dibaca proxy
• Proses masuk OAuth: jangan sertakan Authorization dalam header yang dikonfigurasi, lalu masuk dengan claude mcp login <name> di shell Anda. Jika Anda mengonfigurasi header Authorization, Claude Code menggunakannya sebagai kredensial server dan tidak kembali ke OAuth untuk server tersebut.

​

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 di mana Anda mengonfigurasi server, jadi berikan skrip sebagai jalur absolut atau letakkan di PATH
• Header dinamis menimpa headers statis apa pun dengan nama yang sama

​

Di mana helper berjalan

​

Variabel mana yang dapat dibaca helper

• Dihapus: server di .mcp.json proyek atau di plugin, dan server inline di file agent 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 agent 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 hook di file pengaturan
• Sampai Anda mempercayai folder: Claude Code menghubungkan server dengan headers statis saja. Dalam sesi claude -p atau SDK ini 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 menurut Aturan izin proyek dan kepercayaan workspace menjadi kunci kepercayaan Claude Code.

​

Masuk ke server MCP di balik gateway yang memerlukan header

• Server yang konfigurasinya dapat Anda edit: tetapkan di headers atau kembalikan dari headersHelper
• Server yang disediakan oleh MCP terkelola atau plugin: minta administrator Anda atau pembuat plugin untuk menambahkan header ke entri server

• Halaman otorisasi: Anda masuk di halaman ini melalui browser Anda, yang tidak mengirim header yang dikonfigurasi. Jika browser Anda menerima kesalahan dari gateway alih-alih halaman tersebut, minta pengelola gateway untuk meloloskan halaman itu tanpa header.
• Server otorisasi pada origin lain: jika gateway di depan server itu juga memerlukan header, proses masuk gagal di sana. Minta pengelola gateway tersebut untuk meloloskan permintaan OAuth tanpa header.

​

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

• Tool 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. Di terminal, prompt tidak memiliki opsi untuk mengingat pilihan Anda. Aturan Allow yang cocok dengan tool juga tidak melewati prompt. 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 Claude. Di sesi tempat Claude Code mengambil connector sendiri, daftar alat /mcp masih menunjukkan alat, ditandai disabled by your organization.

​

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": {}
    }
  }
}

​

Membaca output perintah latar belakang sebagai klien MCP

• Untuk membaca output sejauh ini: buka file di jalur tersebut dari klien Anda, atau berikan jalur tersebut sebagai file_path ke tool Read milik server
• Untuk mengetahui kapan perintah telah selesai: tambahkan echo berisi string tetap ke nilai command, seperti npm test; echo DONE. Perintah telah selesai setelah string tersebut muncul di dalam file. Tanpa string tersebut, tidak ada yang menandai akhirnya, karena Claude Code tidak menambahkan baris penutup ke file dan tidak memberi tahu klien Anda.
• Untuk membaca bagian akhir output yang panjang: Read dengan hanya file_path mengembalikan halaman pertama, atau gagal ketika file melebihi batas ukuran. Berikan juga offset dan limit, yang berfungsi pada ukuran file berapa pun:
  1. Panggil Read dengan offset dan limit keduanya ditetapkan ke 1, lalu ambil totalLines dari hasilnya
  2. Panggil Read lagi dengan offset ditetapkan ke totalLines dikurangi sembilan dan limit ditetapkan ke 10
  3. Cari string echo Anda di sepuluh baris terakhir, yang dikembalikan oleh panggilan kedua

​

Batas dan peringatan output MCP

• Ambang batas peringatan output: Claude Code menampilkan peringatan ketika output tool MCP apa pun melebihi 10.000 token
• Batas yang dapat dikonfigurasi: Anda dapat menyesuaikan token output MCP maksimum yang diizinkan menggunakan environment variable MAX_MCP_OUTPUT_TOKENS
• Batas default: maksimum default adalah 25.000 token
• Cakupan: environment variable berlaku untuk tool yang tidak mendeklarasikan batas mereka sendiri. Tool yang menetapkan anthropic/maxResultSizeChars menggunakan nilai tersebut sebagai gantinya untuk konten teks, terlepas dari apa yang ditetapkan MAX_MCP_OUTPUT_TOKENS. Tool yang mengembalikan data gambar masih tunduk pada MAX_MCP_OUTPUT_TOKENS
• Melampaui batas: ketika hasil yang berhasil tanpa konten gambar melebihi batas token, 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/.
• Ukuran respons dari server HTTP dan SSE: ketika respons dari server HTTP atau SSE melewati 16 MiB, Claude Code berhenti membacanya dan permintaan tersebut gagal. Batas ini berlaku setelah dekompresi untuk satu body respons JSON atau satu event dari event stream. Jika Anda mengelola server tersebut, kembalikan lebih sedikit data per respons agar tetap di bawah batas, misalnya dengan melakukan paginasi hasil
• Ukuran pesan dari server WebSocket: ketika server WebSocket mengirim satu pesan yang melebihi 16 MiB, Claude Code menutup koneksi, dan panggilan yang sedang berlangsung pada server tersebut gagal. Jika Anda mengelola server tersebut, kembalikan lebih sedikit data per pesan agar tetap di bawah batas

• Batas karakter untuk hasil teks: untuk tool yang tidak mendeklarasikan anthropic/maxResultSizeChars, Claude Code menyimpan hasil yang berhasil tanpa konten gambar ke file setelah panjangnya melebihi 50.000 karakter, berapa pun jumlah tokennya. Menetapkan MAX_MCP_OUTPUT_TOKENS tidak mengubah ambang batas ini
• Hasil error: ketika tool mengembalikan hasil yang ditandai isError: true, Claude menerima teks hasil tersebut sebagai pesan error tool. Teks error yang lebih panjang dari sekitar 11.000 karakter hanya mempertahankan 5.000 karakter pertama dan 5.000 karakter terakhirnya, dengan penanda di antaranya yang menyebutkan berapa banyak karakter yang dihapus

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

Tingkatkan batas untuk tool tertentu

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

​

Gambar dalam hasil tool

​

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

• Claude menerima tool tanpa perubahan, dan log server mencatat input schema would be rejected by the Anthropic API untuk tool tersebut
• Jika API kemudian menolak skema tersebut, lihat Tools yang skema inputnya ditolak API

​

Tools yang skema inputnya ditolak API

• Jika sesi Anda gagal dengan kesalahan 400 yang menamai tool berdasarkan posisinya: ikuti langkah-langkah di Tool input schema is invalid
• Jika Anda menggunakan server tersebut: Anda tidak perlu melakukan apa pun. Claude tetap dapat memanggil tool tersebut, tetapi tidak melihat parameternya
• Jika Anda memelihara server tersebut: perbaiki skema input tool di server. Baris log diakhiri dengan The API said: dan alasan API menolak skema tersebut. Validasi argumen yang diterima server, karena Claude memanggil tool tanpa melihat parameternya

​

Tool dengan nama lebih dari 128 karakter

​

Memerlukan persetujuan untuk tool tertentu

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

​

Tandai tool yang aman dipanggil dua kali

• idempotentHint: tool dapat mengubah sesuatu, dan memanggilnya lagi dengan argumen yang sama aman dilakukan
• readOnlyHint: tool tidak mengubah apa pun. Claude Code juga menjalankan panggilan tool tersebut secara paralel dengan panggilan read-only lainnya.

{
  "name": "set_issue_status",
  "annotations": {
    "idempotentHint": 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. Server menggunakan mode ini untuk alur yang selesai di luar terminal, seperti sign-in.

​

Mode elicitation yang dideklarasikan Claude Code

• Koneksi yang menggunakan revisi protokol 2026-07-28
• Koneksi pada revisi protokol sebelumnya, 2025-11-25 dan yang lebih lama, ke server stdio, sse, http, dan ws dalam konfigurasi MCP Claude Code milik pengguna. Memerlukan Claude Code v2.1.287 atau yang lebih baru

​

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

​

Pencarian tool untuk penulis server MCP

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

• Instruksi server, dan deskripsi tool yang dimuat di awal: 4.096 karakter
• Deskripsi tool yang dimuat Claude melalui pencarian tool: 16.384 karakter

​

Ubah batas panjang deskripsi

​

Tandai tool agar dimuat di awal atau tetap ditunda

{
  "name": "search_tickets",
  "description": "Searches the ticket tracker by keyword",
  "_meta": {
    "anthropic/alwaysLoad": true
  }
}

​

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 menimpa ini.

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

# Nonaktifkan pencarian tool sepenuhnya
ENABLE_TOOL_SEARCH=false claude

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

​

Pencarian tool melalui LLM gateway

​

Tool yang tetap ditunda di bawah ambang ENABLE_TOOL_SEARCH=auto

​

Bebaskan server dari penundaan

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

​

Tunda tool server

​

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