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

برای اتصال سرویس MCP فینوپال به دستیار هوشمند فقط آدرس سرویس لازم است. معرفی ابزارها در صفحه سرویس MCP است.

https://finopal.ir/docs/mcp

Claude Code

این دستور را در ترمینال اجرا کنید. سرویس با نام finopal-docs اضافه می‌شود. برای بررسی اتصال از claude mcp list استفاده کنید.

claude mcp add --transport http finopal-docs https://finopal.ir/docs/mcp

Cursor

از Settings، بخش MCP، گزینه Add Server را باز کنید، یا فایل ~/.cursor/mcp.json را ویرایش کنید.

{
  "mcpServers": {
    "finopal-docs": {
      "url": "https://finopal.ir/docs/mcp"
    }
  }
}

Claude Desktop

از Settings، بخش Developer، گزینه Edit Config را باز کنید و این بلوک را در claude_desktop_config.json بگذارید. بعد برنامه را یک‌بار ببندید و باز کنید. آیکون ابزارها باید finopal-docs را نشان دهد.

{
  "mcpServers": {
    "finopal-docs": {
      "type": "http",
      "url": "https://finopal.ir/docs/mcp"
    }
  }
}

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

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

سرویس نشست نگه نمی‌دارد. به شناسه نشست یا اتصال دائمی نیاز ندارد و پشت CDN یا لودبالانسر بدون تنظیم اضافه کار می‌کند.

رفع اشکال

سرویس در فهرست ابزارها دیده نمی‌شود

آدرس https://finopal.ir/docs/mcp/health باید JSON با مقدار "status": "ok" برگرداند.

پاسخ‌ها با سایت یکی نیست

متن سرویس از همین صفحات منتشرشده خوانده می‌شود. اگر صفحه‌ای را تازه عوض کرده‌اید، چند دقیقه بعد دوباره بپرسید.

خطای اتصال در شبکه سازمانی

مطمئن شوید دامنه finopal.ir برای ابزار شما باز است.