افزودن یک سرور MCP شخصی
با یک سرور MCP شخصی، AI-Corporate را به یک برنامه داخلی، منبع داده یا سرویس تخصصی متصل می‌کنید. ابتدا transport مناسب محل استفاده را انتخاب کنید.
انتخاب transport مناسب
| Transport | وب | موبایل | دسکتاپ | استفاده |
|---|---|---|---|---|
| Streamable HTTP | بله | بله | بله | پیشنهادشده برای سرورهای میزبانی‌شده |
| stdio | خیر | خیر | بله | فرایندهای محلی و یکپارچه‌سازی‌های دسکتاپ |
| SSE | فقط پیکربندی‌های موجود | فقط پیکربندی‌های موجود | بله | transport قدیمی؛ برای سرورهای جدید Streamable HTTP را انتخاب کنید |
پیش‌نیازهای Streamable HTTP
از endpoint عمومی کامل، همراه با مسیر MCP، استفاده کنید؛ برای مثال:
https://mcp.example.com/mcp
endpoint باید از HTTPS استفاده کند، بدون redirect و از طریق DNS عمومی در دسترس باشد و به یک handshake معتبر initialize در MCP پاسخ دهد. نام‌های کاربری و گذرواژه‌ها نباید داخل URL باشند. آدرس‌های محلی، آدرس‌های شبکه خصوصی و cloud metadata endpoint ها مسدود می‌شوند.
افزودن یک سرور
- تنظیمات → Tools را باز کنید.
- افزودن Tools یا افزودن سرور MCP را انتخاب کنید. این دکمه فقط زمانی دیده می‌شود که دسترسی MCP داشته باشید.
- preset های سازگار با سازمانِ موجود را مرور کنید.
- افزودن یک سرور MCP شخصی را انتخاب کنید.
- نام، endpoint کامل و روش احراز هویت را وارد کنید.
- پیکربندی را ذخیره کنید و منتظر بررسی اتصال بمانید.
- سرور را برای مجموعه ابزار پیش‌فرض خود فعال کنید.
یک مدیر می‌تواند از طریق مدیریت → Tools → MCP یک سرور را برای کل محیط ثبت کند.
احراز هویت و secret ها
AI-Corporate از OAuth کانکتور و secret های ایستا پشتیبانی می‌کند. توکن‌های OAuth، refresh token ها، API key ها و گذرواژه‌ها در storage فقط-سمت-سرور نگهداری می‌شوند. یک چت فقط connectorId ثبت‌شده را دریافت می‌کند، نه پیکربندی محرمانه را.
در صورت تغییر URL یا احراز هویت، پیکربندی جدید ابتدا دوباره بررسی می‌شود. اگر این بررسی ناموفق باشد، ممکن است یک پیکربندی که قبلاً تأیید شده بود تا زمان رفع مشکل فعال بماند.
مجوزهای ابزار و governance
فقط ابزارهایی را آزاد کنید که کارکنان واقعاً به آن‌ها نیاز دارند. یک سرور MCP می‌تواند عملیات خواندن و نوشتن ارائه دهد. AI-Corporate ابزارهای کشف‌شده را با یک allowlist سمت‌سرور فیلتر می‌کند و در هر استفاده، tenant، مالک و نقش را بررسی می‌کند. سازمان همچنان مسئول scope های مناسب، logging، دوره‌های نگهداری و مجوزدهی در سیستم منبع است.
سرورهای محلی دسکتاپ
یک سرور محلی stdio را در برنامه دسکتاپ نصب می‌کنید. renderer نباید shell command های دلخواه را اجرا کند: command، آرگومان‌ها، environment key ها و سطح دسترسی درخواستی محدود می‌شوند و قبل از تأیید نمایش داده می‌شوند. secret ها به‌صورت محلی رمزنگاری می‌شوند.
رفع اشکال
- endpoint در دسترس نیست: HTTPS، DNS، firewall و مسیر کامل
/mcpرا بررسی کنید. - نیاز به اتصال دوباره: اجازه OAuth یا secret ذخیره‌شده را تازه‌سازی کنید.
- مربوط به یک محیط دیگر است: کانکتور را دوباره در محیط فعلی ثبت کنید.
- هیچ ابزاری نمایش داده نمی‌شود: allowlist، دسترسی نقش و وضعیت فعال را بررسی کنید.
- فقط روی دسکتاپ کار می‌کند: احتمالاً سرور از stdio یا یک آدرس محلی استفاده می‌کند.
منابع توسعه
همچنین ببینید
هنگام ویرایش، پیکربندی ثبت‌شده سرور دریافت می‌شود. کلید ذخیره‌شده پنهان می‌ماند: فیلد کلید را خالی بگذارید تا همان را حفظ کند. در صورت تغییر URL یا روش احراز هویت، اتصال دوباره لازم است. خطا در یک ابزار MCP به این معنا نیست که همه ابزارهای آن سرور در دسترس نیستند.