اتصال عامل هوشمند به تقویم مالی با MCP
عامل‌های هوشمند برای کارهای مالی باید بدانند امروز روز کاری است یا نه، تسویه کی انجام می‌شود و سررسید کجا می‌افتد. سرور MCP تقویم مالی همین قابلیت‌ها را به‌صورت ابزارهای فقط‌خواندنی در اختیار عامل می‌گذارد.
مدل‌های زبانی تقویم ایران را «حدس» می‌زنند؛ و در محاسبات مالی، حدس کافی نیست. سرور MCP تقویم مالی ایران اوپن فاینانس به عامل‌های هوشمند اجازه می‌دهد به‌جای حدس، از همان موتوری استفاده کنند که API، کیت توسعه و خط فرمان پلتفرم را اجرا می‌کند.
نشانی سرور
https://iranopenfinance.com/mcpسرور از پروتکل Streamable HTTP استفاده می‌کند، به کلید نیاز ندارد و همه ابزارهایش فقط‌خواندنی‌اند.
افزودن به Claude Code
claude mcp add --transport http iof-calendar https://iranopenfinance.com/mcpبرای ابزارهای دیگری که از MCP پشتیبانی می‌کنند، همین نشانی را به‌عنوان یک سرور HTTP اضافه کنید:
{
"mcpServers": {
"iof-calendar": { "type": "http", "url": "https://iranopenfinance.com/mcp" }
}
}ابزارها
| ابزار | کاربرد |
|---|---|
calendar_day | سه تقویم، مناسبت‌ها و روز کاری بودن یک روز |
calendar_business_days | تعداد روز کاری بین دو تاریخ |
calendar_settlement | تاریخ تسویه T+n |
calendar_add | مهلت بر پایه روز کاری یا تقویمی |
calendar_adjust | انتقال تاریخ به روز کاری با قاعده تعدیل |
calendar_schedule | جدول اقساط ماهانه شمسی |
calendar_holidays | تعطیلات رسمی یک سال |
نمونه گفت‌وگو
«اگر این دستور پرداخت امروز ثبت شود، با T+1 کی تسویه می‌شود؟»
عامل ابزار calendar_settlement را فرا می‌خواند و پاسخ را با تاریخ شمسی کامل و وضعیت روز کاری برمی‌گرداند. اگر نتیجه به یک تعطیل قمری پیش‌بینی‌شده وابسته باشد، پاسخ uncertain: true دارد و عامل باید همین را به کاربر بگوید.
چرا یک موتور برای همه کانال‌ها
وقتی API، کیت توسعه، خط فرمان، رابط کاربری و عامل هوشمند هر کدام تقویم خودشان را داشته باشند، دیر یا زود یکی از آن‌ها با بقیه اختلاف پیدا می‌کند. در ایران اوپن فاینانس همه این کانال‌ها از یک موتور canonical استفاده می‌کنند؛ پس پاسخ عامل با آنچه کاربر در تقویم مالی می‌بیند یکی است.