راه‌اندازی سرورهای MCP آماده

این راهنما برای هر سرور MCP آمادهٔ «مرکز اپ‌ها» قدم‌به‌قدم توضیح می‌دهد چه چیزی را کجا فعال کنید، کدام توکن را از کجا بسازید و کدام روش ورود را انتخاب کنید تا ایجنت تسکیـ بتواند از ابزارهای آن سرویس استفاده کند. همین قدم‌ها، کوتاه‌تر، کنار فرم اتصال هر سرور در مرکز اپ‌ها هم نمایش داده می‌شوند.

پیش از شروع

اتصال سرور MCP بیرونی را فقط مدیر فضای کاری می‌تواند بسازد و این قابلیت به پلن فضای کاری بستگی دارد. مرکز اپ‌ها را باز کنید، به بخش «سرورهای MCP» بروید و سرور موردنظر را انتخاب کنید. نشانی سرور و روش پیشنهادی احراز هویت خودکار پر می‌شود و شما فقط اطلاعات ورود را کامل می‌کنید.

• ورود خودکار: سریع‌ترین روش برای سرورهایی که از آن پشتیبانی می‌کنند (مثل Notion، Linear، GitLab، Stripe، Sentry و Cloudflare). تسکیـ خودش را در سرویس ثبت می‌کند و شما فقط در صفحهٔ ورود سرویس دسترسی را تأیید می‌کنید؛ ساختن اپ OAuth لازم نیست.
• اپ OAuth خودتان: برای سرویس‌هایی مثل Slack و گوگل که ثبت خودکار ندارند. یک اپ OAuth در سرویس می‌سازید، «نشانی بازگشت» نمایش‌داده‌شده در فرم را در آن ثبت می‌کنید و Client ID و Client Secret را وارد می‌کنید.
• توکن یا هدر: برای سرویس‌هایی که کلید API یا توکن شخصی می‌پذیرند؛ توکن را می‌سازید و در فرم وارد می‌کنید. همهٔ اطلاعات ورود رمزنگاری‌شده ذخیره می‌شوند.
• روشن کردن ابزارها: پس از اتصال، ابزارهای کشف‌شده معمولاً خاموش‌اند. صفحهٔ اتصال را باز کنید و فقط ابزارهایی را که ایجنت مجاز به استفاده از آن‌هاست روشن کنید.
• مسیر شبکه: درخواست‌ها به سرویس‌های خارجی از مسیر خروجی سامانه و درخواست‌ها به دامنه‌های .ir مستقیم فرستاده می‌شوند. اگر سرور خودمیزبان شما داخل ایران است ولی دامنه‌اش .ir نیست، در «تنظیمات پیشرفته» مسیر شبکه را روی «مستقیم» بگذارید.

Slack

نشانی سرور: https://mcp.slack.com/mcp

1. به api.slack.com/apps بروید، Create New App → From scratch را بزنید و فضای کاری اسلک را انتخاب کنید.
2. در نوار کناری اپ، بخش Agents را باز کنید و گزینهٔ «Slack Model Context Protocol (MCP) Server» را روشن کنید.
3. در OAuth & Permissions، نشانی بازگشت (Redirect URL) پایین همین صفحه و دسترسی‌های User Token فیلد Scopes را اضافه کنید.
4. از Basic Information، مقدار Client ID و Client Secret را در «اپ OAuth خودتان» وارد کنید، «اتصال با OAuth» را بزنید و دسترسی را تأیید کنید.

اسلک فقط به اپ‌های داخلی یا منتشرشده در Marketplace اجازهٔ استفاده از سرور MCP را می‌دهد و ممکن است مدیر فضای کاری اسلک باید اپ را تأیید کند.

Mattermost

نشانی سرور: https://your-server/plugins/mattermost-ai/mcp-server/mcp

1. روی سرور Mattermost (نسخهٔ ۱۱٫۲ یا بالاتر)، افزونهٔ Agents را به آخرین نسخه به‌روز کنید.
2. در System Console → Plugins → Agents → Model Context Protocol (MCP)، گزینهٔ «Enable Mattermost MCP Server (HTTP)» را روی True بگذارید.
3. نشانی سرور را به شکل https://your-server/plugins/mattermost-ai/mcp-server/mcp وارد کنید.
4. برای توکن: در System Console → Integrations → Integration Management گزینهٔ Personal Access Tokens را فعال کنید، سپس از Profile → Security → Personal Access Tokens یک توکن بسازید و آن را به‌عنوان «توکن Bearer» وارد کنید.
5. برای ورود خودکار: در Integration Management گزینه‌های «OAuth 2.0 Service Provider» و «OAuth 2.0 Dynamic Client Registration» را روشن کنید و OAuth 2.0 → «ورود خودکار» را انتخاب کنید.

اگر سرور Mattermost شما داخل ایران است ولی دامنه‌اش .ir نیست، در «تنظیمات پیشرفته» مسیر شبکه را روی «مستقیم» بگذارید.

Notion

نشانی سرور: https://mcp.notion.com/mcp

