راهنمای استفاده از سرویس MCP

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

https://www.zarinpal.com/docs/mcp

Claude Code

اگر از Claude Code (opens new window) استفاده می‌کنید، دستور زیر را در ترمینال اجرا کنید:

claude mcp add --transport http zarinpal-docs https://www.zarinpal.com/docs/mcp

پس از اجرای دستور، سرویس با نام zarinpal-docs به فهرست سرورهای MCP افزوده می‌شود. برای اطمینان از اتصال می‌توانید از دستور claude mcp list استفاده کنید.

Cursor

در Cursor فایل تنظیمات MCP را از مسیر Settings → MCP → Add Server (یا ویرایش فایل ~/.cursor/mcp.json) باز کرده و تنظیمات زیر را اضافه کنید:

{
  "mcpServers": {
    "zarinpal-docs": {
      "url": "https://www.zarinpal.com/docs/mcp"
    }
  }
}

Claude Desktop

در Claude Desktop فایل تنظیمات را باز کنید (Settings → Developer → Edit Config) و بلوک زیر را به فایل claude_desktop_config.json اضافه کنید:

{
  "mcpServers": {
    "zarinpal-docs": {
      "type": "http",
      "url": "https://www.zarinpal.com/docs/mcp"
    }
  }
}

پس از ذخیره فایل، برنامه را یک‌بار ببندید و دوباره باز کنید؛ آیکون ابزارها (Tools) باید سرویس zarinpal-docs را نشان دهد.

سایر ابزارهای سازگار با MCP

هر ابزاری که از نسخه Streamable HTTP پروتکل MCP پشتیبانی می‌کند، با آدرس سرویس به‌صورت مستقیم کار می‌کند. در تنظیمات ابزار خود، یک سرور MCP از نوع http با آدرس بالا اضافه کنید.

نکته

سرویس به‌صورت stateless عمل می‌کند؛ بنابراین به شناسه نشست (Session) یا ماندگاری اتصال نیازی ندارد و پشت هر CDN یا Load Balancer بدون تنظیم اضافه کار می‌کند.

رفع اشکال

• سرویس در فهرست ابزارها دیده نمی‌شود: ابتدا وضعیت سرویس را بررسی کنید؛ آدرس https://www.zarinpal.com/docs/mcp/health باید پاسخ JSON با مقدار "status": "ok" برگرداند.
• پاسخ‌ها قدیمی به نظر می‌رسند: نسخه مستندات پشتیبان سرویس در پاسخ همان آدرس health (مقادیر gitSha و builtAt) قابل مشاهده است و همیشه با آخرین نسخه منتشرشده سایت هم‌نسخه است.
• خطای اتصال در شبکه سازمانی: در صورت فیلترینگ شبکه، مطمئن شوید دامنه www.zarinpal.com برای ابزار شما در دسترس است.