🔌 פרק 10

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

n8n חושף שרת MCP מובנה ברמת המופע (Instance-level MCP). קלוד קוד (Claude Code) מתחבר אליו כלקוח. כך מתארים תהליך בעברית בטרמינל, וקלוד קוד בונה, בודק ומפרסם אותו במופע Cloud שלכם.

לפי Connect to n8n MCP server. מינימום גרסה 2.2.0. דיאלוג Connect a client מגרסה 2.33.0. בניית תהליכים דרך MCP מגרסה 2.13.0.

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

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

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

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

• לחפש תהליכים (תצוגה מקדימה בלבד לכל התהליכים שיש הרשאה לראות).
• לקרוא, לערוך ולהריץ תהליכים שסימנתם כזמינים ל-MCP.
• ליצור ולערוך תהליכים ו-Data Tables.
• לנהל סוכנים, אם היכולת פעילה במופע.

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

execute_workflow רץ כברירת מחדל על הגרסה המפורסמת. יש גם מצב manual לטיוטה.

#הפעלה ב-Cloud

נדרשות הרשאות בעלים או מנהל.

1. נכנסים ל-Settings > Instance-level MCP.
2. לוחצים Enable MCP access.

אחרי ההפעלה מופיעים שלושה אזורים:

• Connection details: סטטוס וכפתור Connect.
• Access: כמה תהליכים (וסוכנים, אם יש) חשופים, וכתובות callback מותרות ל-OAuth.
• Connected clients: לקוחות OAuth מחוברים וההרשאות שלהם.

כיבוי: ב-Connection details בוחרים Disable. כל הלקוחות מתנתקים.

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

כתובת השרת מסתיימת ב-/mcp-server/http. זו לא כתובת העורך. ב-Cloud היא נראית כך:

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

מעתיקים את Server URL מ-Settings > Instance-level MCP > Connect a client.

בטרמינל:

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

מחליפים את <your-n8n-domain> בדומיין בלי https://, לדוגמה acme.app.n8n.cloud.

בתוך קלוד קוד מריצים /mcp, בוחרים n8n, ומשלימים אישור OAuth בדפדפן.

אפשר גם להוסיף ל-claude.json:

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

בדיאלוג Connect a client מגרסה 2.33 בוחרים CLI > Claude Code ומקבלים את הפקודה המוכנה.

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

1. באותו דיאלוג עוברים ללשונית API key.
2. n8n יוצרת טוקן אישי בפעם הראשונה. מעתיקים אותו עכשיו. אחר כך הוא מוצג מצונזר.
3. מריצים:

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

לקוחות מפתח לא מופיעים בטבלת Connected clients. סיבוב טוקן מבטל את הקודם.

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

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

אפשר להפעיל MCP רק לתהליך מפורסם שיש בו webhook, form, schedule או chat trigger.

שלוש דרכים:

1. Settings > Instance-level MCP > Workflows exposed > Enable workflows.
2. בעורך: תפריט ... > Settings > Available in MCP.
3. ברשימת התהליכים: תפריט הכרטיס > Enable MCP access.

מגרסה 2.24.0 אפשר להפעיל או לכבות לתיקייה או לפרויקט שלם. מגרסה 2.36.0 יש Auto-expose new workflows לבעלים ומנהלים. זה חל רק על תהליכים חדשים.

כדאי למלא Edit description לתהליך. כך הלקוח מזהה אותו בחיפוש.

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

החיבור נותן כלים. הסקילז נותנים לכללים של n8n: ביטויים, צמתים, שגיאות. מאגר n8n-io/skills.

בתוך סשן claude:

1. /plugin marketplace add n8n-io/skills
2. /plugin install n8n-skills@n8n-io, מזינים את כתובת הבסיס של המופע בלי נתיב, למשל https://acme.app.n8n.cloud. התוסף מוסיף /mcp-server/http.
3. /reload-plugins
4. /mcp, בוחרים n8n-mcp, ו-Authenticate.

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

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

אותו Server URL עובד גם מול Cursor, VS Code, Codex ו-Gemini CLI. ב-Cursor ו-VS Code יש One-click מתוך דיאלוג Connect a client. Codex:

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

ואחר כך codex mcp login n8n.

התיעוד ממליץ על סוכן קידוד (קלוד קוד) ולא על צ'אט רגיל, כי בניית תהליך דורשת TypeScript תקין.

#אם החיבור נכשל

• MCP כבוי במופע. הודעת "insufficient permissions to authorize" פירושה שהיכולת כבויה, לא שחסרה הרשאת משתמש אחרת.
• תהליך לא מסומן Available in MCP, או לא מפורסם, או בלי trigger מתאים.
• הדביקו את כתובת העורך במקום Server URL.
• לקוח ענן צריך שהמופע יהיה נגיש מהאינטרנט. Cloud כבר כזה.

בפרק הבא: סוכנים בענן, כולל ניהול דרך אותו שרת MCP.