پرش به محتویات

مستندات نود Trigger سرور MCP#

از نود Trigger سرور MCP برای اجازه دادن به n98n جهت عمل کردن به عنوان یک سرور پروتکل فضای مدل (MCP)، استفاده کنید و ابزارها و ورکفلوها n98n را در دسترس مشتریان MCP قرار دهید.

اعتبارنامه‌

می‌توانید اطلاعات احراز هویت مربوط به این نود را اینجا پیدا کنید.

نحوه کار نود Trigger سرور MCP#

نود Trigger سرور MCP نقش دروازه ورودی به n98n را برای مشتریان MCP ایفا می‌کند. این نود با ارائه یک URL عمل می‌کند که مشتریان MCP می‌توانند با آن برای دسترسی به ابزارهای n98n تعامل داشته باشند.

بر خلاف نودهای trigger معمولی که به ایونت‌ها پاسخ می‌دهند و خروجی خود را به نودهای متصل بعدی می‌فرستند، نود Trigger سرور MCP تنها به ابزارهای ابزار متصل و اجرا می‌شود. مشتریان می‌توانند فهرست ابزارهای موجود را ببینند و هر ابزاری را برای انجام کار فراخوانی کنند.

شما می‌توانید با کانکشن ورکفلوها n98n با استفاده از نود ابزار ورکفلو سفارشی n8n، آن‌ها را به مشتریان عرضه کنید.

پشتیبانی از ایونت‌های سرور-ارسال شده (SSE)

نود Trigger سرور MCP از ایونت‌های سرور-ارسال شده (SSE) پشتیبانی می‌کند؛ یک پروتکل انتقال بلندمدت بر پایه HTTP، برای ارتباط بین مشتریان و سرور. در حال حاضر، این نود از انتقال استاندارد ورودی/خروجی (stdio) پشتیبانی نمی‌کند.

پارامترهای نود#

از این پارامترها برای پیکربندی نود خود استفاده کنید.

URL سرور MCP#

نود Trigger سرور MCP دارای دو URL MCP است: آزمایشی و پروداکشن. n98n این URLها را در بالای پانل نود نمایش می‌دهد.

برای تغییر بین URL آزمایشی و پروداکشن، گزینه آزمون URL یا URL پروداکشن را انتخاب کنید.

  • آزمون: n98n هنگام انتخاب گزینه گوش دادن به ایونت آزمایشی یا اجرای ورکفلو، یک URL MCP آزمایشی ثبت می‌کند، اگر ورکفلو فعال نباشد. وقتی این URL را فراخوانی می‌کنید، داده‌های داخل گردش را نمایش می‌دهد.
  • پروداکشن: n98n وقتی ورکفلو را فعال کنید، یک URL MCP پروداکشن ثبت می‌کند. در هنگام استفاده از URL پروداکشن، n98n داده‌های داخل گردش را نمایش نمی‌دهد. هنوز می‌توانید داده‌های اجرای گردش را ببینید: بر روی برگه اجرای‌ها در داخل گردش کلیک کنید و سپس اجرای موردنظر را انتخاب کنید.

احراز هویت#

برای ارتباط مشتریان با URL MCP خود، می‌توانید احراز هویت را فعال کنید. روش‌های احراز هویت شامل موارد زیر است:

  • احراز هویت Bearer
  • احراز هویت هدر

برای اطلاعات بیشتر در مورد تنظیم هر نوع اعتبار، به اعتبارنامه درخواست HTTP مراجعه کنید.

مسیر (Path)#

به طور پیش‌فرض، این فیلد شامل مسیری تصادفی برای URL MCP است تا درگیری با نودهای Trigger سرور MCP دیگر جلوگیری شود.

می‌توانید به صورت دستی مسیر URL را مشخص کنید، از جمله افزودن پارامترهای مسیر. برای مثال، اگر قصد دارید از n98n برای نمونه‌سازی یک API استفاده کنید و به مسیرهای endpoint ثابت نیاز دارید، این گزینه مفید است.

فرمت‌های مجاز برای میدان Path عبارتند از:

  • /:متغیر
  • /مسیر/:متغیر
  • /:متغیر/مسیر
  • /متغیر۱/مسیر/:متغیر۲
  • /:متغیر۱/:متغیر۲

