Apa itu MCP?

Model Context Protocol (MCP) memungkinkan Cursor terhubung ke alat eksternal dan sumber data.

Kenapa pakai MCP?

MCP menghubungkan Cursor ke sistem dan data eksternal. Daripada ngejelasin struktur proyek berulang kali, integrasiin langsung sama tool yang dipakai. Tulis server MCP pakai bahasa apa pun yang bisa nge-print ke stdout atau nyediain endpoint HTTP — Python, JavaScript, Go, dll.

Cara kerjanya

Server MCP mengekspos kemampuan melalui protokol, menghubungkan Cursor ke alat atau sumber data eksternal. Cursor mendukung tiga metode transport:
TransportLingkungan eksekusiDeploymentPenggunaInputAuth
stdioLokalDikelola oleh CursorSatu penggunaPerintah shellManual
SSELokal/Jarak jauhDideploy sebagai serverBanyak penggunaURL ke endpoint SSEOAuth
Streamable HTTPLokal/Jarak jauhDideploy sebagai serverBanyak penggunaURL ke endpoint HTTPOAuth

Dukungan protokol

Cursor mendukung kapabilitas protokol MCP berikut:
FiturDukunganDeskripsi
ToolsDidukungFungsi yang dieksekusi oleh model AI
PromptsDidukungPesan dan alur kerja bertemplate untuk pengguna
ResourcesDidukungSumber data terstruktur yang dapat dibaca dan dirujuk
RootsDidukungKueri yang diprakarsai server ke batas URI atau sistem berkas tempat operasi dilakukan
ElicitationDidukungPermintaan yang diprakarsai server untuk informasi tambahan dari pengguna

Menginstal server MCP

Instal sekali klik

Instal server MCP dari koleksi kami dan lakukan autentikasi dengan OAuth.

Menggunakan mcp.json

Konfigurasikan server MCP kustom dengan file JSON:
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Konfigurasi server STDIO

Untuk server STDIO (server command line lokal), atur field berikut di mcp.json:
FieldWajibDeskripsiContoh
typeYaJenis koneksi server"stdio"
commandYaPerintah untuk menjalankan executable server. Harus ada di system path atau pakai path penuh."npx", "node", "python", "docker"
argsNggakArray argumen yang dikirim ke perintah["server.py", "--port", "3000"]
envNggakVariabel environment untuk server{"API_KEY": "${input:api-key}"}
envFileNggakPath ke file environment untuk memuat lebih banyak variabel".env", "${workspaceFolder}/.env"

Menggunakan Extension API

Buat pendaftaran server MCP secara terprogram, Cursor nyediain Extension API yang memungkinkan konfigurasi dinamis tanpa perlu ngubah file mcp.json. Ini khususnya berguna buat lingkungan enterprise dan workflow setup otomatis.

Referensi MCP Extension API

Pelajari cara nge-register server MCP secara terprogram pakai vscode.cursor.mcp.registerServer()

Lokasi konfigurasi

Konfigurasi Proyek

Bikin .cursor/mcp.json di proyek lo buat alat yang khusus proyek.

Konfigurasi Global

Bikin ~/.cursor/mcp.json di direktori home lo buat alat yang tersedia di mana-mana.

Interpolasi konfigurasi

Gunakan variabel dalam nilai mcp.json. Cursor me-resolve variabel di bidang berikut: command, args, env, url, dan headers. Sintaks yang didukung:
  • ${env:NAME} variabel environment
  • ${userHome} jalur ke folder home kamu
  • ${workspaceFolder} root proyek (folder yang berisi .cursor/mcp.json)
  • ${workspaceFolderBasename} nama root proyek
  • ${pathSeparator} dan ${/} pemisah jalur OS
