FAQ MCP - Seri Qoder CN - Alibaba Cloud Documentation Center

Topik ini menjelaskan error umum yang terjadi saat menginstal dan menjalankan layanan MCP, serta menyediakan solusi dan langkah troubleshooting untuk masalah seperti lingkungan perintah yang tidak tersedia, kegagalan inisialisasi layanan, dan kesalahan konfigurasi.

Error penambahan atau instalasi layanan

1. Lingkungan untuk perintah npx tidak tersedia

Pesan error: failed to start command: exec: "npx": executable file not found in $PATH
Solusi: Unduh dan instal Node.js.

Peringatan

Node.js harus versi 18 atau lebih baru, dan npm harus versi 8 atau lebih baru. Versi sebelumnya dapat menyebabkan panggilan tool gagal.

Kunjungi situs resmi Node.js untuk mengunduh dan menginstal Node.js versi 18 atau yang lebih baru, atau ikuti langkah-langkah berikut:
Langkah instalasi dan verifikasi
Windows

1. Unduh dan instal nvm-windows untuk mengelola beberapa versi.
nvm install 22.14.0 # Install a specific version nvm use 22.14.0

2. Setelah instalasi selesai, jalankan perintah berikut di terminal untuk memverifikasi instalasi.
node -v npx -v

3. Jika instalasi berhasil, terminal akan menampilkan nomor versi Node.js yang terinstal.
macOS

Unduh dan instal Node.js menggunakan Homebrew. Anda harus terlebih dahulu menginstal Homebrew.
# 1. Instal atau perbarui Homebrew<p># 1. Install or update Homebrew</p><p># 1. Update Homebrew and install Node.js</p> brew update brew install node # 2. Verify the core toolchain echo "Node.js version: $(node -v)" echo "npm version: $(npm -v)" echo "npx version: $(npx -v)" # 3. Configure environment variables (if necessary) echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.zshrc

2. Lingkungan untuk perintah uvx tidak tersedia

Pesan error: failed to start command: exec: "uvx": executable file not found in $PATH
Solusi: Instal uv. uvx adalah command-line interface yang disediakan oleh uv untuk menjalankan skrip Python dengan cepat.
- Kunjungi situs resmi Python untuk mengunduh dan menginstal Python 3.8 atau versi yang lebih baru, atau ikuti langkah-langkah berikut:
  Langkah instalasi dan verifikasi
  1. Unduh dan instal
  Sistem Windows
  
  Pada Windows, jalankan perintah berikut untuk menginstal.
  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  
  macOS
  
  Pada macOS dan Linux, jalankan perintah berikut untuk menginstal.
  curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Setelah instalasi selesai, jalankan perintah berikut di terminal untuk memverifikasi instalasi.
```
uv --version
```
  3. Jika instalasi berhasil, terminal akan menampilkan nomor versi uv yang terinstal.

3. Gagal menginisialisasi MCP Client

Pesan error: failed to initialize MCP client: context deadline exceeded
Kemungkinan penyebab:
- Pengaturan parameter layanan salah: Parameter layanan MCP salah, sehingga mencegah inisialisasi layanan.
- Gagal menarik resource: Instalasi gagal karena masalah jaringan menghalangi proses penarikan resource.
- Batasan keamanan jaringan: Layanan MCP gagal diinisialisasi karena diblokir oleh perangkat lunak keamanan internal perusahaan.
Langkah troubleshooting:

1. Klik untuk menyalin perintah lengkap.

莫3@1x (64)

2. Jalankan perintah tersebut di terminal untuk mendapatkan informasi error detail.

莫3@1x (67)

3. Analisis pesan error dan terapkan perbaikan yang sesuai.

Masalah umum 1: Kesalahan konfigurasi

Pada contoh error, pesan menunjukkan bahwa koneksi gagal karena URL koneksi Redis salah. Untuk mengatasi masalah ini, periksa dan perbaiki konfigurasi URL dengan mengedit layanan MCP.

Masalah umum 2: Gagal menarik resource

Jika perintah gagal dijalankan karena kegagalan penarikan resource, jalankan perintah berikut untuk menambahkan sumber cermin lalu lintas. Kemudian, restart proses Lingma dan coba lagi.

Sistem Windows

npm config set registry https://registry.npmmirror.com

macOS

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

Masalah umum 3: Node.js diblokir oleh perangkat lunak keamanan

