Bir AI ajanı, hangi dosyanın dönüştürüleceğini ve hangi formata dönüştürüleceğini seçmeli, dönüşüm motoru ise dönüştürmeyi yapmalıdır. GroupDocs.Conversion.Mcp sunucusuyla, Claude, Cursor veya GitHub Copilot bu motoru yerel olarak, makinenizde, tek bir cümleyle çağırır:

Convert contract.docx to PDF

Yapılandırma ve sorun giderme adımları belgelerde yer almaktadır: AI ajanlarıyla belgeleri dönüştürme: MCP kullanımı. Bu gönderi, bölünmenin neden önemli olduğunu ve ajanın nerede devre dışı bırakılması gerektiğini açıklar.

Bir ajan dosyayı kendisi dönüştürdüğünde neler ters gider?

PDF’yi Word’e “dönüştüren” bir dil modeli aslında hiçbir şey dönüştürmez. Kendisine verilen içeriği okur ve hedef formatta yeni içerik yazar. Modelin görmediği şeyleri yeniden üretemez: tam font, sütun geometrisi, bir tablo öncesindeki sayfa sonu, bir Word şablonunun bağımlı olduğu stil adları. Geri gelen şey bir dönüşüm gibi görünür ve aslında yeniden yazmadır.

Bu gönderinin ele aldığı hata modudur. Sessizdir: çıktı hatasız açılır, bu yüzden bir tablo kayana kadar ya da bir başlık stilini kaybedene kadar kimse kontrol etmez. Görüntüleme doğruluğu deterministik motor işi, üretim işi değildir.

Ajanın ne karar vermesi gerekir, motorun ne yapması gerekir?

İşi, karar verme ile yürütme arasındaki çizgide bölün.

Soru Ajan karar verir Motor yapar
Hangi dosyalar kapsam dahilinde? Promptunuzu ve depolama klasörünü okur Hiçbir şey
Hedef format hangisi? “make it editable” ifadesini DOCX’e, “archive it” ifadesini PDF’e eşler Hiçbir şey
Dosya dönüştürülebilir mi? get_supported_formats çağırır ve yanıtı okur Geçerli hedef formatları raporlar
Dosyanın boyutu ne kadar? get_document_info çağırır ve sayfa sayısını okur Tür, sayfa sayısı, özellikleri okur
Dönüşümün kendisi convert çağırır GroupDocs.Conversion motoru ile çıktıyı oluşturur
Başarısızlıkta ne yapılmalı Tekrar dener, size sorar veya dosyayı atlar Sebebi metin olarak döndürür

Ajan, belgenizin baytlarına asla dokunmaz. Bir dosya adı ve formatı iletir ve motor bir dosya döndürür.

Bir ajanı motorla yerel olarak nasıl bağlarsınız?

Sunucuyu istemcinizde bir kez kaydedin. Claude Desktop claude_desktop_config.json dosyasını, Claude Code claude mcp add komutunu, GitHub Copilot ile VS Code mcp.json dosyasını ve Cursor ~/.cursor/mcp.json dosyasını kullanır. Sunucu ayrıca Visual Studio 2022, Windsurf, Cline, Codex CLI ve JetBrains Rider’ı destekler. Bir Claude Desktop girdisi şu şekildedir:

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

dnx .NET 10 SDK’sına ihtiyaç duyar. Docker tercih ediyorsanız, bağımsız görüntü ghcr.io/groupdocs-conversion/conversion-net-mcp:latest‘dır, docker run --rm -i -v $(pwd)/documents:/data komutuyla çalıştırılır. İstemci, sunucu ile stdio üzerinden iletişim kurar: yol ajan, yerel sunucu, yerel dosya sistemi şeklindedir. Kaydettikten sonra istemciyi yeniden başlatın.

Her istek hangi aracı tetikler?

Sunucu dört araç sunar. İsimleri kelimesi kelimesine; bir şey bozulduğunda ajanlar onları arar.

  • convert bir belgeyi başka bir formata dönüştürür ve sonucu depolama ya da çıktı klasörünüzde kaydeder. file, format (örnek: pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) ve isteğe bağlı password alır.
  • get_supported_formats verilen bir kaynak dosyanın dönüşebileceği hedef formatları listeler.
  • get_document_info dönüştürme yapmadan dosya türünü, sayfa sayısını ve temel özellikleri döndürür.
  • get_license_status sunucunun değerlendirme, lisans dosyası ya da ölçümlü modda çalışıp çalışmadığını raporlar.

Açık uçlu istemler çalışır çünkü ajan bunları zincirler:

Bu Visio dosyasını hangi formatlara dönüştürebilirim? Sonra PDF’e dönüştür.

Önce whitepaper.pdf dosyasının sayfa sayısını kontrol et, ardından DOCX’e dönüştür.

Mevcut dosyalar asla üzerine yazılmaz. Aynı dosyanın ikinci dönüşümü report (1).pdf gibi ayrı bir ad alır.

Örnek oturum

Bu, belgelerdeki araç açıklamalarından oluşturulmuş kısaltılmış, örnek bir oturumdur, ekran görüntüsü değildir.

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.

Tam döngü için, n8n kılavuzu aynı motorun sohbet yerine bir iş akışıyla çalıştırıldığını gösterir ve duyuru sunucuyu genel olarak kapsar.

Sınırlamalar nelerdir?

  • Değerlendirme modu. Lisans olmadan sunucu, dönüştürülmüş çıktıya bir değerlendirme filigranı ekler ve her sunucu sürecinde en fazla 15 açık belge sınırı koyar; sunucuyu yeniden başlatmak sayacı sıfırlar. Ajanınıza önce “dönüşüm sunucusunun lisans durumu nedir?” sorun; get_license_status belge işlemeye girmeden yanıt verir.
  • OCR yok. Sunucu, metin katmanı olan belgeleri dönüştürür. Sadece görüntü içeren bir PDF olarak kaydedilmiş tarama, düzenlenebilir metin olarak çıkmaz.
  • Dönüşüm, çıkarma değil. Bu sunucu bütün belgeleri dönüştürür. Alan düzeyinde veri çıkarımı için, eşlik eden GroupDocs.Parser.Mcp sunucusu (yalnızca Docker görüntüsü olarak sunulur) daha uygundur ve birçok işlem hattı her ikisini de kullanır.

SSS

Claude bir docx dosyasını pdf’e dönüştürebilir mi?
Evet, bir dönüşüm sunucusu eklendiğinde. Claude, format: "pdf" ile convert komutunu çağırır ve GroupDocs motoru dosyayı makinenizde üretir.

Bir ajan dosyalarımı dönüştürürken yüklenir mi?
Bu sunucu ile değil. Sunucu stdio üzerinden yerel olarak çalışır ve belgeler depolama klasörünüzde kalır. Lisans dosyanız da yerel diskinizden okunur.

Sunucu hangi formatları dönüştürebilir?
100’den fazla belge, elektronik tablo, sunum, görüntü, e-posta, CAD ve web formatı, GroupDocs.Conversion .NET kütüphanesiyle aynı settir. Belirli bir dosya için tam listeyi get_supported_formats ile sorabilirsiniz.

Daha derine in