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