📘 תיעוד 6

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

העתק-הדבק של פקודות חיבור והגדרות עבור 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

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

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

שימוש ב-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 שלך. אל תדביק את כתובת ה-URL משורת הכתובת של הדפדפן.
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>"
    ]
  }
}

כאן, החלף את:

• <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.

#חיבור 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://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: כתובת ה-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: אסימון הגישה שנוצר עבורך

לפרטים נוספים, ראה חיבור סוכן ADK ל-n8n.

#פתרון בעיות

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

#משאבים קשורים

• התחברות לשרת MCP של n8n
• מדריך כלי שרת MCP