Berdasarkan notifikasi pemblokiran dari perangkat lunak keamanan, otorisasi proses Node.js atau tambahkan file yang dapat dieksekusi ke dalam daftar izin (allowlist).

Masalah penggunaan tool

Catatan

Jika Anda mengalami masalah dengan layanan dari MCP Marketplace, hubungi komunitas ModelScope untuk dukungan teknis.

Grup Pengembang ModelScope (nomor grup DingTalk: 44837352)

1. Eksekusi tool gagal karena variabel lingkungan atau parameter salah

Langkah troubleshooting:

Jika panggilan tool MCP gagal atau mengembalikan hasil yang tidak sesuai, pertama-tama perluas detail panggilan tool untuk melihat pesan error spesifik. Kemudian, analisis pesan tersebut untuk melakukan troubleshooting.

Penting

Untuk beberapa layanan MCP, seperti Mastergo dan Figma, informasi otentikasi penting seperti API_KEY atau TOKEN termasuk dalam parameter (args).

Setelah Anda menginstal layanan tersebut dari MCP Marketplace, Anda tetap harus mengonfigurasi parameter ini secara manual.

莫3@1x (62)

Solusi:

Buka halaman My Services.
Temukan layanan MCP dan klik Edit.
Pada konfigurasi layanan, lihat bagian parameters (args).
Ganti variabel yang perlu diperbarui atau diisi. Pastikan informasinya benar. Kemudian, sambungkan kembali ke layanan dan coba panggilan tersebut lagi.

莫3@1x (68)

2. Model tidak dapat memanggil tool MCP

Pastikan Anda berada dalam Agent mode.

Penting
Jika tidak ada folder proyek yang dibuka, sistem akan masuk ke AI Chat mode dan tidak dapat memanggil tool MCP. Pertama-tama, muat folder proyek yang sesuai dan beralih ke mode Agent.
Pastikan layanan MCP berada dalam Connected state:

Jika koneksi layanan terputus, klik ikon di sisi kanan antarmuka. Sistem akan mencoba secara otomatis me-restart layanan MCP.

莫3@1x (66)

Saran: Hindari penggunaan nama yang mirip untuk layanan MCP dan tool-nya. Misalnya, jika baik TextAnalyzer-Pro maupun TextAnalyzer-Plus memiliki tool bernama fetchText dengan fungsi serupa, hal ini dapat menyebabkan ambiguitas saat model melakukan panggilan.

3. Pengaturan Pribadi dan halaman tool MCP tidak terbuka, serta panel sesi kosong

Masalah ini terjadi ketika halaman kosong dan file idea.log berisi pesan error berikut: "WARN - #c.i.u.j.JBCefApp - JCefAppConfig.class is not from a JBR module".

Penyebab: Pengaturan default di Android Studio tidak mendukung JCEF. Hal ini mencegah pemuatan halaman seperti Pengaturan Pribadi dan halaman tool MCP.

Solusi:

Konfigurasi JCEF: Di IDE, pilih Help > Find Action... Pada kotak dialog yang muncul, masukkan "Registry" dan buka. Aktifkan opsi `ide.browser.jcef.enabled`. Nonaktifkan opsi `ide.browser.jcef.sandbox.enable`.
Konfigurasi Runtime IDE: Pilih kembali Help > Find Action... Pada kotak input, masukkan "Choose Boot Runtime for the IDE" dan buka. Pilih versi JCEF Runtime yang lebih baru dan klik OK. Restart IDE.

4. Daftar layanan MCP gagal dimuat

Daftar layanan terjebak dalam status loading.

Restart IDE.
Jika masalah tetap berlanjut, Anda dapat menjalankan layanan Lingma secara manual:
Sistem Windows

Buka direktori .lingma/bin/x.x.x/CPU_architecture_64_system/.

Jalankan perintah:
```
Lingma.exe start
```
macOS

Klik ikon Apple di pojok kiri atas layar Anda dan pilih About This Mac untuk melihat model prosesor Anda. Kemudian, buka direktori yang sesuai berdasarkan model prosesor Anda.
- Chip M1: /.lingma/bin/x.x.x/aarch64_darwin/Lingma
- Chip Intel: /.lingma/bin/x.x.x/x86_64_darwin/Lingma
Jalankan perintah:
```
Lingma start
```
Setelah layanan berjalan, klik tombol logon lagi.