Contoh
{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Autentikasi

Server MCP menggunakan variabel lingkungan untuk autentikasi. Lewatkan kunci API dan token lewat konfigurasi. Cursor mendukung OAuth untuk server yang memerlukannya.

Menggunakan MCP di chat

Composer Agent otomatis pakai tool MCP yang tercantum di Available Tools saat relevan. Minta tool tertentu berdasarkan nama atau jelasin apa yang lo butuhin. Aktifin atau nonaktifin tool dari Settings.

Mengaktifkan/nonaktifkan tool

Aktifkan atau nonaktifkan tool MCP langsung dari antarmuka chat. Klik nama tool di daftar tool untuk menyalakan atau mematikannya. Tool yang dinonaktifkan nggak akan dimuat ke konteks atau tersedia buat Agent.

Persetujuan tool

Secara default, Agent bakal minta persetujuan sebelum pakai tool MCP. Klik panah di sebelah nama tool buat lihat argumen.

Auto-run

Aktifkan auto-run biar Agent bisa pakai tool MCP tanpa perlu konfirmasi. Cara kerjanya mirip perintah terminal. Baca selengkapnya tentang pengaturan Auto-run di sini.

Respons tool

Cursor menampilkan respons di chat dengan tampilan argumen dan respons yang bisa diperluas:

Gambar sebagai konteks

Server MCP bisa mengembalikan gambar—screenshot, diagram, dan sebagainya. Kembalikan gambar sebagai string yang dienkode base64:
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ seluruh base64 dipangkas untuk keterbacaan

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Lihat server contoh ini untuk detail implementasi. Cursor menautkan gambar yang dikembalikan ke obrolan. Kalau model mendukung gambar, model bakal menganalisisnya.

Pertimbangan keamanan

Saat menginstal server MCP, pertimbangkan praktik keamanan berikut:
  • Verifikasi sumber: Hanya pasang server MCP dari pengembang dan repositori tepercaya
  • Tinjau perizinan: Periksa data dan API apa yang akan diakses server
  • Batasi kunci API: Gunakan kunci API dengan batasan dan izin minimum yang dibutuhkan
  • Audit kode: Untuk integrasi yang krusial, tinjau kode sumber server
Ingat, server MCP bisa mengakses layanan eksternal dan mengeksekusi kode atas namamu. Selalu pahami apa yang dilakukan server sebelum menginstalnya.

Contoh dunia nyata

Untuk contoh praktis MCP yang benar-benar digunakan, lihat panduan Web Development yang menunjukkan cara mengintegrasikan Linear, Figma, dan alat peramban ke dalam workflow pengembangan lo.

FAQ

Server MCP menghubungkan Cursor ke tool eksternal seperti Google Drive, Notion, dan layanan lain untuk memasukkan dokumen dan requirement ke alur kerja pengkodean Anda.
Lihat log MCP dengan: 1. Buka panel Output di Cursor (Ctrl+Shift+U) 2. Pilih “MCP Logs” dari dropdown 3. Cek error koneksi, masalah autentikasi, atau server crash. Log menampilkan inisialisasi server, pemanggilan tool, dan pesan error.
Bisa! Toggle server on/off tanpa menghapusnya: 1. Buka Settings (Ctrl+Shift+J) 2. Masuk ke Features → Model Context Protocol 3. Klik toggle di samping server mana pun untuk mengaktifkan/menonaktifkan. Server yang dinonaktifkan tidak akan dimuat atau muncul di chat. Ini berguna untuk troubleshooting atau mengurangi clutter tool.
Jika server MCP gagal: Cursor menampilkan pesan error di chat. Pemanggilan tool ditandai gagal. Anda bisa mencoba ulang operasi atau memeriksa log untuk detailnya. Server MCP lain tetap bekerja normal. Cursor mengisolasi kegagalan server agar satu server tidak memengaruhi yang lain.
Untuk server berbasis npm: 1. Hapus server dari settings 2. Bersihkan cache npm: npm cache clean --force 3. Tambahkan kembali server untuk mendapatkan versi terbaru. Untuk server kustom, perbarui file lokal Anda dan restart Cursor.
Bisa, tapi ikuti praktik keamanan terbaik: gunakan environment variables untuk secret dan jangan pernah hardcode; jalankan server sensitif secara lokal dengan transport stdio; batasi izin API key seminimal mungkin; tinjau kode server sebelum menyambungkan ke sistem sensitif; pertimbangkan menjalankan server di lingkungan terisolasi.