اگر این روزها توسعه نرمافزار را با کمک ابزارهای هوش مصنوعی مثل Cursor، Claude Code یا Claude Desktop انجام میدهید احتمالاً این تجربه را داشتهاید: مدل با اطمینان کامل یک پارامتر یا آدرس وبسرویس را پیشنهاد میدهد اما وقتی تست میکنید متوجه میشوید بر اساس نسخهای قدیمی یا حتی نادرست از مستندات پاسخ داده است. در فرآیند اتصال به یک درگاه پرداخت، همین اشتباهات کوچک میتواند دردسرهای بزرگی بسازد. برای حل دقیق همین مسئله، زرینپال سرویس MCP را راهاندازی کرده است که پلی مستقیم میان دستیارهای هوشمند شما و مستندات رسمی و زندهی زرینپال است.
MCP چیست؟
Model Context Protocol (MCP) یک استاندارد باز است که به ابزارهای هوش مصنوعی اجازه میدهد بهجای تکیه بر دانشی که در زمان آموزش مدل ثابت شده، به منابع دادهی زنده و بهروز متصل شوند. به بیان ساده MCP یک زبان مشترک است که دستیار هوشمند شما را مستقیماً به منبع اطلاعات بدون واسطه و حدسوگمان متصل میکند.
چرا سرویس MCP زرینپال؟
مدلهای زبانی، دانش خود را در یک بازهی زمانی مشخص آموزش دیدهاند و از تغییرات بعدی مستندات بیخبرند. نتیجهی این محدودیت، پیشنهاد پارامترهای منسوخشده، آدرسهای وبسرویس اشتباه یا توضیح نادرست کدهای خطاست.سرویس MCP زرینپال دقیقاً همین شکاف را پر میکند: بهجای حدس زدن، دستیار هوشمند شما مستندات را همان لحظه و مستقیماً از وبسایت زرینپال میخواند. یعنی:
- همیشه همنسخه با مستندات منتشرشده روی سایت است و هر تغییری در مستندات، بیدرنگ در پاسخهای سرویس منعکس میشود.
- مستندات به زبان فارسی و شامل درگاه پرداخت، مستندات API، SDKها، افزونهها و فهرست کامل خطاهاست.
- بدون نیاز به کلید API یا احراز هویت است و بهصورت عمومی در اختیار همهی پذیرندگان قرار دارد.
آدرس اتصال به سرویس MCP
برای افزودن این سرویس به ابزار هوش مصنوعی مورد استفادهتان، کافی است آدرس زیر را در تنظیمات MCP وارد کنید: https://www.zarinpal.com/docs/mcp
ابزارهایی که در اختیار دستیار هوشمند شما قرار میگیرد
| ابزار | کاربرد |
| search_docs | جستوجوی متنی در تمام مستندات (فارسی یا انگلیسی) |
| get_doc | دریافت متن کامل یک صفحهی مشخص از مستندات |
| list_docs | فهرست تمام صفحات مستندات به تفکیک بخش |
| get_error_code | توضیح کدهای خطا و وضعیت وبسرویس پرداخت (مانند -9 یا -31) |
یک نمونه از تجربهی واقعی استفاده از MCP
بعد از اتصال سرویس به دستیار هوشمندتان، دیگر نیازی به جستوجو در تبهای مرورگر یا حدس زدن پارامترها نیست کافی است به زبان طبیعی بپرسید. برای نمونه:
- «چطور درخواست پرداخت با زرینپال در PHP بزنم؟»
- «خطای -51 یعنی چه؟»
- «تفاوت واحد پولی IRR و IRT در درگاه چیست؟»
دستیار هوشمند شما صفحهی مرتبط را در مستندات پیدا میکند و بر اساس همان متن رسمی پاسخ میدهد و لینک صفحهی مرجع را هم در اختیارتان میگذارد. یعنی پاسخی قابل استناد و راستیآزماییشده نه یک حدس محتمل.
جمعبندی
سرویس MCP زرینپال، فاصلهی میان «دستیار هوش مصنوعی حدسزن» و «دستیار هوش مصنوعی مطمئن» را برای توسعهدهندگانی که با زرینپال کار میکنند از بین میبرد. اگر میخواهید فرآیند اتصال درگاه پرداخت، رفع خطا یا یادگیری API زرینپال را با کمک هوش مصنوعی سریعتر و دقیقتر از همیشه انجام دهید وقت آن رسیده که این سرویس را به ابزار خود متصل کنید. برای راهنمای گامبهگام راهاندازی و اتصال سرویس به ابزارهای مختلف به مستندات رسمی MCP زرینپال مراجعه کنید.
