سرویس MCP هُما
معرفی MCP
MCP چیست؟
MCP راه جدید وصل شدن دستیار هوش مصنوعی به هُماست — جدا از API معمولی، نه جایگزین آن.
با Model Context Protocol برنامههایی مثل Cursor، Claude Desktop و Cline مستقیم به پرتال شما وصل میشوند. شما فقط به زبان خودتان میگویید چه میخواهید؛ دستیار خودش کار درست را انجام میدهد — بدون نوشتن کد.
سه راه برای اتصال به هُما:
- MCP — برای دستیار هوش مصنوعی (Cursor، Claude و…)
- API REST — برای برنامهنویسی و یکپارچهسازی
- API قدیمی HomaNode — اتصال کلاسیک
هر سه با یک توکن کار میکنند.
خود MCP دو راه اتصال دارد:
- اتصال مستقیم (بدون نصب): فقط آدرس https://www.HomaCRM.com/mcp و توکن را در کانفیگ دستیار بگذارید — سادهترین راه.
- پکیج محلی (Node.js): اجرای سرور کنار دستیار روی سیستم خودتان.
با دستیار چه کارهایی میتوانید بکنید؟
بعد از اتصال، کافی است مثل یک همکار از دستیار بخواهید. چند نمونه:
- «مخاطبی با شمارهٔ ۰۹۱۲۱۲۳۴۵۶۷ در پرتال من هست؟»
- «تیکتهای پشتیبانی باز من را نشان بده.»
- «چند مخاطب در گروه مشتریان دارم؟»
- «الان ساعت و تاریخ شمسی سرور چیست؟»
- «از این لینک یک QR code بساز.»
- «فاکتورهای تسویهنشدهٔ این ماه را فهرست کن.»
MCP برای صحبت با دادههای پرتال ساخته شده. اگر میخواهید نرمافزار خودتان را کد بزنید و وصل کنید، از راهنمای API استفاده کنید.
نکات
- با دستیار بپرسید توکن به چه چیزهایی دسترسی دارد.
- توکن ثانویه با دسترسی متناسب بسازید — برخی ابزارها (ارسال پیامک، ثبت مخاطب و تیکت) نوشتنی هستند.