1. OAuth 2.0 → «ورود خودکار» را انتخاب کنید و «اتصال» را بزنید.
2. وارد نوشن شوید، فضای کاری و صفحه‌هایی را که می‌خواهید در اختیار دستیار باشد انتخاب کنید و تأیید کنید.

سرور MCP نوشن فقط با ورود کار می‌کند و کلید Integration داخلی نوشن برای آن قابل استفاده نیست.

Google Calendar

نشانی سرور: https://calendarmcp.googleapis.com/mcp/v1

1. این سرور در مرحلهٔ پیش‌نمایش است؛ گوگل ورک‌اسپیس شما باید عضو Workspace Developer Preview Program باشد.
2. در Google Cloud Console، سرویس‌های Google Calendar API و Calendar MCP API (calendarmcp.googleapis.com) را فعال کنید.
3. در Google Auth Platform بخش‌های Branding و Audience را تنظیم کنید و در Data Access دسترسی‌های فیلد Scopes را اضافه کنید.
4. در بخش Clients یک کلاینت از نوع Web application بسازید و نشانی بازگشت پایین همین صفحه را به آن اضافه کنید.
5. مقدار Client ID و Client Secret را در «اپ OAuth خودتان» وارد کنید و متصل شوید.

Google Drive

نشانی سرور: https://drivemcp.googleapis.com/mcp/v1

1. این سرور در مرحلهٔ پیش‌نمایش است؛ گوگل ورک‌اسپیس شما باید عضو Workspace Developer Preview Program باشد.
2. در Google Cloud Console، سرویس‌های Google Drive API و Drive MCP API (drivemcp.googleapis.com) را فعال کنید.
3. در Google Auth Platform بخش‌های Branding و Audience را تنظیم کنید و در Data Access دسترسی‌های فیلد Scopes را اضافه کنید.
4. در بخش Clients یک کلاینت از نوع Web application بسازید و نشانی بازگشت پایین همین صفحه را به آن اضافه کنید.
5. مقدار Client ID و Client Secret را در «اپ OAuth خودتان» وارد کنید و متصل شوید.

دستیار فقط فایل‌هایی را می‌بیند که حساب واردشده در درایو به آن‌ها دسترسی دارد.

Linear

نشانی سرور: https://mcp.linear.app/mcp

1. OAuth 2.0 → «ورود خودکار» را انتخاب کنید، «اتصال» را بزنید و در Linear تأیید کنید.
2. یا از Linear → Settings → Account → Security & Access یک کلید API شخصی بسازید، «توکن Bearer» را انتخاب کنید و کلید را وارد کنید.

برای دسترسی فقط‌خواندنی، به کلید API فقط مجوز Read بدهید.

GitHub

نشانی سرور: https://api.githubcopilot.com/mcp/

1. در GitHub → Settings → Developer settings → Personal access tokens یک توکن fine-grained برای مخزن‌های موردنیاز بسازید.
2. توکن را به‌عنوان «توکن Bearer» وارد کنید و متصل شوید.
3. یا با اپ OAuth: در Developer settings → OAuth Apps → New OAuth App، نشانی Callback را برابر نشانی بازگشت پایین همین صفحه بگذارید و Client ID و Client Secret آن را در «اپ OAuth خودتان» وارد کنید.

نسخهٔ GitHub Enterprise Server سرور MCP میزبانی‌شده ندارد.

GitLab

نشانی سرور: https://gitlab.com/api/v4/mcp

1. در GitLab.com مالک گروه سطح‌بالا از Settings → General → Permissions and group features → MCP client access اتصال کلاینت‌های MCP را مجاز می‌کند؛ در نسخهٔ خودمیزبان، مدیر سرور آن را فعال می‌کند.
2. برای نسخهٔ خودمیزبان، در نشانی سرور به‌جای gitlab.com دامنهٔ خودتان را بنویسید.
3. OAuth 2.0 → «ورود خودکار» را انتخاب کنید، «اتصال» را بزنید و در GitLab تأیید کنید.

سرور MCP گیت‌لب در مرحلهٔ بتا است.

Stripe

نشانی سرور: https://mcp.stripe.com

1. مدیر حساب استرایپ دسترسی MCP را از dashboard.stripe.com/settings/mcp-and-cli-access مجاز می‌کند.
2. OAuth 2.0 → «ورود خودکار» را انتخاب کنید، «اتصال» را بزنید و در استرایپ تأیید کنید.
3. یا در Developers → API keys یک کلید محدود با گزینهٔ «Authorize agent access to your account» بسازید و آن را به‌عنوان «توکن Bearer» وارد کنید.

از ۹ آبان ۱۴۰۵ (۳۱ اکتبر ۲۰۲۶) سرور MCP استرایپ کلیدهای Secret کامل و کلیدهای محدود معمولی را نمی‌پذیرد؛ از کلید Agent استفاده کنید و اول با کلید حالت تست امتحان کنید.

Sentry

نشانی سرور: https://mcp.sentry.dev/mcp

