🔌 פרק 9

שרת MCP מובנה וחיבור לקלוד קוד

n8n כולל שרת MCP מובנה ברמת המופע, המאפשר ללקוחות נתמכים (כגון Lovable, Claude Desktop, Claude Code, Codex, ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf וסוכני Google ADK) להתחבר בצורה מאובטחת, לחפש תהליכים, לבצע אינטראקציה עם תהליכים שסומנו כזמינים ב-MCP, להפעיל ולבדוק תהליכים חשופים, וליצור ולערוך תהליכים וטבלאות נתונים (Data Tables). אם תכונת הסוכנים פעילה, הלקוחות יכולים גם לנהל סוכנים (Agents). בנוסף נחשפים כלים להעדפות משתמש (user preferences).

היכולת הבסיסית זהה לענן. בהתקנה עצמית נוספים ניהול ממשתני סביבה, עבודה מקומית ב-localhost, והגדרות פרוקסי.

לפי התיעוד הרשמי, תמיכה ביכולות ה-MCP נפרסת על פני הגרסאות הבאות:

שיקולים מרכזיים בשימוש בגישת MCP ברמת המופע:

• MCP תומך בשני סוגי אינטראקציה עם תהליכים: הרצת תהליכים קיימים באמצעות כלי הרצת תהליכים, ובנייה או עריכה של תהליכים (זמין החל מ-2.13.0).
• הגישה אינה מספקת חשיפה גורפת לכל התהליכים במופע. יש להפעיל את ה-MCP ברמת המופע ולאחר מכן להפעיל כל תהליך בנפרד. החריג היחיד הוא search_workflows, שיכול לגשת לכל תהליך שלמשתמש הנוכחי יש הרשאה לצפות בו, אך מחזיר תצוגות מקדימות בלבד ולא נתוני תהליך מלאים.
• החשיפה אינה מוגבלת לפי לקוח MCP בודד. כל הלקוחות שתחברו (לדוגמה Claude Desktop ו-ChatGPT) יכולים לראות את כל התהליכים שהפעלתם לגישת MCP. לא ניתן להגביל תהליכים מסוימים ללקוחות מסוימים. ברמת המשתמש, הראות נשמרת לפי הרשאות המשתמש: משתמשים יכולים לראות רק תהליכים שהופעלו ב-MCP שיש להם גישה אליהם.
• רוב כלי ה-MCP פועלים על תהליכים שאינם מפורסמים. החריג הוא execute_workflow, אשר כברירת מחדל פועל במצב ייצור ומריץ את הגרסה המפורסמת של התהליך. הוא תומך גם במצב הרצה ידני (manual) להרצת הגרסה הנוכחית שטרם פורסמה.

#הפעלה בממשק

מבנה ההגדרות המחולק לשלושה אזורים (Connection details, Access, Connected clients), הדיאלוג Connect a client, והגדרת Allowed callback URLs זמינים החל מגרסה 2.33.0 ומחליפים את מסך הגדרות ה-MCP הקודם. בגרסאות ישנות יותר מוצג מסך פשוט יותר ללא שלבי הגדרה לפי לקוח.

הפעלת גישת ה-MCP דורשת הרשאות בעלים (owner) או מנהל (admin) במופע (בענן ובהתקנה עצמית):

1. נווט אל Settings > Instance-level MCP.
2. בחר Enable MCP access (דורש הרשאות owner או admin במופע).

לאחר ההפעלה, עמוד ההגדרות מחולק לשלושה אזורים:

• Connection details: מציג את סטטוס ה-MCP (MCP status) וכפתור Connect הפותח שלבי הגדרה עבור לקוח ה-MCP שלך.
• Access: מציג כמה תהליכים (ואם התכונה קיימת במופע שלך, כמה סוכנים) חשופים ללקוחות MCP. מנהלים ובעלי מופע רואים כאן גם את הגדרת Allowed callback URLs.
• Connected clients: מציג תצוגה מקדימה של עד שלושה מהלקוחות המחוברים שלך ואת ההרשאות שלהם, ומציג כמה לקוחות מחזיקים בגישה כרגע. בוחרים לקוח כדי לפתוח את פרטיו, או Revoke access כדי לבטל את גישתו. בחירה ב-View all פותחת את האפשרות לבדוק או לבטל גישה עבור לקוחות בודדים.

חיבור לקוח צ'אט (כגון Claude Desktop) והעתקת כתובת השרת:

