🔌 פרק 10

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

n8n חושף שרת MCP מובנה ברמת המופע (Instance-level MCP). קלוד קוד (Claude Code) מתחבר אליו כלקוח, וכך גם סוכנים וסביבות פיתוח נוספות כמו Cursor, VS Code, Windsurf, Codex, Gemini CLI, Lovable, Claude Desktop וסוכני Google ADK. כך מתארים תהליך בעברית בטרמינל, והסוכן בונה, בודק, מריץ ומפרסם אותו במופע Cloud שלכם.

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

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

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

בנוסף קיים צומת MCP Client Tool: הכיוון ההפוך, שבו תהליך בתוך n8n קורא לכלי של שרת MCP חיצוני.

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

לאחר החיבור, לקוחות נתמכים יכולים:

• לחפש תהליכים.
• לקיים אינטראקציה עם תהליכים שסומנו כזמינים ב-MCP.
• להפעיל ולבדוק תהליכים חשופים.
• ליצור ולערוך תהליכים וטבלאות נתונים (data tables).

השרת חושף כלים לניהול תהליכים, לבניית תהליכים, לניהול סוכנים, להעדפות משתמש ולטבלאות נתונים. הרשימה המלאה והפרמטרים נמצאים בעמוד הרשמי MCP server tools reference.

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

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

#הפעלה ב-Cloud

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

הפעלת MCP ב-Cloud וב-self-hosted דורשת הרשאות בעלים (owner) או מנהל (admin) במופע.

שלבי הפעלה:

1. עוברים אל Settings > Instance-level MCP.
2. בוחרים Enable MCP access.

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

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

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

ניהול והשבתה ב-self-hosted: במופעי self-hosted ניתן לנהל את הגדרות ה-MCP באמצעות משתני סביבה. להסרה מלאה של הרכיב, מגדירים את משתנה הסביבה:

N8N_DISABLED_MODULES=mcp

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

#חיבור קלוד קוד עם OAuth

שלבי החיבור לפי לקוח זמינים מגרסה 2.33.0. בגרסאות מוקדמות יותר אין שלבים אלה, ומגדירים את הלקוח ידנית לפי הפקודות שבהמשך הפרק.

בדיאלוג Connect a client, שיטת ברירת המחדל המומלצת היא OAuth. כתובת השרת מסתיימת ב-/mcp-server/http. ב-Cloud הכתובת נראית כך:

https://your-instance.app.n8n.cloud/mcp-server/http

שלבי חיבור באמצעות OAuth:

1. עוברים אל Settings > Instance-level MCP.
2. באזור Connection details, בוחרים Connect כדי לפתוח את דיאלוג Connect a client.
3. מוודאים שנמצאים בלשונית OAuth (recommended).
4. בתפריט הנפתח Your client, בוחרים את עוזר ה-AI, סביבת הפיתוח (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, מאשרים את הגישה להשלמת החיבור.

עבור Claude Code, פקודת ההתקנה ב-CLI היא:

claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

מחליפים את <your-n8n-domain> בדומיין של המופע ללא הקידומת https://, לדוגמה your-instance.app.n8n.cloud ב-Cloud, או דומיין המופע שלכם ב-self-hosted, כגון n8n.example.com. אם המופע מוגש ב-HTTP רגיל (כמו בהתקנה מקומית בכתובת http://localhost:5678), משתמשים ב-http:// במקום https://.

לחלופין, ניתן להוסיף לקובץ claude.json:

{
    "mcpServers": {
        "n8n": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

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

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

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

#חיבור עם מפתח API

במקרים שבהם מעדיפים הזדהות באמצעות Personal Access Token:

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

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

claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"

או בקובץ claude.json:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http",
            "headers": {
                "Authorization": "Bearer <YOUR_N8N_MCP_TOKEN>"
            }
        }
    }
}

מחליפים את <YOUR_N8N_MCP_TOKEN> בטוקן שנוצר.

החלפת טוקן גישה (Rotation): אם הטוקן אבד או שיש צורך להחליפו:

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

#הגבלת כתובות callback ב-OAuth

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

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

#חשיפת תהליך לקלוד קוד

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

הפעלת גישה לתהליך בודד:

אפשרות 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.

הפעלת גישה לפרויקט או לתיקייה (זמין מגרסה 2.24.0): ניתן להשתמש בתפריט Options (שלוש נקודות) ברשימת התהליכים כדי לשנות את גישת ה-MCP לכל התהליכים בפרויקט או בתיקייה הנוכחיים:

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

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

