---
title: "اتصال عامل هوشمند به تقویم مالی با MCP"
type: راهنما
published: 2026-09-30T01:25:00.509Z
url: https://iranopenfinance.com/blog/calendar-mcp-agents
source: Iran Open Finance (ایران اوپن فاینانس)
---

# اتصال عامل هوشمند به تقویم مالی با MCP

> عامل‌های هوشمند برای کارهای مالی باید بدانند امروز روز کاری است یا نه، تسویه کی انجام می‌شود و سررسید کجا می‌افتد. سرور MCP تقویم مالی همین قابلیت‌ها را به‌صورت ابزارهای فقط‌خواندنی در اختیار عامل می‌گذارد.

مدل‌های زبانی تقویم ایران را «حدس» می‌زنند؛ و در محاسبات مالی، حدس کافی نیست. سرور MCP تقویم مالی ایران اوپن فاینانس به عامل‌های هوشمند اجازه می‌دهد به‌جای حدس، از همان موتوری استفاده کنند که API، کیت توسعه و خط فرمان پلتفرم را اجرا می‌کند.

## نشانی سرور

```text
https://iranopenfinance.com/mcp
```

سرور از پروتکل Streamable HTTP استفاده می‌کند، به کلید نیاز ندارد و همه ابزارهایش فقط‌خواندنی‌اند.

## افزودن به Claude Code

```bash
claude mcp add --transport http iof-calendar https://iranopenfinance.com/mcp
```

برای ابزارهای دیگری که از MCP پشتیبانی می‌کنند، همین نشانی را به‌عنوان یک سرور HTTP اضافه کنید:

```json
{
  "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 استفاده می‌کنند؛ پس پاسخ عامل با آنچه کاربر در [تقویم مالی](/calendar/) می‌بیند یکی است.