1. הפעל גישת MCP במופע לפי השלבים שלמעלה.
2. העתק את ה-Server URL מתוך Settings > Instance-level MCP > Connect a client. הכתובת מסתיימת ב-/mcp-server/http.
3. הדבק אותה בלקוח שלך.

במופע מקומי הכתובת היא בדרך כלל:

http://localhost:5678/mcp-server/http

בשרת עם דומיין ו-HTTPS:

https://n8n.example.com/mcp-server/http

מלכודת: לא מדביקים את כתובת העורך הרגילה ללא הנתיב /mcp-server/http.

כיבוי הגישה בממשק: באזור Connection details, פתח את פקד MCP status ובחר Disable. n8n מבקש אישור, מכיוון שהשבתה מנתקת מיידית כל לקוח מחובר ומבטלת את גישתו. ניתן להפעיל מחדש מאוחר יותר.

#הפעלה ממשתני סביבה

בהתקנה עצמית, החל מגרסה 2.20.0, ניתן לנהל את הגדרות ה-MCP ברמת המופע דרך משתני סביבה:

export N8N_MCP_MANAGED_BY_ENV=true
export N8N_MCP_ACCESS_ENABLED=true

מלכודת: למשתנה N8N_MCP_ACCESS_ENABLED אין כל השפעה אלא אם N8N_MCP_MANAGED_BY_ENV מוגדר כ-true. כאשר ניהול הסביבה פעיל, פקדי הממשק נעולים לקריאה בלבד, כולל המתג לחשיפה אוטומטית של תהליכים חדשים.

השבתה מלאה של היכולת בהתקנה עצמית (Complete disablement): כדי להסיר את התכונה לחלוטין, הגדר את משתנה הסביבה:

export N8N_DISABLED_MODULES=mcp

פעולה זו מסירה את נקודות הקצה של ה-MCP ומסתירה את כל רכיבי הממשק הקשורים.

#חיבור קלוד קוד על אותו מחשב

שלבי חיבור מותאמים לפי לקוח זמינים החל מגרסה 2.33.0. גרסאות ישנות יותר אינן מציגות שלבים אלה. באזור Connection details, לחיצה על כפתור Connect פותחת את דיאלוג Connect a client, שבו ניתן לבחור שיטת אימות: OAuth (מומלץ) או API key.

חיבור באמצעות OAuth (מומלץ):

1. נווט אל Settings > Instance-level MCP.
2. באזור Connection details, בחר Connect כדי לפתוח את דיאלוג Connect a client.
3. ודא שאתה בלשונית OAuth (recommended).
4. בתפריט הנפתח Your client, בחר את העוזר, ה-IDE או ה-CLI שלך. n8n מקבץ לקוחות לקטגוריות CLI (כגון Claude Code, Codex, Gemini CLI), Web (כגון Claude.ai, ChatGPT, Mistral Vibe) ו-IDE (כגון Cursor, VS Code, Windsurf), ומציג שלבי הגדרה מותאמים לבחירתך.
5. בצע את השלבים המוצגים לסוג הלקוח שלך:
   • לקוחות Web: בחר One-click setup כדי להוסיף את n8n ישירות ללקוח, או העתק את Server URL והדבק בהגדרות המחבר של הלקוח בעצמך.
   • לקוחות CLI: הרץ את פקודת ההתקנה המוצגת, או הוסף את מקטע ההגדרה הידני לקובץ התצורה של הלקוח. בשני המקרים, סיים בשלב Authenticate להשלמת כניסת ה-OAuth.
   • לקוחות IDE: בחר בקישור ההתקנה בלחיצה אחת (במקומות שבהם העורך תומך בכך), או העתק את Server URL והוסף את מקטע ההגדרה הידני לעורך בעצמך.
6. כאשר הלקוח מפנה אותך אל n8n, אשר את הגישה לסיום החיבור.

פקודת ה-CLI עבור Claude Code בחיבור HTTP מקומי:

claude mcp add --transport http n8n http://localhost:5678/mcp-server/http

אם המופע ב-HTTPS:

claude mcp add --transport http n8n https://n8n.example.com/mcp-server/http

לחלופין, הוספת מקטע הגדרה לקובץ claude.json:

{
  "mcpServers": {
    "n8n": {
      "type": "http",
      "url": "http://localhost:5678/mcp-server/http"
    }
  }
}

להשלמת החיבור: הריצו /mcp בתוך Claude Code, בחרו ב-n8n, ובצעו אישור בדפדפן.