قالب‌ها و نمونه‌ها#

Browse تریگر سرور MCP integration templates, or search all templates

یکپارچه‌سازی با Claude Desktop#

می‌توانید به نود Trigger سرور MCP از طریق Claude Desktop وصل شوید، با اجرای یک دروازه برای پروکسی کردن پیام‌های SSE به سرورهای مبتنی بر stdio.

برای این کار، موارد زیر را به تنظیمات Claude Desktop خود اضافه کنید:

```json { "mcpServers": { "n8n": { "command": "npx", "args": [ "-y", "supergateway", "--sse", "", "--header", "Authorization: Bearer " ] } } }

مطمئن شوید که مقادیر <MCP_URL> و <MCP_BEARER_TOKEN> را با مقادیر پارامترهای نود Trigger سرور MCP خود جایگزین کنید.

محدودیت‌ها#

پیکربندی نود Trigger سرور MCP با رپلیکاهای webhook#

نود Trigger سرور MCP به ایونت‌های سرور-ارسال شده (SSE) وابسته است، که نیازمند آن است که همان نمونه سرور درخواست‌های پایدار را مدیریت کند. این موضوع ممکن است در هنگام اجرای n98n در حالت صف ایجاد مشکل کند، بسته به پیکربندی پردازشگر webhook:

  • اگر در حالت صف و با یک رپلیکا webhook استفاده کنید، نود Trigger سرور MCP به خوبی کار می‌کند.
  • اگر چندین رپلیکا webhook دارید، باید تمامی درخواست‌های /mcp* را به یک رپلیکا مخصوص و مستقل هدایت کنید. برای این‌کار، یک مجموعه رپلیکا جداگانه با یک کانتینر webhook برای درخواست‌های MCP ایجاد کنید. پس از آن، پیکربندی ingress یا load balancer خود را به گونه‌ای اصلاح کنید که تمامی ترافیک /mcp* را به آن نمونه هدایت کند.

احتیاط در اجرای چند webhook رپلیکا

اگر نود Trigger سرور MCP را با چند رپلیکا webhook اجرا کنید و درخواست‌های /mcp* را فقط به یکی از این رپلیکاها هدایت نکنید، اتصالات SSE شما به‌طور مکرر قطع شده یا ایونت‌ها به درستی تحویل داده نخواهند شد.

منابع مرتبط#

n98n همچنین یک ابزار مشتری MCP در اختیار شما قرار می‌دهد که امکان کانکشن عامل‌های هوش مصنوعی n98n به ابزارهای خارجی را فراهم می‌کند.

برای جزئیات بیشتر درباره پروتکل، سرورها و مشتریان، به مستندات MCP و مشاهده‌نامه MCP مراجعه کنید.

مشکلات رایج#

در اینجا برخی خطاها و مشکلات رایج مربوط به نود Trigger سرور MCP و راه‌حل‌ها یا راهکارهای رفع آن‌ها آورده شده است.

اجرای نود Trigger سرور MCP با پراکسی معکوس#

هنگام اجرای n98n پشت یک پراکسی معکوس مانند nginx، ممکن است با مشکل مواجه شوید اگر endpoint مربوط به MCP برای SSE پیکربندی نشده باشد.

مشخصاً، باید bufferینگ پراکسی را برای این endpoint غیرفعال کنید. موارد دیگری که ممکن است نیاز باشد تنظیم کنید، شامل غیرفعال کردن فشرده‌سازی gzip (که n98n خودش این کار را انجام می‌دهد)، غیرفعال کردن انتقال chunked و تنظیم Connection به رشته خالی است تا از افزوده شدن آن به هدرهای فوروارد شده جلوگیری شود. غیرفعال کردن واضح این موارد در endpoint MCP اطمینان می‌دهد که از پیکربندی nginx دیگری ارث نباشد.

یک بلوک موقعیت nginx نمونه برای سرو کردن ترافیک MCP با این تنظیمات ممکن است شبیه به این باشد:

location /mcp/ { proxy_http_version 1.1; proxy_buffering off; gzip off; chunked_transfer_encoding off;

proxy_set_header Connection '';

# سایر هدرها و تنظیمات پراکسی شما # . . . }