← بازگشت به Marketplace

استعلام و احراز هویت

Iran Verification MCP

کسب‌وکار به‌زودی طبق تعرفه
راهنمای استفاده مستندات تست سرویس

سرویس یکپارچه استعلام‌های هویتی، موبایل، شرکت و کدپستی.

سرویس یکپارچه استعلام‌های هویتی، موبایل، شرکت و کدپستی.

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

MCP چیست و این صفحه چه می‌کند؟

Model Context Protocol (MCP) یک استاندارد برای وصل کردن ابزارها (Tools) به ایجنت‌های هوش مصنوعی و اتوماسیون است. هر سرویس در Marketplace مجموعه‌ای از Tool دارد؛ هر Tool یک ورودی مشخص (JSON Schema) و یک خروجی ساخت‌یافته برمی‌گرداند. در دهکده می‌توانید Tool را همین‌جا تست کنید، از مستندات بخوانید، و بعداً به Workflow یا کلاینت MCP وصل کنید.

مراحل سریع (همین صفحه)

  1. وضعیت سرویس را ببینید: فعال برای تست یعنی Provider واقعی ثبت شده است.
  2. در بخش ابزارها نام Tool، توضیح و Schema ورودی/خروجی را بخوانید.
  3. به بخش تست سرویس بروید، Tool را انتخاب کنید و فیلدها را پر کنید.
  4. روی «اجرای تست» بزنید؛ پاسخ JSON در همان صفحه نشان داده می‌شود.
  5. در صورت خطا، کد خطا (NOT_FOUND، SERVICE_UNAVAILABLE، INTERNAL_ERROR) را در پیام ببینید.

فراخوانی از طریق API (برای توسعه‌دهنده)

Tester داخلی از همین endpoint استفاده می‌کند:

POST /Mcp/ExecuteTool
Content-Type: application/json

{
  "slug": "iran-verification",
  "tool": "نام_ابزار",
  "arguments": { }
}

مقدار tool باید دقیقاً همان Name ابزار باشد (نه فقط عنوان نمایشی). فیلد arguments مطابق Input Schema همان Tool پر می‌شود.

اتصال در Workflow دهکده

  1. از داشبورد یک گردش‌کار بسازید یا قالب آماده را Import کنید.
  2. نود HTTP Request (یا نود MCP در صورت فعال بودن در ادیتور) را اضافه کنید.
  3. آدرس /Mcp/ExecuteTool را با بدنه JSON بالا صدا بزنید.
  4. خروجی را به نود بعدی (شرط، تلگرام، ذخیره دیتابیس و …) وصل کنید.

Endpoint و کلاینت MCP خارجی

این سرویس هنوز در وضعیت «توسعه / به‌زودی» است؛ Toolها ممکن است در کاتالوگ دیده شوند ولی اجرای واقعی تا فعال‌سازی Provider ممکن نیست.

نکات مهم

  • سرویس‌های رایگان و Active (مثل Iran Utility و Developer Tools) بدون Credential اضافه قابل تست‌اند.
  • برای SMS، پرداخت و جست‌وجو تا زمان اتصال Provider واقعی، وضعیت Development است و نباید به‌عنوان API نهایی در تولید استفاده شوند.
  • اگر خطای مربوط به SQL یا INTERNAL_ERROR دیدید، اتصال دیتابیس سرور را بررسی کنید؛ خود Tool ممکن است سالم باشد.
  • مستندات تفصیلی هر سرویس: صفحه مستندات.

ابزارها (Tools)

validate_national_id
validate_national_id

ابزار validate_national_id

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
verify_mobile
verify_mobile

ابزار verify_mobile

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
verify_national_id_mobile
verify_national_id_mobile

ابزار verify_national_id_mobile

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
get_company_info
get_company_info

ابزار get_company_info

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
get_person_info
get_person_info

ابزار get_person_info

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
validate_postal_code
validate_postal_code

ابزار validate_postal_code

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
get_postal_address
get_postal_address

ابزار get_postal_address

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}
check_identity
check_identity

ابزار check_identity

Input Schema
{"type":"object","properties":{"input":{"type":"string","description":"مقدار ورودی"}},"required":["input"]}
Output Schema
{"type":"object"}

نحوه اتصال

این سرویس هنوز برای اتصال عملیاتی فعال نشده است (وضعیت: به‌زودی / توسعه).

تست سرویس

این سرویس هنوز برای اجرای واقعی فعال نشده است. پس از فعال‌سازی Provider می‌توانید از Tester استفاده کنید.

نظرات کاربران

هنوز نظر تأییدشده‌ای ثبت نشده است. اولین نفر باشید.

ثبت نظر

پس از بررسی مدیر نمایش داده می‌شود.