בדיקה וביטול גישה של לקוחות OAuth:

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

1. נווט אל Settings > Instance-level MCP.
2. באזור Connected clients, בוחרים לקוח מהתצוגה המקדימה כדי לפתוח את פרטיו, או Revoke access כדי לבטל את גישתו. ללקוחות שאינם מוצגים בתצוגה המקדימה בוחרים View all; ללקוחות של משתמשים אחרים עוברים לתצוגת כל המשתמשים. הדבר מציג טבלה של לקוחות OAuth מחוברים, רמת הגישה שלהם, ומתי התחברו. לקוחות המשתמשים ב-API key אינם מופיעים כאן, מכיוון שהם מזדהים באמצעות bearer token ולא בחיבור OAuth.
3. בחר בשורת לקוח כדי לפתוח את פרטיו ולראות כל הרשאה שהוענקה לו, או בחר Revoke access ישירות בשורה כדי לעבור מיד לביטול.
4. אשר את הביטול. n8n מנתק את הלקוח מיד; עליו להתחבר ולהיכנס שוב כדי לקבל גישה מחדש.

חיבור באמצעות מפתח גישה (API key):

1. נווט אל Settings > Instance-level MCP.
2. באזור Connection details, בחר Connect כדי לפתוח את דיאלוג Connect a client.
3. עבור ללשונית API key. בפעם הראשונה שפותחים לשונית זו, n8n מייצר אוטומטית טוקן גישה אישי המשויך לחשבון המשתמש שלך.
4. העתק את הנדרש: בלוק Configuration JSON, שכבר כולל את כתובת השרת וכותרת Authorization: Bearer עם הטוקן שלך, או את ערכי Server URL וטוקן הגישה בנפרד אם הלקוח אינו משתמש בפורמט JSON זה (לדוגמה, הגדרת TOML של Codex). לאחר עזיבת הלשונית, n8n מציג ערך טוקן מוסתר בלבד, ולא תוכל להעתיק אותו שוב אלא אם תסובב אותו.
5. הדבק את מה שהעתקת בקונפיגורציית לקוח ה-MCP שלך: הדבק את ה-JSON ישירות בלקוחות שמקבלים מקטע mcpServers, או השתמש ב-Server URL ובטוקן בנפרד עבור לקוחות הדורשים פורמט אחר. לשונית זו אינה ייעודית ללקוח ספציפי, ולכן אותם ערכים פועלים עבור כל לקוח שאתה מגדיר.

פקודת CLI עם טוקן עבור Claude Code:

claude mcp add --transport http n8n-mcp http://localhost:5678/mcp-server/http \
  --header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"

סיבוב טוקן הגישה (Rotating access token):

אם איבדת את הטוקן או שאתה צריך לסובב אותו:

1. נווט אל Settings > Instance-level MCP.
2. באזור Connection details, בחר Connect כדי לפתוח את דיאלוג Connect a client.
3. עבור ללשונית API key.
4. צור טוקן חדש באמצעות הכפתור ליד הערך המוסתר. n8n מבטל את הטוקן הקודם ברגע שנוצר טוקן חדש.
5. עדכן את הערך החדש בכל לקוחות ה-MCP המחוברים.

#לקוחות בענן מול מופע ביתי

Claude.ai, ChatGPT ולקוחות אחרים בענן צריכים שהמופע יהיה נגיש מהאינטרנט. localhost אינו מספיק עבורם, כי שרתי הענן שלהם מתחברים ישירות אל n8n. פתרונות: פרוקסי הפוך (Reverse Proxy) עם HTTPS, או מנהרה (כגון Cloudflare Tunnel), עם כתובת ציבורית תקינה ומשתנה WEBHOOK_URL מוגדר כהלכה.

Claude Code שרץ מקומית על אותו מחשב יכול לעבוד ישירות מול http://localhost:5678/mcp-server/http.

הגבלת כתובות ניתוב חוזר ב-OAuth (החל מ-2.33.0): ברירת המחדל של n8n מאפשרת הפניה לכל כתובת callback ב-OAuth, דבר שנחשב פחות מאובטח. בעלי מופע ומנהלים יכולים להגביל את הכתובות המורשות:

1. נווט אל Settings > Instance-level MCP.
2. באזור Access, בחר Allowed callback URLs.
3. בחר מצב:
   • All callback URLs: כל כתובת URL יכולה להשלים כניסת OAuth.
   • Only trusted URLs: רק כתובות שתציין ברשימה יכולות להשלים כניסת OAuth.
