An AI agent should choose which file to convert and which format to convert it to, and a conversion engine should do the converting. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot call that engine locally, on your machine, from one sentence:

Convert contract.docx to PDF

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengonversi dokumen dengan agen AI menggunakan MCP. Postingan ini menjelaskan mengapa pemisahan penting dan di mana agen seharusnya tidak terlibat.

Apa yang salah ketika agen mengonversi file sendiri?

Model bahasa yang “mengonversi” PDF ke Word tidak melakukan konversi apa pun. Ia membaca konten yang diberikan dan menulis konten baru dalam format target. Apa pun yang tidak dilihat model, tidak dapat direproduksi: font yang tepat, geometri kolom, pemisah halaman sebelum tabel, nama gaya yang bergantung pada templat Word. Hasil yang kembali tampak seperti konversi tetapi sebenarnya pengetikan ulang.

Itulah mode kegagalan yang dibahas dalam postingan ini. Masalahnya tidak terlihat: output terbuka tanpa error, sehingga tidak ada yang memeriksanya sampai sebuah tabel bergeser atau judul kehilangan gaya. Kesetiaan rendering adalah kerja mesin yang deterministik, bukan kerja generasi.

Apa yang harus diputuskan agen, dan apa yang harus dilakukan mesin?

Pemisahan pekerjaan di antara penilaian dan pelaksanaan.

Pertanyaan Agen memutuskan Mesin melakukan
File mana yang termasuk dalam ruang lingkup? Membaca prompt Anda dan folder penyimpanan Tidak ada
Format target apa? Menerjemahkan “buat dapat diedit” menjadi DOCX, “arsipkan” menjadi PDF Tidak ada
Apakah file dapat dikonversi? Memanggil get_supported_formats dan membaca jawabannya Melaporkan format target yang valid
Seberapa besar file? Memanggil get_document_info dan membaca jumlah halaman Membaca tipe, jumlah halaman, properti
Konversi itu sendiri Memanggil convert Menyajikan output dengan mesin GroupDocs.Conversion
Apa yang harus dilakukan saat gagal Mencoba lagi, menanyakan Anda, atau melewatkan file Mengembalikan alasan sebagai teks

Agen tidak pernah menyentuh byte dokumen Anda. Ia hanya mengirimkan nama file dan format, dan mesin mengembalikan file.

Bagaimana cara menghubungkan agen ke mesin secara lokal?

Daftarkan server sekali di klien Anda. Claude Desktop menggunakan claude_desktop_config.json, Claude Code menggunakan claude mcp add, VS Code dengan GitHub Copilot menggunakan mcp.json, dan Cursor menggunakan ~/.cursor/mcp.json. Server juga mendukung Visual Studio 2022, Windsurf, Cline, Codex CLI, dan JetBrains Rider. Entri Claude Desktop terlihat seperti ini:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx membutuhkan .NET 10 SDK. Jika Anda lebih suka Docker, image yang berdiri sendiri adalah ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, jalankan dengan docker run --rm -i -v $(pwd)/documents:/data di depannya. Klien berkomunikasi dengan server melalui stdio: jalurnya adalah agen, server lokal, sistem file lokal. Mulai ulang klien setelah mendaftar.

Alat mana yang dipicu oleh setiap permintaan?

Server menyediakan empat alat. Nama mereka literal; agen mencari alat tersebut ketika ada yang tidak beres.

  • convert mengonversi dokumen ke format lain dan menyimpan hasilnya di folder penyimpanan atau output Anda. Ia menerima file, format (misalnya pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) dan opsional password.
  • get_supported_formats menampilkan daftar format target yang dapat dihasilkan dari file sumber tertentu.
  • get_document_info mengembalikan tipe file, jumlah halaman, dan properti dasar tanpa melakukan konversi.
  • get_license_status melaporkan apakah server berjalan dalam mode evaluasi, file lisensi, atau mode bermeter.

Prompt terbuka berfungsi karena agen menautkannya:

Format apa yang dapat saya ubah file Visio ini? Lalu konversi ke PDF.

Periksa jumlah halaman whitepaper.pdf terlebih dahulu, lalu konversi ke DOCX.

File yang ada tidak pernah ditimpa. Konversi kedua dari file yang sama akan mendapatkan nama yang berbeda, seperti report (1).pdf.

Contoh sesi

Berikut ini sesi singkat yang ilustratif yang dibangun dari deskripsi alat dalam dokumentasi, bukan tangkapan layar.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Untuk alur lengkap, panduan n8n menunjukkan mesin yang sama dijalankan oleh alur kerja alih-alih obrolan, dan pengumuman membahas server secara umum.

Apa saja batasannya?

  • Evaluation mode. Tanpa lisensi server menambahkan watermark evaluasi pada output yang dikonversi dan membatasi setiap proses server pada 15 dokumen yang terbuka; memulai ulang server mengatur ulang hitungan. Tanyakan kepada agen Anda “apa status lisensi server konversi?” terlebih dahulu; get_license_status menjawab tanpa memproses dokumen.
  • Tidak ada OCR. Server mengonversi dokumen yang memiliki lapisan teks. Pemindaian yang disimpan sebagai PDF hanya gambar tidak akan menjadi teks yang dapat diedit.
  • Konversi, bukan ekstraksi. Server ini mengubah seluruh dokumen. Untuk ekstraksi data tingkat bidang, server pendamping GroupDocs.Parser.Mcp (disediakan hanya sebagai image Docker) lebih cocok, dan banyak pipeline menggunakan keduanya.

FAQ

Apakah Claude dapat mengonversi docx ke pdf?
Ya, dengan server konversi yang terhubung. Claude memanggil convert dengan format: "pdf", dan mesin GroupDocs menghasilkan file di mesin Anda.

Apakah file saya diunggah ketika agen mengonversinya?
Tidak dengan server ini. Ia berjalan secara lokal melalui stdio, dan dokumen tetap berada di folder penyimpanan Anda. File lisensi Anda juga dibaca dari disk lokal.

Format apa yang dapat dikonversi server?
Lebih dari 100 format dokumen, spreadsheet, presentasi, gambar, email, CAD, dan web, sama seperti set pada pustaka GroupDocs.Conversion .NET. Tanyakan get_supported_formats untuk daftar tepatnya bagi file tertentu.

Selami Lebih Dalam