Kenapa dokumentasi itu penting

Dokumentasi menyediakan konteks yang terbaru dan akurat. Tanpanya, model bakal mengandalkan data pelatihan yang usang atau tidak lengkap. Dokumentasi membantu model memahami hal-hal seperti:
  • API dan parameter terbaru
  • Praktik terbaik
  • Konvensi organisasi
  • Terminologi domain
Dan masih banyak lagi. Baca terus buat tahu cara pakai dokumentasi langsung di Cursor tanpa perlu pindah konteks.

Batas pengetahuan model

Large language models dilatih pada data hingga titik waktu tertentu, yang disebut “knowledge cutoff.” Artinya:
  • Pembaruan library terbaru mungkin belum tercakup
  • Framework atau tool baru mungkin belum dikenal
  • Perubahan API setelah tanggal cutoff bisa terlewat
  • Best practice mungkin sudah berubah sejak pelatihan
Misalnya, kalau knowledge cutoff sebuah model ada di awal 2024, model itu nggak akan tahu fitur yang dirilis pada akhir 2024, bahkan untuk framework populer.

Harus pakai alat yang mana?

Gunakan pohon keputusan ini untuk cepat menentukan pendekatan terbaik buat kebutuhan dokumentasimu:

Model mental

ToolModel mental
@DocsMirip menjelajah dan membaca dokumentasi resmi
@WebMirip mencari solusi di internet
MCPMirip mengakses dokumentasi internal kamu

Dokumentasi publik

Dokumentasi eksternal mencakup informasi yang tersedia untuk umum yang mungkin hanya diketahui model secara terbatas atau sudah kedaluwarsa. Cursor menyediakan dua cara utama buat ngakses informasi ini.

Menggunakan @Docs

@Docs menghubungkan Cursor ke dokumentasi resmi dari tool dan framework populer. Pakai ini saat kamu butuh informasi terbaru dan otoritatif tentang:
  • Referensi API: Signature fungsi, parameter, tipe return
  • Panduan memulai: Setup, konfigurasi, penggunaan dasar
  • Praktik terbaik: Pola yang direkomendasikan dari sumber resmi
  • Debugging khusus framework: Panduan troubleshooting resmi
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
Agent⌘I
Auto

Menggunakan @Web

@Web menelusuri internet secara real-time untuk info terbaru, postingan blog, dan diskusi komunitas. Pakai ini ketika kamu butuh:
  • Tutorial terbaru: Konten dan contoh dari komunitas
  • Perbandingan: Artikel yang membandingkan berbagai pendekatan
  • Update terkini: Update atau pengumuman yang sangat baru
  • Beragam perspektif: Berbagai pendekatan untuk sebuah masalah
@
@Web latest performance optimizations for React 19
Agent⌘I
Auto

Dokumentasi internal

Dokumentasi internal mencakup informasi khusus untuk organisasimu yang tidak pernah ditemui model AI selama pelatihan. Ini bisa berupa:
  • API internal: Layanan kustom dan microservices
  • Standar perusahaan: Konvensi penulisan kode, pola arsitektur
  • Sistem proprietari: Alat kustom, basis data, alur kerja
  • Pengetahuan domain: Logika bisnis, persyaratan kepatuhan

Mengakses dokumen internal dengan MCP

Model Context Protocol (MCP) menyediakan cara standar buat membawa dokumentasi dan sistem privat kamu ke Cursor. MCP jadi lapisan tipis antara Cursor dan resource internal kamu. Kenapa MCP penting:
  • Model nggak bisa menebak konvensi internal kamu
  • Dokumentasi API untuk layanan kustom nggak tersedia untuk publik
  • Business logic dan pengetahuan domain itu unik untuk organisasi kamu
  • Kebutuhan compliance dan keamanan beda-beda di tiap perusahaan

Integrasi MCP yang umum

IntegrasiAksesContoh
ConfluenceSpace Confluence perusahaanDokumentasi arsitektur, spesifikasi API untuk layanan internal, standar dan pedoman penulisan kode, dokumentasi proses
Google DriveDokumen dan folder bersamaDokumen spesifikasi, catatan rapat dan keputusan, dokumen desain dan requirement, basis pengetahuan tim
NotionDatabase dan halaman workspaceDokumentasi proyek, wiki tim, basis pengetahuan, product requirements, spesifikasi teknis
CustomSistem dan database internalAPI proprietary, sistem dokumentasi legacy, basis pengetahuan kustom, tools dan workflow khusus

Solusi kustom

Untuk kebutuhan yang unik, kamu bisa bikin server MCP kustom yang:
  • Scrape website atau portal internal
  • Terhubung ke database proprietary
  • Akses sistem dokumentasi kustom
  • Tarik data dari wiki internal atau basis pengetahuan
Kalau kamu bikin server MCP kustom, kamu juga bisa ngekspos tools biar Cursor bisa memperbarui dokumentasi
Contoh server MCP kustom untuk scraping dokumen internal:
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import TurndownService from "turndown";

// Create an MCP server for scraping internal docs
const server = new McpServer({
  name: "internal-docs",
  version: "1.0.0"
});

const turndownService = new TurndownService();

// Add tool to scrape internal documentation
server.tool("get_doc",
  { url: z.string() },
  async ({ url }) => {
    try {
      const response = await fetch(url);
      const html = await response.text();
      
      // Convert HTML to markdown
      const markdown = turndownService.turndown(html);
      
      return {
        content: [{ type: "text", text: markdown }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error scraping ${url}: ${error.message}` }]
      };
    }
  }
);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);

Menjaga dokumentasi tetap mutakhir

Dokumentasi cepat usang. Cursor bisa bantu kamu menjaga dokumentasi yang selalu mutakhir dan berguna dengan membuat serta memperbaruinya berdasarkan kode kamu yang sebenarnya dan percakapan pengembangan kamu.

Dari kode yang sudah ada

Gunakan Cursor buat bikin dokumentasi langsung dari codebase lo:
@
Generate API documentation for this Express router, including all endpoints, parameters, and response formats
Agent⌘I
Auto

Dari sesi chat

Percakapan lo dengan Cursor berisi intent berharga yang bisa diubah jadi dokumentasi.
Setelah nyelesaiin masalah kompleks:
@
Rangkum obrolan kita tentang nyiapin autentikasi jadi panduan langkah demi langkah buat wiki tim
Agent⌘I
Auto

Ringkasan

  • Dokumentasi sebagai konteks bikin Cursor lebih akurat dan tetap terbaru
  • Pakai @Docs untuk dokumentasi resmi dan @Web untuk pengetahuan dari komunitas
  • MCP menjembatani celah antara Cursor dan sistem internal kamu
  • Hasilkan dokumentasi dari kode dan percakapan biar pengetahuan tetap terbaru
  • Gabungkan sumber dokumentasi eksternal dan internal untuk pemahaman yang menyeluruh