MCP: Claude Code را به ابزارهای شما متصل کنید
Model Context Protocol یک استاندارد باز برای اتصال هوش مصنوعی به ابزارهای توسعه است؛ Claude Code از آن برای آوردن داده‌ها و ابزارهای خارجی به نشست استفاده میکند.
MCP چیست؟
MCP (Model Context Protocol) یک استاندارد باز از Anthropic است که به دستیارهای هوش مصنوعی اجازه میدهد به‌صورت امن به منابع داده و ابزارهای خارجی متصل شوند. با MCP، Claude Code میتواند بدون کپی‌پیست دستی، مستقیماً از پایگاه‌های داده پرس‌وجو کند، به GitHub دسترسی داشته باشد، مستندات را جست‌وجو کند و مرورگرها را کنترل کند.
برنامه هوش مصنوعی
برنامه‌هایی که با مدل‌هایی مانند Claude هدایت می‌شوند و از طریق MCP به ابزارها و منابع داده خارجی متصل می‌شوند. Claude Code، موضوع این راهنما، کدبیس شما را می‌خواند، فایل‌ها را ویرایش میکند، دستورها را اجرا میکند و با ابزارهای توسعه شما یکپارچه می‌شود.
ابزارها و منابع داده
قابلیت‌های خارجی که از طریق MCP Servers ارائه می‌شوند. سرورها کارکرد خود را از طریق سه عنصر سازنده ارائه میدهند: ابزارهایی که مدل میتواند فراخوانی کند، منابع قابل خواندن، و قالب‌های prompt ساختاریافته.
مفاهیم اصلی MCP: میزبان، کلاینت و سرور
MCP اکوسیستم را به میزبان‌ها، کلاینت‌ها و سرورها تقسیم میکند: برنامه میزبان دسترسی را هماهنگ میکند، هر کلاینت اتصال اختصاصی خود را به یک سرور نگه می‌دارد و سرورها داده‌ها و ابزارهای بیرونی را به توانمندی‌های پروتکل تبدیل می‌کنند.
میزبان MCP
برنامه هوش مصنوعی که مستقیماً از آن استفاده میکنید: یک یا چند کلاینت MCP و دسترسی آنها را هماهنگ و مدیریت میکند.
کلاینت MCP
مؤلفه پروتکلی که میزبان برای هر سرور ایجاد میکند: اتصال اختصاصی را نگه می‌دارد و نیازهای برنامه را به درخواست و پاسخ تبدیل میکند.
سرور MCP
برنامه‌ای مستقل که زمینه را در اختیار کلاینت‌ها قرار میدهد و توانمندی‌های بیرونی را از طریق مؤلفه‌های پایه tools، resources و prompts در دسترس می‌گذارد.
سرورهای MCP پرکاربرد
اکوسیستم MCP در حال حاضر فایل‌ها، مخازن، پایگاه‌های داده، مرورگرها، پایش خطا و همکاری تیمی را در بر میگیرد. علاوه بر سرورهای مرجع که گروه راهبری MCP نگهداری میکند (بررسیشده در 2026-10-20)، سرورهای انجمن و ارائه‌دهندگان نیز پیوسته رشد می‌کنند؛ چند نمونه رایج در ادامه آمده است.
سرور Filesystem
خواندن/نوشتن فایل‌های محلی، جست‌وجو و مدیریت ساختار پوشه‌ها
سرور GitHub
مدیریت مخازن، PRها، issueها و جست‌وجوی کد
سرور پایگاه داده
کوئری مستقیم پایگاه‌های داده، تحلیل schemaها و تولید SQL
سرور مرورگر
کنترل مرورگرها برای تست خودکار و تعامل وب
پایش خطای Sentry
مشاهده لاگ‌های خطا، تحلیل stack traceها و مکان‌یابی خودکار باگ‌ها
پیام‌رسانی Slack
ارسال پیام، جست‌وجوی تاریخچه کانال و مدیریت اعلان‌های گردش کار
پیکربندی MCP در Claude Code
مستندات رسمی چند روش را فهرست میکند: claude mcp add برای یک فرمان راه‌اندازی، claude mcp add-json برای یک ورودی JSON، یا ویرایش مستقیم .mcp.json (پروژه) و ~/.claude.json (محلی و کاربر).
لایه انتقال stdio: فرایندهای سرور محلی
با stdio، کلاینت سرور را بهعنوان یک زیرفرایند اجرا میکند و پیام‌ها را از طریق ورودی و خروجی استاندارد مبادله میکند. این روش برای ابزارهایی مناسب است که به دسترسی مستقیم به ماشین شما نیاز دارند: کافی است فرمان اجرا و آرگومان‌های آن را ارائه دهید، مانند نمونه npx filesystem.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/project"
]
}
}
}لایه انتقال SSE برای سرورهای راه دور
SSE کلاینت‌ها را از طریق HTTP به سرورهای راه دور متصل میکند. مستندات Claude Code آن را منسوخ اعلام کرده و در صورت وجود، لایه انتقال HTTP را توصیه میکند؛ با این حال، برخی سرویس‌ها فقط یک نقطه پایانی SSE ارائه میدهند و همین چیزی است که این پیکربندی نمونه تنظیم میکند (بررسیشده در 2026-10-20). Claude Code ابتدا لایه انتقال HTTP را امتحان میکند و وقتی سرور آن را نپذیرد به SSE سوئیچ میکند؛ سوئیچ خودکار به Claude Code v2.1.265 یا جدیدتر نیاز دارد.
{
"mcpServers": {
"remote-server": {
"type": "sse",
"url": "https://mcp.example.com/sse",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}بهترین شیوه‌های امنیتی MCP
سرورهای MCP دسترسی قدرتمندی به سیستم دارند — پیکربندی امنیتی مناسب حیاتی است
کمترین سطح دسترسی
فقط حداقل مجوزهای لازم را اعطا کنید — از حساب‌های root یا admin خودداری کنید
بررسی منابع سرور
فقط از سرورهای رسمی یا مورد اعتماد که جامعه نگهداری میکند استفاده کنید — کد منبع و وابستگی‌ها را بررسی کنید
جداسازی شبکه
دسترسی شبکه سرور را محدود کنید — از اتصال به نقاط پایانی خارجی غیرقابل اعتماد جلوگیری کنید
لاگ‌گیری ممیزی
لاگ‌گیری فراخوانی‌های MCP را فعال کنید و سوابق فراخوانی ابزارها را بهطور منظم برای یافتن ناهنجاری‌ها بررسی کنید
پرسش‌های متداول
آیا برای استفاده از یک سرور MCP موجود باید کد بنویسم؟
استفاده از یک سرور موجود نیازی به کدنویسی ندارد: سرورهای مرجع نگهداری‌شده در مخزن رسمی با یک فرمان npx که به پیکربندی شما افزوده می‌شود راه‌اندازی می‌شوند. فقط زمانی خودتان سرور می‌نویسید که بخواهید سیستم‌های خود را از طریق SDK در دسترس قرار دهید.
پیکربندی سرور MCP در کدام فایل قرار میگیرد؟
ورودیهای local و user در فایل .claude.json در پوشه خانه شما قرار میگیرند؛ ورودیهای project در فایل .mcp.json در ریشه مخزن قرار میگیرند، جایی که کنترل نسخه میتواند آنها را به اشتراک بگذارد. فرمان claude mcp add بهطور پیشفرض دامنه local را مینویسد، پس با --scope دامنه دیگری انتخاب کنید. بررسیشده با مستندات رسمی در 2026-10-20. در یک ورودی JSON، فیلد type مقدار streamable-http را بهعنوان نام مستعار http میپذیرد، اما url بدون type یک خطای پیکربندی است: Claude Code آن سرور را نادیده میگیرد و گزارش میدهد که ورودی url دارد ولی type ندارد.
برای سرور MCP راه دور، HTTP یا SSE؟
برای اتصالهای راه دور جدید HTTP را انتخاب کنید: مستندات، سرورهای HTTP را بهعنوان روش توصیهشده برای دسترسی به سرورهای MCP راه دور فهرست میکند. SSE در همان صفحه منسوخ علامتگذاری شده است، پس آن را برای سرویسهایی نگه دارید که چیز دیگری منتشر نمیکنند. بررسیشده در 2026-10-20. Claude Code ابتدا HTTP را امتحان میکند و وقتی سرور آن را نپذیرد به SSE سوئیچ میکند، و این سوئیچ به v2.1.265 یا جدیدتر نیاز دارد.
وقتی سروری متصل نمی‌شود چه چیزهایی را بررسی کنید
ابتدا claude mcp list را اجرا کنید: Connected یعنی سرور فعال است، Needs authentication یعنی ورود انجام نشده، و Failed to connect یعنی خطای واقعی اتصال. سپس claude mcp get همراه با نام سرور، یا /mcp در داخل یک نشست، جزئیات را نشان میدهد. اگر سمت مدل شما از طریق یک دروازه عبور میکند، توجه کنید که جست‌وجوی ابزار MCP بهطور پیشفرض خاموش است و به تنظیم صریح ENABLE_TOOL_SEARCH نیاز دارد. بررسیشده در 2026-10-20. یک سرور با دامنه project از فایل .mcp.json در یک نشست تعاملی به‌صورت در انتظار تأیید نمایش داده می‌شود، و یک مخزن کلون‌شده نمی‌تواند سرورهای خودش را تأیید کند تا زمانی که به آن فضای کاری اعتماد کنید.
آیا MCP فقط برای Claude Code است؟
خیر. MCP یک استاندارد باز است و ورودیهای سرور به یک کلاینت گره نمیخورند. مستندات توضیح میدهند چگونه سروری را که برای Claude Desktop، Cursor یا هر کلاینت MCP دیگر نوشته شده منتقل کنید: URL آن، فرمان اجرای آن یا بلوک JSON آن را بردارید. بررسیشده در 2026-10-20. مستندات فرمان اختصاصی این کار را ارائه میدهند: claude mcp add-from-claude-desktop یک دیالوگ باز میکند که در آن سرورهایی را که میخواهید وارد کنید انتخاب میکنید.
دسته‌های ابزاری که می‌توانید متصل کنید
بر اساس کاربرد، سرورهای رایج در چهار دسته زیر قرار میگیرند. قدرت واقعی MCP زمانی آشکار می‌شود که چندین سرور با هم کار کنند و قابلیت‌های تخصصی خود را از طریق یک رابط یکپارچه ترکیب کنند.
ابزارهای توسعه و کد
پلتفرم‌های Git و میزبانی کد را متصل کنید تا مخازن را بخوانید، جست‌وجو و دستکاری کنید و کامیت‌ها، شاخه‌ها و بازبینی‌ها را به گفتگو بیاورید.
داده و ذخیره‌سازی
عملیات امن فایل را با کنترل‌های دسترسی قابل پیکربندی انجام دهید، دایرکتوری‌ها را مدیریت کنید و به پایگاه‌های داده متصل شوید تا داده‌ها را کوئری کرده و اسکیماها را بررسی کنید.
همکاری و پیام‌رسانی
فضاهای کاری Slack را یکپارچه کنید: کانال‌ها را فهرست کنید، پیام بفرستید، به رشته‌پیام‌ها پاسخ دهید، واکنش اضافه کنید و تاریخچه کانال را بخوانید تا تیم هماهنگ بماند.
خدمات وب و اطلاعات
سرورهایی مانند Fetch واکشی و تبدیل محتوای وب را برای استفاده کارآمد از LLM انجام میدهند؛ سرورهای مشابه معمولاً برای جست‌وجو و یافتن مستندات به کار می‌روند.
استفاده از MCP از طریق QCode.cc
MCP به اتصال متفاوتی نیاز ندارد: همان کلید، همان نقطه پایانی، و بلوک mcpServers فقط در پروژه شما قرار میگیرد.
سمت ابزار و سمت مدل جدا از هم باقی می‌مانند
سرورهای MCP در پیکربندی خود Claude Code قرار میگیرند: ورودیهای local و user در .claude.json و ورودیهای project در .mcp.json. محل ارسال درخواست‌های مدل شما تنظیمی جداگانه است، بنابراین این دو هرگز روی یکدیگر نوشته نمی‌شوند. بررسیشده در 2026-10-20.
اعتبارنامه‌های مدل شما می‌مانند
افزودن یک سرور MCP، کلید و نقطه پایانی‌ای که QCode صادر کرده است را دست‌نخورده باقی می‌گذارد. هر سرور اسرار خود را در فیلدهای env یا headers نگه می‌دارد و مستندات اشاره میکند که --env چندین جفت KEY=value را هم‌زمان میپذیرد. این دو نوع اعتبارنامه هرگز جای یکدیگر را نمی‌گیرند. بررسیشده در 2026-10-20.
اشتراک‌گذاری سرورها از طریق مخزن
یک تیم میتواند با یک فهرست سرور کار کند: آن را در .mcp.json در ریشه مخزن کامیت کنید. برای ایمنی، Claude Code از شما می‌خواهد هر سرور پروژه را پیش از استفاده در یک نشست تعاملی تأیید کنید و claude mcp reset-project-choices این تأییدها را پاک میکند. بررسیشده در 2026-10-20.
QCode همچنین از OpenAI Codex / GPT-5.6 پشتیبانی میکند
سهمیه QCode شما در Claude Code و OpenAI Codex CLI کار میکند — یک موجودی مشترک، صفر هزینه تکراری.
شروع استفاده از MCP با Claude Code
از تمام توانمندی‌های اکوسیستم MCP با هزینه کم بهره‌مند شوید
به‌روزرسانی شده 2026-11-14
ایجاد حساب کاربری QCode
یک کلید برای Claude، GPT و مدل‌های چینی، با صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models.