כל ארגון פועל על מסמכים — ועל הסקריפטים השבירים שמזיזים אותם בין פורמטים. דוחות Word הופכים ל‑PDF, גיליונות אלקטרוניים הופכים ל‑CSV, סריקות הופכות לקבצים שניתן לחפש בהם. כל פורמט או כלל חדש דורש כתיבת מחדש של צינור העבודה. יש דרך גמישה יותר: לתת ל‑סוכן AI לבצע את ההמרות, בתשתית שלכם, באמצעות הכלים שאתם מספקים. מאמר זה מראה כיצד לבנות בדיוק זאת עם n8n, פרוטוקול הקשר מודל (MCP), ושרת GroupDocs.Conversion MCP — תוך שמירה על המסמכים (ואופציונלית על מודל ה‑AI) כולו במקומות שלכם.

ממערכות קוד קבועות לאוטומציה סוכנית

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

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

מהו MCP ולמה הוא חשוב כאן

החלק הקשה של סוכנים המשתמשים בכלים תמיד היה אינטגרציה — כל סוכן מדבר עם כל כלי בצורה שונה. פרוטוקול הקשר מודל הוא תקן פתוח, ניטרלי למוכר, שמתקן זאת: כל סוכן תומך‑MCP יכול לגלות ולקרוא לכל יכולת של שרת MCP. אפשר לחשוב על זה כ‑“USB‑C לכלי AI”.

GroupDocs מפרסמת פעולות מסמכים כשרתים של MCP. שרת GroupDocs.Conversion חושף שלושה כלים שסוכן יכול לקרוא להם:

כלי מה הוא עושה
convert המרת מסמך לפורמט אחר (PDF, DOCX, XLSX, PPTX, HTML, PNG, CSV… יותר מ‑70 פורמטים)
get_document_info בחינת קובץ — סוג, מספר עמודים, מאפיינים — לפני פעולה
get_supported_formats גילוי אילו המרות אפשריות

מאחר שהוא מדבר MCP, הסוכן שלכם אינו זקוק לאינטגרציה מותאמת של GroupDocs. הוא רואה רק כלים.

הארכיטקטורה (קוד פתוח, הביאו את ה‑LLM שלכם)

שכבה רכיב תפקיד
תזמור n8n (מתארח בעצמכם) טריגרים, צומת סוכן AI, ניתוב קבצים
חשיבה ה‑LLM שלכם, דרך צומת מודל הצ’אט של n8n מחליט אילו כלים לקרוא — ניתן להחלפה מלאה
כלים GroupDocs.Conversion MCP (stdio) מאחורי supergateway convert, get_document_info, get_supported_formats
אחסון נפח Docker משותף איך קבצים זורמים פנימה והחוצה

בחירה מרכזית בתכנון: ה‑LLM ניתן לחיבור. צומת מודל הצ’אט של n8n אינו תלוי בספק, ולכן הסוכן וכלי MCP אינם משתנים כאשר מחליפים מודלים. הדוגמה למטה משתמשת ב‑OpenAI, אך אותה זרימת עבודה פועלת על Azure OpenAI, Anthropic, AWS Bedrock — או מודל מתארח בעצמכם (Ollama, vLLM) כאשר אתם זקוקים לפריסה מבודדת שבה המסמכים וה‑AI נשארים בתוך הרשת שלכם.

הערה אינטגרציה אחת: שרת Conversion MCP הוא שרת stdio קל משקל (הברירת מחדל המאובטחת, ללא רשת). מכיוון ש‑n8n מתחבר לכלי MCP דרך URL, גשר stdio‑to‑SSE פתוח‑קוד קטן (supergateway) חושף אותו על פורט. השרת עצמו אינו משתנה.

איך זרימת העבודה פועלת

  1. טריגר — webhook, אימייל נכנס, העלאת טופס, או תיקייה נצפית שמקבלת מסמך.
  2. שלב — n8n כותב את הקובץ לתיקיית האחסון המשותפת שה‑MCP server קורא ממנה.
  3. היגיון — סוכן AI של n8n (מודל הצ’אט שלכם + Conversion MCP ככלי) מקבל הוראה כמו “המר את report.docx ל‑PDF ודווח על מספר העמודים.” הוא קורא באופן אוטונומי ל‑get_document_info, ואז ל‑convert.
  4. מסירה — n8n לוקח את הקובץ המומר מהאחסון המשותף ומנתב אותו הלאה — אימייל, אחסון אובייקטים, SharePoint, או תגובה מקורית.

הסוכן בוחר את הכלים ואת הסדר. זה מה שמאפשר לזרימה אחת להתמודד עם “פשוט המר את זה”, “המר רק אם יש יותר מ‑10 עמודים”, או “המר וסכם”.

הרצה תוך דקות

מחסנית מינימלית היא שני שירותים שמשתפים נפח אחד — הממיר (מאחורי הגשר) ו‑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

לאחר מכן ב‑n8n, בנו את הסוכן בארבעה צמתים: Chat Trigger, Chat Model (אישור OpenAI שלכם), כלי MCP Client שמצביע ל‑http://conversion-mcp:8000/sse, ו‑AI Agent שמחבר אותם יחד. שימו קובץ ב‑./data, פתחו את הצ’אט ובקשו מהסוכן להמיר אותו.

ההגדרה המלאה, שניתן להריץ — docker-compose.yml, תמונת הגשר, וזרימת עבודה של n8n שניתן לייבא — נמצאת במאגר הקוד הפתוח המלווה (ראו למטה).

רישוי

בלי רישיון, GroupDocs.Conversion פועל במצב הערכת: הפלט מסומן במים והשימוש עשוי להיות מוגבל. עבור ייצור, הניחו קובץ GroupDocs.Total.lic בתיקיית הרישיון המותקנת — הפלט יהיה נקי וללא מגבלות. ניתן לבקש רישיון זמני כדי לנסות פלט מורשה.

למה זה מתאים לארגון

  • ריבונות נתונים — המסמכים ומנוע ההמרה נשארים בתשתית שלכם. בחרו מודל מתארח בעצמכם וה‑AI גם הוא יישאר שם.
  • ללא נעילה — כל שכבה היא קוד פתוח או מבוססת תקן (MCP). החליפו את ה‑LLM, את המתווך, או את הכלים בחופשיות.
  • אימות — כל החלטת סוכן וכל קריאת כלי ניתנות לצפייה ולחזרה בביצוע n8n.
  • קומפוזיציה — זהו היתרון המצטבר. הפנו את אותו סוכן לשרתים אחרים של GroupDocs MCP — Redaction, Watermark, Metadata — ובקשה בשפה טבעית אחת הופכת לצינור מלא: “הסתר את המידע האישי, המר ל‑PDF, ואז הוסף סימן מים ‘Confidential’.”

התחלה

  • הדגמה קוד פתוח מלווה: GroupDocs.Conversion.Agentic — שיבטו אותו, הוסיפו מפתח LLM שלכם, docker compose up, והתחילו לשוחח עם המסמכים שלכם.
  • NuGet: GroupDocs.Conversion.Mcp
  • תמונת Docker: ghcr.io/groupdocs-conversion/conversion-net-mcp
  • למידע נוסף על MCP: modelcontextprotocol.io

אוטומציה סוכנית של מסמכים איננה רעיון רחוק — היא רק docker compose up משם, בנויה מחלקים שניתן לקרוא, לארח ולסמוך עליהם. תנו לסוכני ה‑AI שלכם את היכולת להמיר מסמכים, לפי התנאים שלכם.