4. אם בחרת Only trusted URLs, הוסף כל כתובת URL מהימנה, ובחר Save.

#סקילז רשמיים

כאשר מחברים סוכן קוד (כגון Claude Code או Codex) לשרת ה-MCP של n8n, הסוכן יכול לבנות ולערוך תהליכים, אך אינו מכיר באופן אוטומטי את המוסכמות של n8n לכתיבת ביטויים (expressions), הגדרת צמתים, טיפול בשגיאות ותבניות עבודה. סקילז של n8n מעניקים לסוכן את הידע הזה כדי שיבנה תהליכים נכון כבר בפעם הראשונה.

מומלץ לשקול שימוש בסוכני קוד (כגון Claude Code או סוכני Google ADK) במקום לקוחות צ'אט כלקוחות MCP. סוכני קוד מתמחים ביצירה ובאימות של קוד TypeScript, ולכן מתאימים במיוחד לבניית תהליכים בצורה תכנותית.

חבילת n8n Skills הרשמית מפורסמת במאגר n8n-io/skills ומיועדת לעבודה בצמוד לשרת ה-MCP ברמת המופע:

• 13 סקילז של יכולות: מכסים שיטות עבודה מומלצות לאורך מחזור החיים של תהליכים, כולל תהליכי משנה (sub-workflows), ביטויים, לולאות, סוכני בינה מלאכותית (AI agents), טיפול בשגיאות, אישורי גישה (credentials), טבלאות נתונים (Data Tables), ודיבאגינג.
• מעל 50 מסמכי הדרכה ודוגמאות: הנחיות לכל צומת, עצי החלטה, ומקטעי תהליכים מוכנים להעתקה.
• הוקים (Hooks): טוענים את ההנחיה הנכונה אוטומטית, כך שהסוכן קורא את הסקיל הרלוונטי לפני שהוא מבצע קריאות MCP בעלות השפעה גבוהה.
• סקיל-על 14: using-n8n-skills-official, שמנתב את הסוכן לסקיל היכולת המתאים עבור כל משימה.

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

הסקילז כתובים ב-Markdown פשוט, כך שניתן לקרוא אותם, לפצל (fork) אותם, ולהתאים אותם למוסכמות שלכם.

התקנת הסקילז: במאגר n8n-io/skills יש הוראות התקנה מעודכנות עבור Claude Code, Codex וסוכני קוד נוספים. יש לפעול לפי השלבים ב-README של המאגר להוספת הסקילז לסוכן שלך.

התקנה ב-Claude Code (CLI) דרך מנהל התוספים:

1. הוסף את המרקטפלייס:

/plugin marketplace add n8n-io/skills

2. התקן את התוסף:

/plugin install n8n-skills@n8n-io

הזן את כתובת הבסיס של המופע בלבד כשתתבקש, למשל http://localhost:5678 או https://n8n.example.com (ללא נתיב, התוסף מוסיף בעצמו /mcp-server/http). לאחר מכן הרץ /reload-plugins.

3. אשרר את ה-MCP: הרץ /mcp, בחר ב-n8n-mcp, ובחר Authenticate כדי להתחבר דרך הדפדפן.

מלכודת: התוסף מגדיר חיבור MCP עצמאי בשם n8n-mcp. אם הגדרתם בעבר חיבור MCP ידני לאותו שרת, כבו אותו מתוך /mcp כדי למנוע כפילות בכלים.

#חשיפת תהליכים

לקוחות MCP יכולים לאתר תצוגה מקדימה של כל התהליכים שלמשתמש הנוכחי יש גישה אליהם באמצעות search_workflows. לקוחות אינם יכולים לגשת לנתוני תהליך מלאים, להריץ תהליך או לשנות אותו, אלא אם תפעיל גישת MCP במפורש עבור אותו תהליך.

החשיפה אינה מוגדרת לפי לקוח בודד אלא לפי משתמש: כל לקוח שתחברו יראה את כל התהליכים שהפעלתם להם גישת MCP, בהתאם להרשאות המשתמש שלכם ב-n8n.

חשיפת תהליכים בודדים:

אפשרות 1: מעמוד Workflows enabled (זמין החל מ-2.2.0; שמו שונה מ-Workflows exposed בגרסה 2.42.0):