חשיפה אוטומטית של תהליכים חדשים (Auto-expose new workflows, מתגלגל בהדרגה מגרסה 2.36.0, וההגדרה עדיין לא מופיעה בכל מופע): במקום להפעיל גישת MCP לכל תהליך בנפרד, ניתן לחשוף כל תהליך חדש שנוצר באופן אוטומטי:

1. עוברים אל Settings > Instance-level MCP.
2. מפעילים את המתג Auto-expose new workflows.

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

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

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

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

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

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

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

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

#חשיפת סוכנים ל-MCP

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

סטטוס Preview: סוכנים נמצאים בשלב Preview ועשויים להשתנות בגרסאות עתידיות. מומלץ להימנע מלהסתמך עליהם בתהליכי ייצור.

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

הפעלת גישה לסוכן בודד:

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

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

אפשרות 2: מתוך בונה הסוכנים (agent builder):

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

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

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

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

חיבור השרת מעניק ללקוח את כלי ה-MCP, אך אינו מקנה לו אוטומטית את הידע על המוסכמות הפנימיות של n8n: ביטויים (expressions), הגדרות צמתים, טיפול בשגיאות ותבניות עבודה. לשם כך פותחו מודולי ה-Skills במאגר הרשמי n8n-io/skills. סוכני קידוד, כגון Claude Code או סוכני Google ADK, מתאימים לבניית תהליכים יותר מלקוחות צ'אט, כי הם מתמחים ביצירה ובאימות של קוד TypeScript.

החבילה פועלת בצמוד לשרת ה-MCP וכוללת:

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

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

הסקילז כתובים ב-Markdown פשוט וניתנים לקריאה, לפיצול (fork) ולהתאמה אישית. הוראות ההתקנה העדכניות עבור Claude Code, Codex וסוכני קידוד נוספים מופיעות בקובץ ה-README במאגר הרשמי n8n-io/skills.

#לקוחות נוספים, בקצרה

אותו Server URL משמש לקוחות נוספים. דיאלוג Connect a client מספק התקנה בלחיצה אחת עבור Claude.ai, Cursor ו-VS Code, והדרכה מותאמת עבור Claude Code, Codex, Gemini CLI, ChatGPT ו-Windsurf.

כל הדוגמאות שלהלן משתמשות ב-https://. אם המופע שלכם מוגש ב-HTTP רגיל, כגון התקנה מקומית בכתובת http://localhost:5678, השתמשו ב-http:// במקום זאת. העתקת ה-Server URL המלא מתוך n8n מספקת את הקידומת הנכונה בכל מקרה.

בכל הדוגמאות, מחליפים את <your-n8n-domain> בדומיין ה-n8n שלכם ללא קידומת https:// (ב-n8n Cloud זהו your-instance.app.n8n.cloud, וב-self-hosted זהו הדומיין המגיש את העורך, למשל n8n.example.com). את כתובת השרת המלאה ניתן למצוא תחת Settings > Instance-level MCP > Connect a client > Server URL.

ריכוז הגדרות הלקוחות:

דוגמאות הגדרה ופקודות מפורטות:

#Lovable

1. הגדרת שרת MCP ב-Lovable באמצעות OAuth:
   • עוברים אל Settings > Integrations בסביבת העבודה.
   • באזור MCP Servers, מאתרים את n8n ולוחצים Connect.
   • מזינים את כתובת שרת ה-n8n: ערך ה-Server URL המוצג בדיאלוג Connect a client.
   • שומרים את החיבור. אם הפעולה הצליחה, n8n מפנה אתכם לאשר גישה עבור Lovable.
2. אימות החיבור:
   • לאחר החיבור, Lovable יכול לתשאל תהליכים שגישת MCP הופעלה עבורם.
   • דוגמה: בקשה מ-Lovable לבנות ממשק משתמש לתהליך שמציג משתמשים ומאפשר למחוק אותם.

#Claude Desktop

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

1. עוברים אל Settings > Connectors ב-Claude Desktop.
2. לוחצים על Add custom connector.
3. מזינים את הפרטים הבאים:
   • Name: n8n MCP
   • Remote MCP Server URL: ערך ה-Server URL המוצג בדיאלוג Connect a client. הוא מסתיים ב-/mcp-server/http, כך שהוא נראה כמו https://<your-n8n-domain>/mcp-server/http. זו אינה כתובת עורך ה-n8n שלכם, ואין להדביק את הכתובת משורת הכתובת בדפדפן.
4. שומרים את המחבר.
5. כאשר מופיעה בקשה, מאשרים גישה עבור Claude Desktop.

