سرویس MCP آلفانا

دسترسی مستقیم دستیارهای هوش مصنوعی به مستندات رسمی و به‌روز SDK و Public API آلفانا.

MCP یا Model Context Protocol یک استاندارد باز برای اتصال ابزارهای هوش مصنوعی به منابع و ابزارهای خارجی است.

سرویس MCP آلفانا به دستیارهای کدنویسی مثل Cursor، Claude Code و سایر clientهای سازگار اجازه می‌دهد مستندات رسمی آلفانا را مستقیماً جست‌وجو و مطالعه کنند.

به‌جای اینکه مدل بر اساس اطلاعات قدیمی یا حافظه خودش حدس بزند، می‌تواند به همان مستنداتی دسترسی داشته باشد که در سایت آلفانا منتشر شده‌اند.

چرا از MCP آلفانا استفاده کنیم؟#

هنگام کدنویسی با کمک هوش مصنوعی، ممکن است مدل نام یک method، config یا endpoint قدیمی را پیشنهاد دهد.

MCP آلفانا این فاصله را کمتر می‌کند؛ دستیار شما می‌تواند مستندات deployشده و به‌روز آلفانا را بخواند و پاسخ را بر اساس منبع رسمی ارائه کند.

این سرویس:

با نسخه منتشرشده مستندات آلفانا همگام است
از جست‌وجوی فارسی و انگلیسی پشتیبانی می‌کند
مستندات SDK، Public API، Frameworkها، Feature Flag، Experiment، Growth و Behavior را پوشش می‌دهد
عمومی و فقط‌خواندنی است
برای استفاده به Alphana API Key نیاز ندارد
برای هر نتیجه، canonical URL صفحه رسمی را برمی‌گرداند

آدرس سرویس#

text

https://alphana.ir/mcp

ابزارهای در دسترس#

ابزار	کاربرد
`search_docs`	جست‌وجو در تمام مستندات آلفانا
`get_doc`	دریافت Markdown کامل یک صفحه
`list_docs`	دریافت فهرست مرتب صفحات، با امکان فیلتر بر اساس `section`
`get_api_endpoint`	دریافت metadata مربوط به endpointهای واقعی Public API

اتصال به MCP Client#

این سرویس از Streamable HTTP رسمی MCP استفاده می‌کند.

در هر client سازگار، کافی است یک Remote MCP Server با آدرس زیر اضافه کنید:

text

https://alphana.ir/mcp

مشخصات اتصال:

گزینه	مقدار
Transport	`Streamable HTTP`
Authentication	`None`
URL	`https://alphana.ir/mcp`

اتصال در Claude#

در Claude یا Claude Desktop به Settings → Connectors بروید، Add custom connector را انتخاب کنید، نام Alphana و URL بالا را وارد کنید و Add را بزنید. این سرویس عمومی است و نباید صفحه ورود، OAuth، API Key یا درخواست مجوز حساب نمایش دهد. پس از اتصال، چهار ابزار search_docs، get_doc، list_docs و get_api_endpoint باید نمایش داده شوند.

Remote MCP Server را مستقیماً در فایل claude_desktop_config.json وارد نکنید؛ Remote Connectorهای Claude از بخش Connectors مدیریت می‌شوند.

رفع اشکال اتصال#

اگر Claude پیام «Couldn’t reach» نشان داد:

مطمئن شوید URL دقیقاً https://alphana.ir/mcp است و فاصله یا مسیر اضافه ندارد.
URL را حذف و دوباره به‌عنوان Streamable HTTP بدون Authentication اضافه کنید.
زمان خطا و Reference نمایش‌داده‌شده توسط Claude را برای پشتیبانی آلفانا ارسال کنید.
هرگز API Key آلفانا، Cookie، Token یا اطلاعات حساب را برای رفع اشکال MCP ارسال نکنید.

برای اضافه‌کردن Remote MCP URL، از راهنمای همان نسخه‌ای که روی سیستم شما نصب است استفاده کنید.

چه سؤال‌هایی می‌توانید بپرسید؟#

برای مثال:

«چطور آلفانا را در Next.js نصب کنم؟»
«چطور با useTrackGoal یک Conversion ثبت کنم؟»
«برای دریافت KPI نشست‌ها از چه endpointی استفاده کنم؟»
«Feature Flag در SDK چطور ارزیابی می‌شود؟»

دستیار هوش مصنوعی باید canonical URL برگشتی ابزار را به‌عنوان منبع پاسخ ارائه کند.