1. נווט אל Settings > Instance-level MCP.
2. בחר Workflows enabled.
3. לחץ על כפתור Enable workflows (בכותרת טבלת התהליכים או במצב הריק של הטבלה).
4. חפש את התהליך הרצוי (לפי שם או תיאור) ובחר בו מהרשימה.
5. לחץ על Enable לאישור.

אפשרות 2: מתוך עורך התהליך:

1. פתח את התהליך.
2. לחץ על תפריט התהליך הראשי (...) בפינה הימנית העליונה.
3. בחר Settings.
4. הפעל את המתג Available in MCP.

אפשרות 3: מרשימת התהליכים:

1. עבור אל Workflows.
2. פתח את התפריט בכרטיס התהליך.
3. בחר Enable MCP access.

ניהול גישה לתהליכים: עמוד Workflows enabled (תחת Access > Workflows enabled) מציג כל תהליך שלקוחות MCP יכולים לגשת אליו ולפעול עליו. מרשימה זו ניתן:

• לפתוח תהליך, את פרויקט הבית שלו או את תיקיית האב שלו ישירות.
• לבטל גישה באמצעות תפריט הפעולות (או להשתמש ב-Disable MCP access מתפריט כרטיס התהליך).
• לעדכן תיאור תהליך באמצעות תפריט הפעולות (או להשתמש בתפריט בעורך התהליך).
• להפעיל גישה עבור תהליכים נוספים באמצעות כפתור Enable workflows (זמין החל מ-2.2.0).

חשיפה ברמת פרויקט או תיקייה (החל מ-2.24.0):

ניתן להשתמש בתפריט האפשרויות ברשימת התהליכים כדי להפעיל או להשבית גישת MCP עבור כל התהליכים בפרויקט או בתיקייה הנוכחיים:

1. נווט אל הפרויקט הרצוי ובחר Workflows בתפריט העליון, ופתח תת-תיקייה במידת הצורך.
2. בחר בתפריט האפשרויות (...) ליד שם הפרויקט או התיקייה.
3. בחר Manage MCP access, ולאחר מכן בחר Enable MCP או Disable MCP.

הערה: פעולה זו תשנה את גישת ה-MCP עבור כל התהליכים שנמצאים כעת בפרויקט או בתיקייה שנבחרו (ותדלג על תהליכים שכבר נמצאים במצב שנבחר). כדי לחשוף תהליכים שייווצרו בעתיד מבלי לשנות כל אחד בנפרד, השתמש בחשיפה אוטומטית של תהליכים חדשים.

חשיפה אוטומטית של תהליכים חדשים (החל מ-2.36.0):

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

1. נווט אל Settings > Instance-level MCP.
2. הפעל את Auto-expose new workflows.

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

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

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

הוספת תיאור לתהליך (Workflow descriptions):

כדי לסייע ללקוחות MCP לזהות תהליכים, ניתן להוסיף תיאורי טקסט חופשי:

אפשרות 1: מעמוד Workflows enabled:

1. נווט אל Settings > Instance-level MCP.
2. בחר Workflows enabled.
3. השתמש בתפריט הפעולות בשורת התהליך הרצוי ובחר בפעולה Edit description.
4. לחלופין, לחץ ישירות על טקסט התיאור כדי לפתוח את דיאלוג העריכה.

אפשרות 2: מתוך עורך התהליך:

1. פתח את התהליך.
2. לחץ על תפריט התהליך הראשי (...) בפינה הימנית העליונה.
3. בחר Edit description.

חשיפת סוכנים ללקוחות MCP (החל מ-2.34.0):

סוכנים (Agents) הם תכונה נפרדת מתהליכים. לקוחות MCP יכולים לנהל סוכנים החל מגרסה 2.34.0. בענן n8n סוכנים מופעלים כברירת מחדל בחשבונות בגרסה היציבה העדכנית. בהתקנה עצמית, חלק זה רלוונטי רק אם הפעלתם את מודול ה-agents.

לפי התיעוד הרשמי, סוכנים נמצאים במצב תצוגה מקדימה (Preview) ועשויים להשתנות בגרסאות עתידיות, ולכן יש להימנע מהסתמכות עליהם בתהליכי ייצור.

אם במופע שלך פעילה תכונת הסוכנים, אזור Access מציג גם את Agents exposed. בדומה לתהליכים, לקוחות MCP אינם יכולים לקרוא או לנהל סוכן אלא אם הפעלת עבורו גישת MCP במפורש.

הפעלת גישה עבור סוכנים בודדים:

