🔌 פרק 9

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

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

לפי Connect to n8n MCP server ו-Manage settings using environment variables. מינימום 2.2.0. משתני MCP מ-2.20.0. דיאלוג Connect a client מ-2.33.0.

#הפעלה בממשק

1. Settings > Instance-level MCP.
2. Enable MCP access (בעלים או מנהל).
3. Connect מעתיק Server URL. מקומית זה בדרך כלל:

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

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

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

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

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

N8N_MCP_MANAGED_BY_ENV=true
N8N_MCP_ACCESS_ENABLED=true

בלי N8N_MCP_MANAGED_BY_ENV=true הערך השני לא חל, והממשק נשאר הדרך לשליטה. כש-MANAGED_BY_ENV דלוק, המתג בממשק נעול.

כיבוי מלא של היכולת:

N8N_DISABLED_MODULES=mcp

זה מסיר נקודות קצה ומסתיר את המסכים.

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

OAuth מומלץ:

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

בתוך קלוד קוד: /mcp, בחירת n8n, אישור OAuth.

עם מפתח:

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

הטוקן נוצר בלשונית API key בדיאלוג Connect a client. מעתיקים מיד. סיבוב מבטל את הקודם.

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

Claude.ai, ChatGPT ולקוחות אחרים בענן צריכים שהמופע יהיה נגיש מהאינטרנט. localhost לא מספיק להם. פתרונות: פרוקסי עם HTTPS, או מנהרה, עם WEBHOOK_URL נכון.

קלוד קוד שרץ על אותו מחשב יכול להשתמש ב-HTTP מקומי.

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

בתוך סשן claude:

/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io

מזינים כתובת בסיס בלי נתיב, למשל http://localhost:5678 או https://n8n.example.com. התוסף מוסיף /mcp-server/http. אחר כך /reload-plugins ו-/mcp לאימות.

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

אותם כללים כמו בענן: תהליך מפורסם עם webhook, form, schedule או chat trigger, וסימון Available in MCP. search_workflows מחזיר תצוגה מקדימה בלבד לשאר.

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

אם החיבור נכשל מאחורי nginx או WAF, בודקים שהכותרות MCP-Protocol-Version, Mcp-Method ו-Mcp-Name עוברות. מגרסה 2.36.0 הן חלק ממדיניות CORS.

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

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

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