חיבור באמצעות מפתח API: מוסיפים את הערך הבא לקובץ claude_desktop_config.json:

"mcpServers": {
  "n8n-mcp": {
    "command": "npx",
    "args": [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<your-n8n-domain>/mcp-server/http",
    "--header",
    "Authorization:Bearer <YOUR_N8N_MCP_TOKEN>"
    ]
  }
}

#Codex CLI

אפשרות 1: אימות באמצעות OAuth (מומלץ): מריצים את פקודת ה-CLI הבאה:

codex mcp add n8n --url "https://<your-n8n-domain>/mcp-server/http"

או מוסיפים את הקטע הבא לקובץ ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n]
url = "https://<your-n8n-domain>/mcp-server/http"

בלוק ה-[features] מפעיל את לקוח ה-HTTP MCP של Codex. גרסאות ישנות יותר של Codex דורשות אותו, ואילו גרסאות חדשות יותר מתעלמות ממנו.

מריצים codex mcp login n8n להשלמת אימות ה-OAuth.

אפשרות 2: אימות באמצעות API key: מוסיפים לקובץ ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n-mcp]
url = "https://<your-n8n-domain>/mcp-server/http"
http_headers = { "authorization" = "Bearer <YOUR_N8N_MCP_TOKEN>" }

מחליפים את <YOUR_N8N_MCP_TOKEN> בטוקן שנוצר.

#Gemini CLI

מריצים את פקודת ה-CLI הבאה:

gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

או מוסיפים לקובץ ~/.gemini/settings.json:

{
    "mcpServers": {
        "n8n": {
            "httpUrl": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

מריצים /mcp בתוך Gemini CLI ובוחרים n8n להשלמת אימות ה-OAuth.

#Cursor

בדיאלוג Connect a client, בוחרים Cursor תחת Your client, ולאחר מכן בוחרים One-click setup כדי לפתוח את Cursor ולהוסיף את שרת ה-n8n אוטומטית. מאשרים את הגישה כאשר Cursor מפנה חזרה אל n8n.

לחלופין, מוסיפים לקובץ ~/.cursor/mcp.json (או לקובץ הפרויקט .cursor/mcp.json):

{
  "mcpServers": {
    "n8n": {
      "type": "streamable-http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

#VS Code

בדיאלוג Connect a client, בוחרים VS Code תחת Your client, ולאחר מכן בוחרים One-click setup כדי לפתוח את VS Code ולהוסיף את שרת ה-n8n אוטומטית. מאשרים את הגישה כאשר VS Code מפנה חזרה אל n8n.

לחלופין, מוסיפים לקובץ .vscode/mcp.json בסביבת העבודה:

{
  "servers": {
    "n8n": {
      "type": "http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

#Windsurf

מוסיפים לקובץ ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "n8n": {
      "serverUrl": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

מאשרים את הגישה כאשר Windsurf מפנה אל n8n בניסיון החיבור הראשון.

#Google ADK

דוגמת קוד ליצירת סוכן המתחבר לשרת MCP מרוחק של n8n:

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://n8n.example.com"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={
                    "Authorization": f"Bearer {N8N_MCP_TOKEN}",
                },
            ),
        )
    ],
)

מחליפים את:

• N8N_INSTANCE_URL: כתובת הבסיס של מופע ה-n8n שלכם. ב-n8n Cloud זו הכתובת https://your-instance.app.n8n.cloud. ב-self-hosted זו הכתובת שלכם, לדוגמה https://n8n.example.com.
• N8N_MCP_TOKEN: טוקן הגישה שנוצר.

#מלכודות בחיבור

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

הרשאות חסרות באישור לקוח: הלקוח מפנה אל n8n לאישור הגישה, ומגיעים לדף שכתוב בו You do not have sufficient permissions to authorize this request.

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

מבקשים מבעל המופע או ממנהל להפעיל את הגישה, ואז מחברים את הלקוח שוב.

#כותרות בקשה של MCP

מגרסה 2.36.0 n8n מתירה את כותרות הניתוב האלה במדיניות ה-CORS. לקוחות MCP שולחים אותן לנקודת הקצה של שרת ה-MCP:

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

אם n8n יושב מאחורי reverse proxy, מאזן עומסים או חומת אש של אפליקציות web שמסיר כותרות לא מוכרות, או שמעביר רק רשימת כותרות מותרות, מוסיפים את שלוש הכותרות לרשימה. בלי זה הלקוח עלול להיכשל בחיבור או ליפול לגרסת פרוטוקול ישנה יותר.