Apa itu MCP?

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

Kenapa pakai MCP?

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

Cara kerjanya

Server MCP mengekspos kapabilitas lewat protokol, menghubungkan Cursor ke tool atau sumber data eksternal. Cursor mendukung tiga metode transport:
TransportLingkungan eksekusiDeploymentPenggunaInputAuth
stdioLokalDikelola oleh CursorSatu penggunaPerintah shellManual
SSELokal/RemoteDeploy sebagai serverBanyak penggunaURL ke endpoint SSEOAuth
Streamable HTTPLokal/RemoteDeploy sebagai serverBanyak penggunaURL ke endpoint HTTPOAuth

Dukungan protokol

Cursor mendukung kapabilitas protokol MCP berikut:
FiturDukunganDeskripsi
ToolsDidukungFungsi yang dieksekusi oleh model AI
PromptsDidukungPesan dan workflow bertemplat untuk pengguna
RootsDidukungInkuiri yang diinisiasi server ke batas URI atau sistem berkas untuk ruang operasi
ElicitationDidukungPermintaan yang diinisiasi server untuk informasi tambahan dari pengguna

Menginstal server MCP

Instalasi sekali klik

Instal server MCP dari koleksi kami dan autentikasi via OAuth.

Menggunakan mcp.json

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

Menggunakan Extension API

Untuk pendaftaran server MCP secara programatis, Cursor menyediakan Extension API yang memungkinkan konfigurasi dinamis tanpa memodifikasi file mcp.json. Ini khususnya berguna untuk lingkungan enterprise dan alur kerja setup otomatis.

MCP Extension API Reference

Pelajari cara mendaftarkan server MCP secara programatis menggunakan vscode.cursor.mcp.registerServer()

Lokasi konfigurasi

Konfigurasi Proyek

Buat .cursor/mcp.json di proyekmu untuk tool khusus proyek.

Konfigurasi Global

Buat ~/.cursor/mcp.json di direktori home-mu untuk tool yang tersedia di mana saja.

Autentikasi

Server MCP memakai variabel lingkungan untuk autentikasi. Teruskan API key dan token lewat konfigurasi. Cursor mendukung OAuth untuk server yang membutuhkannya.

Menggunakan MCP di chat

Composer Agent otomatis memakai alat MCP yang tercantum di Available Tools saat relevan. Minta alat tertentu pakai namanya atau jelasin apa yang kamu butuh. Aktifkan atau nonaktifkan alat dari settings.

Mengaktifkan/nonaktifkan alat

Aktifkan atau nonaktifkan alat MCP langsung dari antarmuka chat. Klik nama alat di daftar alat untuk menyalakan/mematikan. Alat yang dinonaktifkan nggak bakal dimuat ke konteks atau tersedia buat Agent.

Persetujuan alat

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

Auto-run

Aktifkan auto-run biar Agent bisa pakai alat MCP tanpa minta izin dulu. Kerjanya mirip perintah terminal. Baca lebih lanjut tentang Yolo mode di sini.

Respons alat

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

Gambar sebagai konteks

Server MCP bisa ngembaliin gambar—screenshot, diagram, dll. Balikin sebagai string yang di-encode base64:
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ full base64 clipped for readability

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

Pertimbangan keamanan

Saat memasang server MCP, pertimbangkan praktik keamanan ini:
  • Verifikasi sumber: Hanya pasang server MCP dari developer dan repositori tepercaya
  • Tinjau izin: Periksa data dan API apa yang akan diakses server
  • Batasi kunci API: Gunakan kunci API dengan pembatasan dan izin seminimal mungkin
  • Audit kode: Untuk integrasi yang kritikal, tinjau kode sumber server
Ingat bahwa server MCP bisa mengakses layanan eksternal dan mengeksekusi kode atas nama kamu. Selalu pahami apa yang dilakukan server sebelum memasangnya.

Contoh di dunia nyata

Untuk contoh praktis MCP yang benar-benar digunakan, cek panduan Web Development yang menunjukkan cara mengintegrasikan Linear, Figma, dan tool browser ke dalam workflow pengembangan kamu.

FAQ