Setiap organisasi berjalan pada dokumen — dan pada skrip rapuh yang memindahkannya antar format. Laporan Word menjadi PDF, spreadsheet menjadi CSV, pemindaian menjadi file yang dapat dicari. Setiap format atau aturan baru berarti menulis ulang pipeline. Ada cara yang lebih fleksibel: biarkan agen AI melakukan konversi, di infrastruktur Anda sendiri, menggunakan alat yang Anda berikan. Artikel ini menunjukkan cara membangun tepat itu dengan n8n, Model Context Protocol (MCP), dan GroupDocs.Conversion MCP server — menjaga dokumen Anda (dan opsional model AI Anda) sepenuhnya di‑premise.

Dari pipeline yang dikodekan keras ke otomatisasi berbasis agen

Otomatisasi tradisional mengkodekan bagaimana sebuah tugas dilakukan: deteksi tipe file, cabang, panggil konverter, tangani error, tulis output. Setiap kebutuhan baru adalah perubahan kode.

Workflow agenik mengkodekan apa yang Anda inginkan. Anda menyatakan tujuan — “konversi laporan ini ke PDF, tapi periksa jumlah halaman dulu” — dan mengekspos sekumpulan alat. Agen AI memutuskan alat mana yang dipanggil dan dalam urutan apa, serta menyesuaikan diri dengan hasilnya. Tambahkan sebuah alat dan agen dapat langsung menggunakannya, tanpa pengkabelan ulang. Adaptabilitas itulah inti dari semuanya.

Apa itu MCP, dan mengapa penting di sini

Bagian sulit dari agen yang menggunakan alat selalu terletak pada integrasi — setiap agen berbicara dengan setiap alat secara berbeda. Model Context Protocol adalah standar terbuka yang netral vendor yang memperbaiki hal ini: agen yang mendukung MCP dapat menemukan dan memanggil kemampuan server MCP mana pun. Anggap saja ini sebagai “USB‑C untuk alat AI”.

GroupDocs menerbitkan operasi dokumen sebagai server MCP. Server GroupDocs.Conversion mengekspos tiga alat yang dapat dipanggil agen:

Alat Apa yang dilakukannya
convert Mengonversi dokumen ke format lain (PDF, DOCX, XLSX, PPTX, HTML, PNG, CSV… lebih dari 70 format)
get_document_info Memeriksa file — tipe, jumlah halaman, properti — sebelum melakukan aksi
get_supported_formats Menemukan konversi apa saja yang memungkinkan

Karena berbicara MCP, agen Anda tidak memerlukan integrasi khusus GroupDocs. Ia hanya melihat alat‑alat tersebut.

Arsitektur (semua sumber terbuka, bawa LLM Anda sendiri)

Lapisan Komponen Peran
Orkestrasi n8n (self‑hosted) pemicu, node AI Agent, routing file
Penalaran LLM Anda, via node Chat Model n8n memutuskan alat mana yang dipanggil — sepenuhnya dapat ditukar
Alat GroupDocs.Conversion MCP (stdio) di belakang supergateway convert, get_document_info, get_supported_formats
Penyimpanan volume Docker bersama cara file mengalir masuk dan keluar

Pilihan desain kunci: LLM dapat dipasang. Node Chat Model n8n bersifat provider‑agnostic, sehingga agen dan alat MCP tidak berubah ketika Anda menukar model. Contoh di bawah menggunakan OpenAI, tetapi workflow yang sama berjalan di Azure OpenAI, Anthropic, AWS Bedrock — atau model yang sepenuhnya self‑hosted (Ollama, vLLM) ketika Anda memerlukan deployment yang terisolasi di mana dokumen dan AI tetap berada di dalam jaringan Anda.

Catatan integrasi: Conversion MCP adalah server stdio ringan (default aman, tanpa jaringan). Karena n8n terhubung ke alat MCP melalui URL, sebuah jembatan stdio‑to‑SSE sumber terbuka kecil (supergateway) mengekspornya pada sebuah port. Server itu sendiri tidak berubah.

