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

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

آخرین بازبینی: ۱۷ آبان ۱۴۰۵

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

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

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

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

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

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

این سرویس:

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

آدرس سرویس

https://alphana.ir/mcp

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

هر چهار ابزار فقط‌خواندنی هستند، ورودی‌شان اعتبارسنجی و محدود می‌شود و خروجی را هم به‌صورت متن و هم به‌صورت داده ساخت‌یافته (structured content) برمی‌گردانند.

صفحه‌ها به‌عنوان Resource

هر صفحه مستندات یک MCP Resource از نوع text/markdown هم هست و آدرس آن همان canonical URL صفحه است؛ برای مثال https://alphana.ir/docs/sdk/tracker. clientهایی که Resource را پشتیبانی می‌کنند می‌توانند صفحه‌ها را فهرست کنند و مستقیماً به گفت‌وگو پیوست کنند.

اتصال به MCP Client

این سرویس از Streamable HTTP رسمی MCP در حالت stateless استفاده می‌کند و به درخواست‌ها با JSON پاسخ می‌دهد.

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

https://alphana.ir/mcp

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

اتصال در Claude

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

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

اتصال در Claude Code و Cursor

در Claude Code:

claude mcp add --transport http alphana https://alphana.ir/mcp

در Cursor، سرور را در فایل .cursor/mcp.json پروژه یا ~/.cursor/mcp.json اضافه کنید:

{
  "mcpServers": {
    "alphana": {
      "url": "https://alphana.ir/mcp"
    }
  }
}

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

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

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

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

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

برای مثال:

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

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