אפשרות 1: מעמוד הגדרות ה-MCP:

1. נווט אל Settings > Instance-level MCP.
2. בחר Agents exposed.
3. בחר Enable agents.
4. חפש את הסוכן הרצוי לפי שם ובחר בו מהרשימה.
5. בחר Enable לאישור.

אפשרות 2: מתוך עורך הסוכן (Agent builder):

1. פתח את הסוכן בעורך הסוכנים.
2. פתח את הגדרות ה-MCP שלו.
3. הפעל את המתג Available in MCP.

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

• לפתוח סוכן או את הפרויקט שלו ישירות.
• להסיר גישה עבור סוכן בודד מהשורה שלו, או לבחור מספר סוכנים ולהסיר גישה עבור כולם בבת אחת.
• להפעיל גישה עבור סוכנים נוספים באמצעות כפתור Enable agents.

#פרוקסי ששובר MCP

כאשר מציבים את n8n מאחורי Reverse Proxy (כגון nginx), נתב עומסים (Load Balancer) או WAF: לקוחות MCP שולחים אל נקודת הקצה של n8n את שלוש הכותרות הבאות:

• MCP-Protocol-Version
• Mcp-Method
• Mcp-Name

החל מגרסה 2.36.0, n8n מאפשר כותרות ניתוב אלו במדיניות ה-CORS שלו. אם הפרוקסי, נתב העומסים או ה-WAF מסיר כותרות לא מוכרות או מעביר רק כותרות מתוך רשימה לבנה (allowlist), חובה להוסיף את שלוש הכותרות הללו לרשימה המורשית. אחרת, לקוחות ייכשלו בהתחברות או ייסוגו לגרסת פרוטוקול ישנה יותר.

בדיקות נוספות לפתרון בעיות חיבור:

• ודא שמופע ה-n8n נגיש באופן ציבורי אם אתה משתמש בלקוחות MCP מבוססי ענן.
• ודא שגישת ה-MCP מופעלת בהגדרות n8n.
• ודא שהתהליכים שברצונך להריץ או לערוך מסומנים כ-Available in MCP.
• ודא ששיטת האימות (OAuth או API key) מוגדרת כהלכה בלקוח ה-MCP שלך.
• ודא שהפרוקסי ההפוך, נתב העומסים או ה-WAF אינו מסיר כותרות בקשת MCP.
• בדוק את יומני השרת (server logs) של n8n לאיתור הודעות שגיאה הקשורות לחיבורי MCP.

מלכודת: שגיאת Insufficient permissions בעת אישור לקוח: אם בעת אישור הלקוח מועברים לדף עם ההודעה You do not have sufficient permissions to authorize this request: בשרת ה-MCP של המופע, משמעות הדבר היא שגישת ה-MCP כבויה במופע. ההודעה אינה מציינת זאת, אך זו הסיבה היחידה. כאשר השרת פועל, כל משתמש מחובר יכול לאשר לקוח. כאשר הוא כבוי, n8n דוחה את כולם. הפתרון הוא לפנות לבעלים או למנהל המופע שיפעיל את הגישה ב-Settings > Instance-level MCP, ולאחר מכן לחבר את הלקוח שוב.

#שלושה דברים שנקראים MCP

כדי למנוע בלבול, ב-n8n קיימים שלושה שימושים שונים במונח MCP:

1. שרת ה-MCP המובנה ברמת המופע: הנושא של פרק זה. מאפשר חיבור מרכזי יחיד למופע n8n, שימוש באימות מרוכז (OAuth או API key), ובחירת התהליכים והסוכנים שיופעלו לגישה. תהליכים שהופעלו קלים לאיתור ולהרצה ללא הגדרה נוספת לכל תהליך. מאפשר ללקוחות לחפש, לבנות, לערוך ולהריץ תהליכים וטבלאות נתונים.
2. צומת MCP Server Trigger בתוך תהליך בודד: חושף כלים רק מאותו תהליך ספציפי שבו הוא מוגדר, גישה שימושית כאשר רוצים לבנות התנהגות שרת MCP ייעודית בתוך תהליך יחיד.
3. שרת תיעוד ה-docs הרשמי של n8n: שרת MCP חיצוני בכתובת https://docs.n8n.io/~gitbook/mcp, המאפשר לעוזרי AI לקרוא ולחפש בתיעוד הרשמי של n8n.

בפרק הבא: n8n Assistant בהתקנה עצמית, כולל sandbox ו-Daytona.