Cara kerja workflow

  1. Pemicu — webhook, email masuk, unggahan formulir, atau folder yang dipantau menerima dokumen.
  2. Tahap — n8n menulis file ke folder penyimpanan bersama yang dibaca server MCP.
  3. Alasan — AI Agent n8n (Chat Model Anda + Conversion MCP sebagai alat) menerima instruksi seperti “Konversi report.docx ke PDF dan laporkan jumlah halaman.” Ia secara mandiri memanggil get_document_info, lalu convert.
  4. Pengiriman — n8n mengambil file yang telah dikonversi dari penyimpanan bersama dan mengarahkannya lebih lanjut — email, object storage, SharePoint, atau respons asli.

Agen memilih alat dan urutannya. Inilah yang memungkinkan satu workflow menangani “hanya konversi ini,” “konversi hanya jika lebih dari 10 halaman,” atau “konversi dan rangkum.”

Siapkan dalam hitungan menit

Stack minimal adalah dua layanan yang berbagi satu volume — konverter (di belakang jembatan) dan n8n:

services:
  conversion-mcp:                    # GroupDocs.Conversion MCP, exposed over SSE
    build: ./bridge                  # supergateway --stdio "groupdocs-conversion-mcp" --port 8000
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    volumes: [ ./data:/data, ./gd-license:/license:ro ]
  n8n:
    image: n8nio/n8n:latest
    ports: ["5678:5678"]
    volumes: [ ./data:/data ]        # SAME folder — the file hand‑off

Kemudian di n8n, bangun agen dengan empat node: Chat Trigger, Chat Model (kredensial OpenAI Anda), alat MCP Client yang mengarah ke http://conversion-mcp:8000/sse, dan AI Agent yang menghubungkannya. Letakkan file di ./data, buka chat, dan minta agen mengonversinya.

Setup lengkap yang dapat dijalankan — docker-compose.yml, image bridge, dan workflow n8n yang dapat di‑import — ada di repositori sumber terbuka pendamping (lihat di bawah).

Lisensi

Tanpa lisensi, GroupDocs.Conversion berjalan dalam mode evaluasi: output ber‑watermark dan penggunaan mungkin dibatasi. Untuk produksi, letakkan file GroupDocs.Total.lic ke dalam folder lisensi yang dipasang — output kemudian bersih dan tidak terbatas. Anda dapat request a temporary license untuk mencoba output berlisensi.

Mengapa ini cocok untuk perusahaan

  • Kedaulatan data — dokumen dan mesin konversi tetap di infrastruktur Anda. Pilih model yang di‑host sendiri dan AI juga begitu.
  • Tanpa lock‑in — setiap lapisan bersifat sumber terbuka atau berbasis standar (MCP). Tukar LLM, orkestrator, atau alat sesuka hati.
  • Auditabilitas — setiap keputusan agen dan pemanggilan alat terlihat, dapat diputar ulang sebagai eksekusi n8n.
  • Komposabilitas — inilah manfaat berlipat ganda. Arahkan agen yang sama ke server MCP GroupDocs lainnya — Redaction, Watermark, Metadata — dan satu permintaan bahasa alami menjadi pipeline lengkap: “redact the PII, convert to PDF, then watermark it ‘Confidential’.”

Mulai

  • Demo sumber terbuka pendamping: GroupDocs.Conversion.Agentic — clone, tambahkan kunci LLM Anda, docker compose up, dan mulailah berbicara dengan dokumen Anda.
  • NuGet: GroupDocs.Conversion.Mcp
  • Docker image: ghcr.io/groupdocs-conversion/conversion-net-mcp
  • Pelajari lebih lanjut tentang MCP: modelcontextprotocol.io

Otomatisasi dokumen berbasis agen bukanlah ide yang jauh — ia hanya sejauh docker compose up, dibangun dari komponen yang dapat Anda baca, host, dan percayai. Berikan agen AI Anda kemampuan mengonversi dokumen, dengan syarat Anda.