תיעוד 6

דוגמאות לחיבור לקוחות MCP

לאינדקס התיעוד המלא, ראו llms.txt. גרסאות Markdown של דפי תיעוד זמינות על ידי הוספת .md לכתובות ה-URL של הדפים; דף זה זמין כ-Markdown.

פקודות חיבור והגדרות להעתקה והדבקה עבור Lovable, Claude Desktop, Claude Code, Codex, Gemini CLI, Cursor, VS Code, Windsurf וסוכני Google ADK.

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

תיבת הדו שיח Connect a client (זמינה החל מ-n8n 2.33.0) מספקת הגדרה בלחיצה אחת לחיבור Claude.ai, Cursor ו-VS Code. היא מספקת גם שלבי הגדרה אינטראקטיביים עבור Claude Code, Codex, Gemini CLI, ChatGPT ו-Windsurf. ראו שימוש ב-OAuth (מומלץ) כדי לראות כיצד לפתוח את תיבת הדו שיח ולבחור את הלקוח שלכם.

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

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

#חיבור Lovable לשרת ה-MCP של n8n

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

#חיבור Claude Desktop לשרת ה-MCP של n8n

שימוש ב-OAuth (מומלץ)

נווטו אל Settings > Connectors ב-Claude Desktop.
לחצו על Add custom connector.
הזינו את הפרטים הבאים:
- Name: n8n MCP
- Remote MCP Server URL: ערך ה-Server URL המוצג בתיבת הדו שיח Connect a client. הוא מסתיים ב-/mcp-server/http, כך שהוא נראה כמו https://<your-n8n-domain>/mcp-server/http. זו אינה הכתובת של עורך ה-n8n שלכם. אל תדביקו את כתובת ה-URL משורת הכתובת של הדפדפן שלכם.
שמרו את המחבר (connector).
כאשר תתבקשו, אשרו גישה עבור 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>"
    ]
  }
}

כאן, החליפו:

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

#חיבור Claude Code לשרת ה-MCP של n8n

אפשרות 1: אימות באמצעות OAuth (מומלץ)

השתמשו בפקודת ה-CLI הבאה:

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

או הוסיפו את הרשומה הבאה לקובץ claude.json שלכם:

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

כאן, החליפו:

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

הריצו /mcp ב-Claude Code ובחרו ב-n8n כדי להשלים את אישור ה-OAuth.

אפשרות 2: אימות באמצעות מפתח API

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

#חיבור Codex CLI לשרת ה-MCP של n8n

אפשרות 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 דורשות אותו; גרסאות חדשות יותר מתעלמות ממנו.

כאן, החליפו:

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

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

אפשרות 2: אימות באמצעות מפתח API

הוסיפו את הרשומה הבאה לקובץ ~/.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-domain>: הדומיין של n8n שלכם, ללא קידומת https://. ב-n8n Cloud זהו your-instance.app.n8n.cloud. כאשר מותקן באירוח עצמי, זהו הדומיין שמגיש את עורך ה-n8n שלכם, למשל n8n.example.com. תוכלו למצוא את כתובת ה-URL המלאה של השרת ב-n8n תחת Settings > Instance-level MCP > Connect a client > Server URL.
<YOUR_N8N_MCP_TOKEN>: הטוקן שנוצר עבורכם

#חיבור Gemini CLI לשרת ה-MCP של n8n

השתמשו בפקודת ה-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"
        }
    }
}

כאן, החליפו:

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

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

#חיבור Cursor לשרת ה-MCP של n8n

בתיבת הדו שיח 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"
    }
  }
}

כאן, החליפו:

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

#חיבור VS Code לשרת ה-MCP של n8n

בתיבת הדו שיח 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"
    }
  }
}

כאן, החליפו:

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

#חיבור Windsurf לשרת ה-MCP של n8n

הוסיפו את הרשומה הבאה לקובץ ~/.codeium/windsurf/mcp_config.json שלכם:

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

כאן, החליפו:

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

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

#חיבור סוכן Google ADK לשרת ה-MCP של n8n

להלן קוד לדוגמה ליצירת סוכן שמתחבר לשרת 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://localhost:5678"
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: כתובת ה-URL הבסיסית של מופע ה-n8n שלכם. ב-n8n Cloud זהו https://your-instance.app.n8n.cloud. כאשר מותקן באירוח עצמי, זוהי כתובת ה-URL שלכם, למשל https://n8n.example.com. תוכלו למצוא את כתובת ה-URL המלאה של השרת ב-n8n תחת Settings > Instance-level MCP > Connect a client > Server URL.
YOUR_N8N_MCP_TOKEN: טוקן הגישה שנוצר עבורכם

לפרטים נוספים, ראו Connect ADK agent to n8n.

#פתרון בעיות

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