شروع کار با MCP Apps در Claude
خلاصهٔ کاملتر
MCP App یه رابط کاربری تعاملیه که سرور MCP شما (یعنی سروری که با پروتکل Model Context Protocol ابزار و داده در اختیار Claude میذاره) داخل گفتگو رندر میکنه، مثلاً یه نمودار یا نقشه. این اپها با MCP Apps SDK و بهعنوان بخشی از همون سرور ساخته میشن. راهنمای Claude برای توسعهدهندههایی نوشته شده که سرور MCP دارن و میخوان بهش UI اضافه کنن.
طبق این راهنما، یه MCP App میتونه کنار گفتگو تو side panel یا تمامصفحه باز بشه، از صفحه Artifacts بدون پرسیدن از Claude اجرا بشه و به سایدبار پین بشه. میتونه ابزارهایی ثبت کنه که Claude باهاشون چیزی که روی صفحه هست رو عوض کنه، از داخل اپ برای Claude پیام بفرسته، سایت خودتون رو تو یه iframe لود کنه و فایل روی دستگاه کاربر ذخیره کنه.
همه این قابلیتها شرط دارن. app tools، entry points و سایتهای embed شده فقط با کانکتوری کار میکنن که پشتش یه سرور remote باشه. برای کانکتورهای دایرکتوری، entry points و سایتهای embed شده فقط تو لیستینگ Verified در دسترسن. یعنی کسی که کانکتور شما رو از لیستینگ Community نصب کنه این دو تا رو نمیبینه، حتی اگه موقع تست با custom connector کار کرده باشن.
برای آشنایی، مخزن MCP Apps چند سرور نمونه داره، مثل Customer Segmentation، یه نقشه سهبعدی با CesiumJS، ShaderToy و Sheet Music. اینا رو با npx و از طریق فایل claude_desktop_config.json به Claude Desktop وصل میکنید:
{
"mcpServers": {
"map": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-map", "--stdio"]
}
}
}چون npx هر بار آخرین نسخه رو میگیره، راهنما پیشنهاد میده اگه قراره نگهش دارید نسخه رو پین کنید، مثلاً @modelcontextprotocol/server-map@2.0.1. ولی این نمونهها لوکال اجرا میشن، پس app tools و entry points رو باید با سرور خودتون بهعنوان custom connector تست کنید.
برای ساخت اپ خودتون، روی سرور ابزارها و منابع رو با registerAppTool() و registerAppResource() ثبت میکنید و تو اپ هم App.connect() رو بدون آرگومان transport صدا میزنید تا SDK خودش میزبان رو تشخیص بده. یعنی یه کد واحد هم تو Claude و هم تو میزبانهای دیگه اجرا میشه. فقط فیلد ui.domain برای Claude باید ۳۲ کاراکتر اول هش SHA-256 آدرس سرور شما باشه و بعدش .claudemcpcontent.com بیاد. برای کسایی که اپ OpenAI Apps SDK دارن هم یه راهنمای مهاجرت هست و یه پلاگین skill برای Claude Code که ساخت یا مهاجرت رو به ایجنت میسپره.
نکات کلیدی:
- MCP App رابط تعاملیایه که سرور MCP داخل گفتگوی Claude نشون میده
- app tools، entry points و سایتهای embed شده به سرور remote نیاز دارن
- entry points و سایتهای embed شده فقط تو لیستینگ Verified دایرکتوری فعالن
- registerAppTool() و registerAppResource() متادیتای هر میزبان رو خودکار میسازن
- ui.domain برای Claude برابر ۳۲ کاراکتر اول SHA-256 آدرس سرور بهاضافه .claudemcpcontent.com هست
- برای اپهای OpenAI Apps SDK راهنمای مهاجرت و skill آماده وجود داره




