​
Apa itu MCP?

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

​
Mengapa menggunakan MCP?

MCP menghubungkan Cursor ke sistem eksternal dan data. Alih-alih menjelaskan struktur proyek Anda berulang kali, integrasikan langsung dengan alat Anda. Tulis server MCP dalam bahasa apa pun yang dapat mencetak ke stdout atau melayani endpoint HTTP - Python, JavaScript, Go, dll.

​
Cara kerjanya

Server MCP mengekspos kemampuan melalui protokol, menghubungkan Cursor ke alat eksternal atau sumber data. Cursor mendukung tiga metode transport:
TransportLingkungan eksekusiDeploymentPenggunaInputAuth
stdioLokalCursor mengelolaPengguna tunggalPerintah shellManual
SSELokal/RemoteDeploy sebagai serverBeberapa penggunaURL ke endpoint SSEOAuth
Streamable HTTPLokal/RemoteDeploy sebagai serverBeberapa penggunaURL ke endpoint HTTPOAuth

​
Menginstal server MCP

​
Instalasi satu klik

Instal server MCP dari koleksi kami dan autentikasi dengan OAuth.

Jelajahi Alat MCP

Jelajahi server MCP yang tersedia

Tombol Tambahkan ke Cursor

Buat tombol “Tambahkan ke Cursor”

​
Menggunakan mcp.json

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

​
Lokasi konfigurasi

Konfigurasi Proyek

Buat .cursor/mcp.json di proyek Anda untuk alat khusus proyek.

Konfigurasi Global

Buat ~/.cursor/mcp.json di direktori home Anda untuk alat yang tersedia di mana saja.

​
Autentikasi

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

​
Menggunakan MCP dalam chat

Composer Agent secara otomatis menggunakan alat MCP yang terdaftar di bawah Available Tools ketika relevan. Minta alat tertentu berdasarkan nama atau jelaskan apa yang Anda butuhkan. Aktifkan atau nonaktifkan alat dari pengaturan.

​
Mengaktifkan/menonaktifkan alat

Aktifkan atau nonaktifkan alat MCP langsung dari antarmuka chat. Klik nama alat dalam daftar alat untuk mengaktifkan/menonaktifkannya. Alat yang dinonaktifkan tidak akan dimuat ke dalam konteks atau tersedia untuk Agent.

​
Persetujuan alat

Agent meminta persetujuan sebelum menggunakan alat MCP secara default. Klik panah di sebelah nama alat untuk melihat argumen.

​
Auto-run

Aktifkan auto-run agar Agent dapat menggunakan alat MCP tanpa bertanya. Bekerja seperti perintah terminal. Baca lebih lanjut tentang mode Yolo di sini.

​
Respons alat

Cursor menampilkan respons dalam chat dengan tampilan yang dapat diperluas untuk argumen dan respons:

​
Gambar sebagai konteks

Server MCP dapat mengembalikan gambar - screenshot, diagram, dll. Kembalikan sebagai string yang dikodekan base64: 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ base64 lengkap dipotong untuk keterbacaan

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

​
Pertimbangan keamanan

Saat menginstal server MCP, pertimbangkan praktik keamanan berikut:
  • Verifikasi sumber: Hanya instal server MCP dari pengembang dan repositori terpercaya
  • Tinjau izin: Periksa data dan API apa yang akan diakses oleh server
  • Batasi API keys: Gunakan API keys terbatas dengan izin minimal yang diperlukan
  • Audit kode: Untuk integrasi kritis, tinjau kode sumber server
Ingat bahwa server MCP dapat mengakses layanan eksternal dan menjalankan kode atas nama Anda. Selalu pahami apa yang dilakukan server sebelum instalasi.

​
Contoh dunia nyata

Untuk contoh praktis MCP dalam aksi, lihat panduan Pengembangan Web kami yang mendemonstrasikan integrasi Linear, Figma, dan alat browser ke dalam alur kerja pengembangan Anda.

​
FAQ