הסבר: סוכן AI צריך לבחור איזה קובץ להמיר ולאיזה פורמט, ומנוע ההמרה צריך לבצע את ההמרה. עם שרת GroupDocs.Conversion.Mcp, Claude, Cursor או GitHub Copilot קוראים למנוע הזה מקומית, במחשב שלכם, ממש משפט אחד:

Convert contract.docx to PDF

הגרסה המפורטת עם תצורה ופתרון בעיות נמצאת בתיעוד: How to convert documents with AI agents using MCP. פוסט זה מסביר מדוע הפיצול חשוב והיכן הסוכן צריך להישאר מחוץ לדרך.

מה קורה כשסוכן מנסה להמיר קובץ בעצמו?

מודל שפה שמנסה “להמיר” PDF ל‑Word בעצמו לא מבצע המרה אמיתית. הוא קורא את התוכן שניתן לו וכותב תוכן חדש בפורמט היעד. כל מה שהמודל לא ראה – הפונט המדויק, גאומטריית העמודות, שבירת העמוד לפני טבלה, שמות הסגנונות שתבנית Word תלויה בהם – אינו יכול לשחזר. מה שמתקבל נראה כמו המרה, אך הוא בעצם הקלדה מחדש.

זהו מצבי הכשל שהפוסט מתמקד בו. הוא שקט: הפלט נפתח ללא שגיאות, ולכן אף אחד לא בודק אותו עד שמתגלה שהטבלה זזה או שהכותרת איבדה את הסגנון שלה. דיוק ההצגה הוא עבודה של מנוע קבוע, לא של יצירת טקסט.

מה צריך הסוכן להחליט, ומה צריך המנוע לעשות?

חלקו את המשימה על קו ההפרדה בין שיפוט לביצוע.

שאלה הסוכן מחליט המנוע עושה
אילו קבצים נכללים בטווח? קורא את ההנחיה שלכם ואת תיקיית האחסון אין
איזה פורמט יעד? ממפה “הפוך לעריכה” ל‑DOCX, “שמור בארכיון” ל‑PDF אין
האם הקובץ ניתן להמרה? קורא get_supported_formats ומקבל את התשובה מדווח על פורמטים תקינים ליעד
מה גודל הקובץ? קורא get_document_info ומקבל את מספר העמודים קורא סוג, מספר עמודים, מאפיינים
ההמרה עצמה קורא convert מייצר את הפלט בעזרת מנוע GroupDocs.Conversion
מה לעשות במקרה של כשל מנסה שוב, שואל אתכם, או מדלג על הקובץ מחזיר את הסיבה כטקסט

הסוכן לעולם לא נוגע בבייטים של המסמך שלכם. הוא מעביר שם קובץ ופורמט, והמנוע מחזיר קובץ.

איך מחברים סוכן למנוע באופן מקומי?

רשמו את השרת פעם אחת בלקוח שלכם. Claude Desktop משתמש בקובץ claude_desktop_config.json, Claude Code משתמש ב‑claude mcp add, VS Code עם GitHub Copilot משתמש ב‑mcp.json, ו‑Cursor משתמש ב‑~/.cursor/mcp.json. השרת תומך גם ב‑Visual Studio 2022, Windsurf, Cline, Codex CLI ו‑JetBrains Rider. דוגמה לרשומת Claude Desktop:

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

dnx דורש את .NET 10 SDK. אם אתם מעדיפים Docker, התמונה העצמאית היא ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, מריצים אותה עם docker run --rm -i -v $(pwd)/documents:/data. הלקוח מתקשר עם השרת דרך stdio: הנתיב הוא סוכן → שרת מקומי → מערכת קבצים מקומית. הפעלת הלקוח מחדש אחרי הרישום נדרשת.

איזה כלי מופעל לכל בקשה?

השרת מציג ארבעה כלים. שמותיהם מילוליים; סוכנים מחפשים אותם כאשר משהו נתקע.

  • convert ממיר מסמך לפורמט אחר ושומר את התוצאה באחסון שלכם או בתיקיית הפלט. הוא מקבל file, format (לדוגמה pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) ו‑password אופציונלי.
  • get_supported_formats מציג את פורמטי היעד שהקובץ המקורי יכול להפוך אליהם.
  • get_document_info מחזיר סוג קובץ, מספר עמודים ומאפיינים בסיסיים ללא המרה.
  • get_license_status מדווח האם השרת פועל במצב הערכה, קובץ רישיון או מודל מדוד.

פרומפטים פתוחים עובדים מכיוון שהסוכן משלב אותם:

What formats can I turn this Visio file into? Then convert it to PDF.

Check the page count of whitepaper.pdf first, then convert it to DOCX.

קבצים קיימים לעולם לא נכתבים מחדש. המרה שנייה של אותו קובץ מקבלת שם ייחודי, כגון report (1).pdf.

דוגמת שיחה

זוהי שיחה מקוצרת, המחשה, שנבנתה מתיאורי הכלים בתיעוד, ולא צילומי מסך.

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.

ללולאה המלאה, המדריך ב‑n8n מציג את אותו מנוע המונע על‑ידי זרימת עבודה במקום צ׳אט, ו‑ההודעה מסבירה את השרת באופן כללי.

מה המגבלות?

  • מצב הערכה. ללא רישיון השרת מוסיף סימן מים של הערכה לפלט המומר ומגביל כל תהליך שרת ל‑15 מסמכים פתוחים; אתחול השרת מאפס את הספירה. שאלו את הסוכן שלכם “what is the license status of the conversion server?” תחילה; get_license_status משיב ללא עיבוד מסמך.
  • אין OCR. השרת ממיר מסמכים שיש להם שכבת טקסט. סריקה שנשמרת כ‑PDF תמונה‑בלבד לא תצא כטקסט שניתן לעריכה.
  • המרה, לא חילוץ. השרת הזה ממיר מסמכים שלמים. לחילוץ נתונים ברמת שדה, השרת המשלים GroupDocs.Parser.Mcp (זמין רק כתמונת Docker) הוא המתאים יותר, ורבים מהצינורות משתמשים בשניהם.

שאלות נפוצות

האם Claude יכול להמיר docx ל‑pdf?
כן, בתנאי שיש שרת המרה מחובר. Claude קורא convert עם format: "pdf", ומנוע GroupDocs מייצר את הקובץ במחשב שלכם.

האם הקבצים שלי מועלים כשסוכן ממיר אותם?
לא עם השרת הזה. הוא פועל מקומית דרך stdio, והמסמכים נשארים בתיקיית האחסון שלכם. קובץ הרישיון שלכם גם נקרא מהדיסק המקומי.

אילו פורמטים השרת יכול להמיר?
מעל 100 פורמטים של מסמכים, גיליונות, מצגות, תמונות, אימיילים, CAD ואתרי אינטרנט – בדיוק אותו סט של ספריית GroupDocs.Conversion ב‑.NET. שאלו get_supported_formats לקבלת הרשימה המדויקת עבור קובץ נתון.

עומק נוסף