Anda dapat membuat agen AI menempatkan komentar ulasannya di dalam dokumen alih‑alih di obrolan. Server GroupDocs.Annotation.Mcp memungkinkan LLM di Claude, Cursor, atau GitHub Copilot menambahkan sorotan, catatan, dan coretan pada file PDF, Word, Excel, atau PowerPoint, dan menuliskannya secara lokal di mesin Anda:

Sorot klausul pembayaran pada halaman 2 dan tambahkan catatan meminta tim hukum untuk mengonfirmasi.

Versi langkah‑demi‑langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: How to annotate documents with AI agents using MCP.

Mengapa umpan balik AI di jendela obrolan hilang?

Minta asisten meninjau kontrak dan Anda akan mendapatkan daftar: “Klausul 4 mengalihkan tanggung jawab, klausul 7 memiliki tanggal terbuka.” Daftar itu berada dalam percakapan. Rekan yang membuka kontrak minggu depan tidak melihat apa‑apa, dan Anda harus menyalin setiap poin kembali ke paragraf yang tepat secara manual.

Agen bukanlah masalahnya. Agen tidak memiliki cara menulis ke dalam file. Sebuah tinjauan hanya berguna bila pembaca menemukannya, yaitu di sebelah teks yang dirujuk.

Seperti apa pendekatan yang salah?

Solusi sementara yang umum adalah menempelkan teks dokumen ke dalam obrolan dan meminta komentar. Tiga hal yang salah terjadi, dan Anda dapat memeriksanya pada dokumen Anda sendiri:

  • Komentar tidak memiliki posisi. “Halaman 2, paragraf kedua” hanyalah deskripsi yang harus Anda selesaikan sendiri.
  • Hasilnya berupa transkrip, bukan deliverable. Tidak ada yang dapat dikirim ke peninjau berikutnya kecuali screenshot atau blok yang ditempel.
  • Dokumen tidak berubah, sehingga tinjauan tidak dapat difilter, dihitung, atau dibawa ke draf berikutnya.

Apa pendekatan yang tepat: memberi anotasi dokumen dengan agen AI?

Bagi pekerjaan berdasarkan keunggulan masing‑masing. Agen memahami instruksi “tandai apa pun yang mengalihkan risiko kepada kami”. Mesin menulis anotasi nyata ke dalam file nyata. Alat yang melakukan penulisan adalah add_annotation. Ia menerima tujuh tipe anotasi: textfield, area, point, arrow, highlight, underline, dan strikeout. Argumennya adalah file, tipe, teks, nomor halaman berbasis 1, serta koordinat dokumen x/y.

Hasilnya disimpan sebagai <name>_annotated.<ext> di samping file asli Anda. File asli tidak pernah diubah. Panggilan yang sama bekerja pada lebih dari 50 format yang didukung mesin, sehingga draf Word dan PDF ditandai dengan cara yang sama.

Alat apa yang membuat penempatan tepat?

Koordinat adalah titik lemah bagi agen yang tidak dapat melihat halaman, dan dokumentasi menyebutkannya secara jelas. Tiga alat mengurangi tebakan:

  • get_document_info mengembalikan tipe file, jumlah halaman, dan ukuran, serta lebar‑tinggi per halaman bila mesin melaporkannya, sehingga agen memiliki kotak halaman untuk dipertimbangkan.
  • get_annotations mengembalikan anotasi yang sudah ada beserta kotak pembatasnya, yang dapat digunakan agen sebagai jangkar.
  • generate_pages_preview merender halaman menjadi gambar sehingga model yang memiliki kemampuan visi dapat menemukan teks sebelum memberi anotasi. Saat ini gagal untuk file PDF di Linux; lihat batasan di bawah.

Apa satu jebakan dalam anotasi berantai?

Setiap alat penulisan menyimpan file baru. Anotasi kedua harus diterapkan pada file yang dihasilkan panggilan pertama, bukan pada file asli, atau anotasi pertama akan tertinggal di file yang tidak lagi dibuka. Sebutkan dalam prompt:

Sorot klausul pembayaran, lalu pada file hasilnya coret tanggal pengiriman lama.

Sesi contoh (dipersingkat)

Ini adalah ilustrasi yang dibangun dari perilaku terdokumentasi alat‑alat, bukan tangkapan layar yang diambil.

You:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

Bagaimana cara memulai server anotasi di klien AI saya?

Untuk menjalankannya sebagai kontainer, pasang folder berisi dokumen Anda pada /data:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Jika Anda lebih memilih tidak menggunakan kontainer, instal .NET 10 SDK dan jalankan dnx GroupDocs.Annotation.Mcp --yes; di Windows ini juga merupakan saluran untuk pratinjau halaman PDF. Halaman hub memiliki cuplikan pendaftaran siap pakai untuk Claude Desktop, Claude Code, VS Code dengan GitHub Copilot, Cursor, Windsurf, dan klien lainnya. Atur GROUPDOCS_MCP_OUTPUT_PATH ke folder selain folder penyimpanan sebelum menumpuk edit pada file yang dihasilkan. Dengan default (output berada di folder penyimpanan) penulisan kedua gagal dengan being used by another process; dengan folder output terpisah add_reply, update_annotation, dan remove_annotations pada file yang dihasilkan semua berhasil. Dengan gambar Docker, berikan -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Setelah pendaftaran, klien meluncurkan server sendiri dan berkomunikasi lewat stdio, sehingga tidak ada yang mendengarkan pada port jaringan dan server tidak mengirimkan konten dokumen ke layanan cloud.

Batasan jujur

  • Mode evaluasi. Tanpa lisensi, badge percobaan ditempel di bagian atas setiap halaman, sehingga output yang dianotasi tidak dapat didistribusikan. Tanyakan “Apa status lisensi server anotasi?” terlebih dahulu; agen memanggil get_license_status.
  • Penempatan bersifat perkiraan tanpa bantuan. Agen yang menebak x/y dari prompt menempatkan anotasi area atau point secara perkiraan. Baca dulu atau render dulu untuk penempatan yang tepat.
  • Pratinjau di Linux. generate_pages_preview saat ini gagal untuk file PDF di Linux, termasuk gambar Docker (TypeInitializationException untuk Gdip: System.Drawing.Common tidak didukung pada platform non‑Windows); dokumen Word dan Office lainnya dapat dirender, dan di Windows dengan dnx semua format dapat dirender. Sepuluh alat lainnya tidak terpengaruh.

FAQ

Apakah Claude dapat menambahkan komentar ke PDF? Ya, melalui server MCP yang menyediakan alat anotasi. Dengan GroupDocs.Annotation.Mcp agen memanggil add_annotation dan komentar ditulis ke dalam <name>_annotated.pdf.

Apakah AI harus mengunggah dokumen saya untuk memberi anotasi? Tidak, tidak melalui server: ia membuka file di folder yang Anda mount dan menyimpan salinan yang dianotasi di sampingnya. Hanya apa yang dilihat model itu sendiri, seperti teks yang Anda tempel atau gambar halaman yang dilihat agen, yang dikirim ke penyedia model Anda.

Apakah ini bekerja pada Word dan Excel, bukan hanya PDF? Ya. Tipe anotasi yang sama berfungsi pada PDF, DOCX, XLSX, PPTX, dan gambar, dengan lebih dari 50 format yang tercantum dalam dokumentasi.

Mendalami