1. OAuth 2.0 → «ورود خودکار» را انتخاب کنید، «اتصال» را بزنید و در Sentry تأیید کنید.
2. یا از Sentry → User Settings → Personal Tokens یک توکن با دسترسی‌های org:read و project:read بسازید.
3. «هدر سفارشی» را انتخاب کنید، نام هدر را Authorization نگه دارید و مقدار را به شکل «Sentry-Bearer توکن‌شما» وارد کنید.

توکن Bearer ساده کار نمی‌کند، چون Sentry آن را برای ورود خودش نگه داشته است. Sentry خودمیزبان با این سرور پشتیبانی نمی‌شود.

Cloudflare

نشانی سرور: https://mcp.cloudflare.com/mcp

1. OAuth 2.0 → «ورود خودکار» را انتخاب کنید، «اتصال» را بزنید و در کلادفلر تأیید کنید.
2. یا از dash.cloudflare.com/profile/api-tokens یک API Token فقط با مجوزهای لازم بسازید، «توکن Bearer» را انتخاب کنید و آن را وارد کنید.

سرورهای محصولی مثل observability.mcp.cloudflare.com/mcp را می‌توانید با «سرور دلخواه» اضافه کنید. توکن‌هایی که فیلتر IP دارند پشتیبانی نمی‌شوند.

AWS Knowledge

نشانی سرور: https://knowledge-mcp.global.api.aws

1. ورود لازم نیست: «بدون احراز هویت» را نگه دارید و «اتصال» را بزنید.
2. ابزارهای این سرور در مستندات AWS، دسترس‌پذیری منطقه‌ای سرویس‌ها و بهترین روش‌ها جستجو می‌کنند.

این سرور به حساب AWS شما دسترسی ندارد. سرور MCP سطح حساب AWS به پروکسی امضای محلی نیاز دارد که اینجا پشتیبانی نمی‌شود.

آروان‌کلاد (ArvanCloud)

نشانی سرور: https://your-domain/mcp

1. در پنل آروان‌کلاد از بخش کاربران ماشینی (Machine User) یک کاربر بسازید، دسترسی‌های لازم را به آن بدهید و کلید API آن را بردارید؛ این کلید فقط یک‌بار نمایش داده می‌شود.
2. مخزن github.com/dwin-gharibi/arvancloud-mcp را روی سرور خودتان بگیرید و با Docker اجرا کنید: docker build -t arvancloud-mcp . و سپس docker run -p 8000:8000 -e ARVAN_API_KEY=… -e ARVAN_READ_ONLY=true arvancloud-mcp
3. سرور را پشت یک پروکسی معکوس HTTPS (مثل Nginx) بگذارید که درخواست‌های بدون هدر مخفی X-Api-Key را رد کند؛ خود این سرور هیچ احراز هویتی ندارد.
4. نشانی سرور را به شکل https://دامنه‌شما/mcp وارد کنید، «هدر سفارشی» را با نام X-Api-Key و همان مقدار مخفی انتخاب کنید و متصل شوید.

این سرور رسمی آروان‌کلاد نیست و ابزارهایی مثل اجرای فرمان SSH دارد؛ تا وقتی لازم نشده ARVAN_READ_ONLY=true را نگه دارید.

Zapier

نشانی سرور: https://mcp.zapier.com/api/v1/connect

1. در mcp.zapier.com یک سرور MCP بسازید، «Other» را به‌عنوان کلاینت انتخاب کنید و اکشن‌های موردنیاز را اضافه کنید.
2. از بخش Connect یک توکن بسازید (فقط یک‌بار نمایش داده می‌شود)، «توکن Bearer» را انتخاب کنید و آن را وارد کنید.
3. یا OAuth 2.0 → «ورود خودکار» را انتخاب کنید.

هر فراخوانی ابزار دو Task از سهمیهٔ زپیر مصرف می‌کند.

اگر اتصال برقرار نشد

• خطای ۴۰۱ یا ۴۰۳: توکن منقضی شده یا دسترسی کافی ندارد. توکن تازه بسازید یا دوباره با OAuth وارد شوید، سپس «بررسی دوباره» را بزنید.
• «این سرور ورود نمی‌خواهد»: سرور بدون احراز هویت کار می‌کند؛ روش «بدون احراز هویت» را انتخاب کنید.
• «این سرور از ورود خودکار پشتیبانی نمی‌کند»: از «اپ OAuth خودتان» یا «چسباندن توکن» استفاده کنید.
• خطای اتصال یا مهلت پاسخ: نشانی سرور را بررسی کنید؛ برای سرور خودمیزبان، مسیر شبکه را در صفحهٔ اتصال بین «مستقیم» و «از طریق پروکسی» عوض کنید و دوباره بررسی کنید.
• ابزارها کار نمی‌کنند: مطمئن شوید ابزارهای موردنیاز در صفحهٔ اتصال روشن‌اند؛ ایجنت ابزار خاموش را نمی‌بیند.

برای آشنایی کلی با این قابلیت، راهنمای اتصال سرورهای MCP بیرونی به ایجنت و برای سطح ریسک ابزارها و تأیید پیش از اجرا، راهنمای «مدیریت ابزارها و ایمنی MCP» را بخوانید.