Konfigurasi MCP VS Code: Pakai servers, Bukan mcpServers

Perbedaannya, Berdampingan

Server yang sama, perintah yang sama, argumen yang sama. Satu-satunya yang berubah adalah kunci pembungkusnya.

Yang Diinginkan VS Code

Di .vscode/mcp.json, di root workspace Anda. Memakai konektor MyLinedChart sebagai contoh:

{ "servers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Ganti dengan command dan args server Anda sendiri. Bentuk objek bagian dalam tidak berubah antar klien.

Yang Diinginkan Semua yang Lain

Server yang sama, untuk Claude atau Cursor:

{ "mcpServers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Jika kedua editor terbuka bersamaan, Anda memang membutuhkan kedua file. Kedua editor tidak bisa berbagi satu konfigurasi.

Mengapa Gagal Tanpa Error

VS Code membaca file, menemukan JSON yang valid, dan mencari kunci servers. File itu tidak punya kunci servers, jadi VS Code menemukan nol server untuk dijalankan. Nol server bukan kondisi error. Dari sudut pandang VS Code Anda belum mengonfigurasi apa pun, yang merupakan hal yang sah-sah saja.

Jadi tidak ada garis bergelombang merah, tidak ada notifikasi, dan tidak ada entri di log mana pun yang menyebut kuncinya salah. Kegagalannya terlihat persis seperti server yang crash saat startup, itulah sebabnya orang malah men-debug servernya.

• File berupa JSON yang valid, jadi tidak muncul error parse.
• Kunci tingkat atas yang tidak dikenali diabaikan, bukan ditolak.
• Nol server terkonfigurasi adalah kondisi normal, jadi VS Code tidak melaporkan kesalahan.

Cara Memastikan Masalah yang Mana yang Anda Hadapi

Sebelum mengira servernya rusak, buktikan dulu bahwa VS Code pernah mencoba menjalankannya.

• Periksa kunci pembungkus lebih dulu. Pemeriksaan ini hanya lima detik dan sering kali itulah jawabannya.
• Jalankan perintah server secara manual di terminal. Jika server berjalan, masalahnya ada di tempat lain.
• Cari server di daftar server MCP VS Code. Tidak ada berarti tidak pernah dikonfigurasi; ada tetapi gagal berarti ada error startup yang sebenarnya.
• Jika Anda memasang lewat tautan satu klik, bukan manual, seluruh kelas masalah ini tidak berlaku.

Dua Jebakan Terkait

Selagi di sini, dua hal lain gagal dengan cara senyap yang sama.

Pertama, tautan pemasangan MCP satu klik membawa muatannya sebagai JSON URL-encoded biasa. Base64 diterima parser URL lalu diam-diam tidak melakukan apa-apa, kegagalan terburuk yang mungkin: tombol yang tampak berhasil.

Kedua, nama server dibawa di dalam muatan untuk VS Code, bukan sebagai parameter query terpisah seperti yang dilakukan Cursor. Tautan yang dibuat sesuai bentuk Cursor tidak akan terpasang dengan benar di VS Code meskipun tautannya terbuka.

Di Mana MyLinedChart Berperan

MyLinedChart menyertakan konektor MCP yang memberi agen AI chart live Anda: simbol, gambar Anda, nilai indikator, dan bar di layar. Konektor berjalan di mesin Anda dan data tidak melewati server kami.

Aplikasi ini punya tombol Add to VS Code satu klik yang menuliskan kunci yang benar untuk Anda, itulah alasan memakainya dibanding mengedit manual. Pengaturan dan klien lainnya: /resources/articles/ibkr-chart-data-github-copilot-vs-code.

Langkah Berikutnya

Perbaiki kuncinya, mulai ulang VS Code, dan server muncul. Jika server tetap tidak muncul, kini Anda tahu masalahnya ada di server dan bukan di konfigurasi, daftar yang jauh lebih pendek untuk ditelusuri.

Hubungkan AI Anda di /mcp.

Pertanyaan yang sering diajukan

Mengapa VS Code memakai servers, bukan mcpServers?

Kunci servers adalah pilihan penamaan dalam format konfigurasi MCP VS Code sendiri, dibuat secara independen dari konvensi yang ditetapkan Claude Desktop. Tidak satu pun lebih benar. Perbedaannya baru jadi masalah karena keduanya tampak bisa dipertukarkan dan salah satunya gagal tanpa memberi tahu.

Apakah VS Code akan memperingatkan saya jika memakai kunci yang salah?

Tidak, dan itulah seluruh kesulitannya. File berupa JSON yang valid, kunci tingkat atas yang tidak dikenal diabaikan, bukan ditolak, dan nol server terkonfigurasi adalah kondisi normal. Tidak ada yang tampak seperti kesalahan.

Bisakah saya memakai satu file konfigurasi untuk VS Code dan Cursor?

Tidak. Keduanya membaca path berbeda dan mengharapkan kunci pembungkus berbeda, jadi Anda butuh kedua file. Definisi server di bagian dalam identik, jadi ini sekadar salinan dengan satu kata diganti.

Apakah ini berlaku juga untuk Copilot di Windows?

Tidak. Copilot yang dimaksud di sini adalah GitHub Copilot di dalam VS Code, yang mendukung server MCP. Asisten di taskbar Windows adalah produk terpisah yang kebetulan senama dan tidak memakai file konfigurasi ini.