سرویس MCP هُما
نمونه گفتگو
چطور کار میکند؟
بعد از اتصال، در Cursor یا Claude فقط به زبان خودتان میگویید چه میخواهید. دستیار خودش تصمیم میگیرد کدام ابزار را صدا بزند، پرتال را بررسی میکند و جواب را خلاصهشده به شما میدهد — بدون نوشتن کد.
در همهٔ نمونههای این صفحه، کنار هر مثال دکمهٔ 🧪 تست زنده هست. روی آن بزنید تا همینجا یک پنجرهٔ تست باز شود، توکن پرتال را بگذارید و پاسخ واقعی سرور را ببینید — بدون نصب دستیار.
ابزارهای خواندنی بیخطرند و چیزی را تغییر نمیدهند. ابزارهای نوشتنی ✍️ (ثبت تیکت، ساخت مخاطب و…) داده واقعی ثبت میکنند — تسترشان قبل از اجرا تأیید جداگانه میگیرد و دستیار هم همیشه اول از شما اجازه میخواهد.
۱) اول از همه: بررسی دسترسی توکن
پیش از هر کاری از دستیار بپرسید توکن به کدام پرتال وصل است و چه دسترسیهایی دارد. این پاسخ به شما و به دستیار میگوید چه کارهایی ممکن است.
💬 «این توکن به کدام پرتال وصل است و به چه چیزهایی دسترسی دارد؟»
دستیار ابزار homa_whoami را صدا میزند و کد پرتال، کاربر، نوع/سطح توکن و فهرست دسترسیها (scope) را برمیگرداند.
۲) کار با مخاطبین (CRM)
جستجو، فهرستکردن و دیدن جزئیات مخاطبین دفترچهتلفن پرتال. برای این کارها توکن به دسترسی crm:contacts:read نیاز دارد.
💬 «مخاطبی با موبایل ۰۹۱۲۱۲۳۴۵۶۷ در پرتال من هست؟»
دستیار با crm_search_contacts روی موبایل جستجو میکند و مخاطب پیداشده را نشان میدهد.
💬 «همهٔ مخاطبهایی که نامشان «رضایی» است را فهرست کن.»
همان ابزار جستجو با متن نام؛ نتیجه صفحهبندیشده و بدون فیلدهای حساس برمیگردد.
💬 «مخاطبهای گروه مشتریان (گروه شمارهٔ ۳) را نشان بده.»
با crm_search_contacts و فیلتر شناسهٔ گروه، اعضای همان گروه فهرست میشوند.
💬 «جزئیات کامل مخاطب شمارهٔ ۱۵۲ را با کد ملی، آدرس و یادداشتها بده.»
دستیار با crm_get_contact جزئیات کامل یک مخاطب (شامل فیلدهای حساس) را میگیرد. شناسه را از نتیجهٔ جستجو برمیدارد.
💬 «چند مخاطب در گروه مشتریان دارم؟»
دستیار با crm_count_contacts فقط تعداد را برمیگرداند — بدون فهرستکردن مخاطبین، سریع و سبک.
💬 «گروههای مخاطبین را با تعداد اعضای هرکدام نشان بده.»
دستیار با crm_list_contact_groups فهرست گروهها همراه تعداد اعضا را میگیرد (نیازمند دسترسی crm:groups:read).
۳) کار با تیکتهای پشتیبانی
فهرست و جزئیات تیکتهای پشتیبانی پرتال. برای این کارها توکن به دسترسی support:tickets:read نیاز دارد.
💬 «تیکتهای باز پشتیبانی را نشان بده.»
دستیار با support_list_tickets و فیلتر وضعیت «باز» فهرست تیکتها را میآورد.
💬 «تازهترین تیکتهای بسته را فهرست کن.»
همان ابزار با فیلتر وضعیت «بسته»؛ خروجی صفحهبندیشده و مرتب بر اساس زمان است.
💬 «وضعیت تیکت ۹۸۱ چیست و آخرین پاسخ چه بود؟»
دستیار با support_get_ticket جزئیات کامل یک تیکت بههمراه گفتگوها (پاسخها) را میگیرد و خلاصه میکند.
💬 «تیکتهای مربوط به «پیامک» را پیدا کن.»
دستیار با support_search_tickets روی عنوان و توضیح تیکتها جستجوی متنی میکند؛ فیلتر وضعیت هم قابل ترکیب است.
۴) کار با پیامک
اعتبار، شمارههای فرستنده، گزارش ارسال/دریافت و پیشنویسها — هرکدام scope خواندنی خودش را میخواهد (messaging:credit:read، messaging:reports:read و…).
💬 «چقدر اعتبار پیامک دارم و تقریباً چند پیامک میشود؟»
دستیار با messaging_get_credit موجودی (ریال/تومان) و تخمین تعداد پیامک قابل ارسال را میگیرد.
💬 «پیامکهایی که این هفته فرستادم به کجا رسیدند؟»
دستیار با messaging_outbox_report و فیلتر تاریخ، وضعیت ارسال، تعداد ارسالشده و اعتبار مصرفی هر کارزار را گزارش میکند.
💬 «پیامکهای دریافتی امروز را نشان بده — کسی «لغو» فرستاده؟»
دستیار با messaging_inbox_report پیامکهای دریافتی را با فرستنده، متن و اپراتور فهرست میکند و میتواند روی متن جستجو کند.
💬 «با کدام شمارهها میتوانم ارسال کنم و چه متنهای آمادهای دارم؟»
دستیار messaging_list_numbers و messaging_list_drafts را صدا میزند تا خطوط فعال و پیشنویسهای ذخیرهشده را نشان دهد.
۵) ثبت و پیگیری تیکت (نوشتنی ✍️)
حالا دستیار میتواند از طرف شما تیکت ثبت کند، پاسخ بدهد، پیگیری کند و درخواست تماس بگذارد. برای این کارها توکن به support:tickets:write نیاز دارد و دستیار همیشه قبل از ثبت، از شما تأیید میگیرد.
💬 «یک تیکت فوری ثبت کن: پیامکها از دیروز ارسال نمیشوند.»
دستیار با support_create_ticket تیکتی با عنوان، توضیح و اهمیت «فوری» میسازد — بعد از اینکه شما تأیید کردید.
💬 «روی تیکت ۹۸۱ بنویس: ممنون، مشکل حل شد.»
دستیار با support_reply_ticket پاسخ شما را روی تیکت ثبت میکند. تیکتهای بسته پاسخ نمیپذیرند.
💬 «عجله دارم — تیکت ۹۸۱ را پیگیری کن و بگو فوری است.»
دستیار با support_followup_ticket و urgent: true درخواست پیگیری ثبت میکند و اولویت تیکت هم بالا میرود.
💬 «بگو دربارهٔ تیکت ۹۸۱ با ۰۹۱۲۱۲۳۴۵۶۷ تماس بگیرند، امروز ۱۴ تا ۱۷.»
دستیار با support_request_callback شماره و بازهٔ ترجیحی شما را برای تیم پشتیبانی ثبت میکند.
۶) ثبت داده در CRM و پیامک (نوشتنی ✍️)
ساخت مخاطب و سرنخ، ثبت معامله و مدیریت پیشنویسهای پیامک — همه با تأیید شما. ارسال پیامک واقعی (messaging_send_sms) فقط از خود دستیار انجام میشود و تست مرورگری ندارد، چون اعتبار مصرف میکند.
💬 «این شماره را ذخیره کن: ۰۹۱۲۱۲۳۴۵۶۷، علی رضایی، گروه مشتریان.»
دستیار با crm_create_contact مخاطب جدید میسازد؛ اگر شماره تکراری باشد، خطای مشخص برمیگردد.
💬 «برای قرارداد سالانهٔ شرکت نمونه یک معامله در مرحلهٔ مذاکره بساز.»
دستیار اول crm_list_pipelines را صدا میزند تا pipelineId و stageId درست را پیدا کند، بعد با crm_create_deal معامله را میسازد.
💬 «این متن را بهعنوان پیشنویس «خوشآمد» ذخیره کن.»
دستیار با messaging_create_draft متن را به پیشنویسهای پیامک اضافه میکند تا بعداً در ارسالها استفاده شود.
۷) انبار، مالی، تولید و حقوق (گزارشگیری)
همهٔ ماژولهای هُما حالا از طریق دستیار قابل گزارشگیریاند — فقطخواندنی و امن. هر ماژول scope خودش را میخواهد (مثل warehouse:inventory:read یا finance:invoices:read).
💬 «از لپتاپ ایسوس چند تا در انبار مانده؟»
دستیار با warehouse_get_inventory موجودی لحظهای (خالص ورود/خروج) همان کالا را میگیرد.
💬 «فاکتورهای تسویهنشدهٔ این ماه را با مانده نشان بده.»
دستیار با finance_list_invoices و فیلتر وضعیت/تاریخ، فاکتورها را با مبلغ، پرداختی و مانده فهرست میکند.
💬 «سفارشهای تولید در جریان را با درصد پیشرفت بگو.»
دستیار با production_list_orders سفارشها را میگیرد و از مقایسهٔ مقدار برنامهریزیشده و تولیدشده پیشرفت را حساب میکند.
💬 «جمع خالص پرداختی حقوق تیر چقدر شد؟»
دستیار با payroll_list_runs اجرای همان دوره را پیدا میکند و جمعهای تجمیعی را میخواند — فیش فردی هیچوقت از این مسیر بیرون نمیآید.
۸) دید کلی پرتال (ابزارهای ترکیبی)
دو ابزار ترکیبی چند سرویس را در یک فراخوانی جمع میکنند. اگر توکن به بخشی دسترسی نداشته باشد، همان بخش skip میشود و بقیه برمیگردد.
💬 ««رضایی» را در کل پرتال جستجو کن — هم مخاطبین هم تیکتها.»
دستیار با homa_search همزمان مخاطبین و تیکتها را میگردد و چند نتیجهٔ اول هر بخش را با تعداد کل برمیگرداند.
💬 «خلاصهٔ وضعیت پرتال را بگو.»
دستیار با homa_stats_overview تعداد مخاطبین، گروهها و تیکتها به تفکیک وضعیت (باز/در حال بررسی/بسته) را یکجا میگیرد.
۹) گفتگوهای چندمرحلهای (ترکیب ابزارها)
قدرت واقعی وقتی است که دستیار چند ابزار را پشتسرهم بهکار میگیرد. شما فقط هدف را میگویید؛ دستیار مسیر را خودش میچیند.
💬 «مخاطبی با موبایل ۰۹۱۲۱۲۳۴۵۶۷ پیدا کن و اگر تیکت باز دارد نشانم بده.»
اول crm_search_contacts برای یافتن مخاطب، سپس support_list_tickets برای دیدن تیکتهای باز مرتبط — و در پایان یک جمعبندی.
💬 «ببین علی رضایی چند تیکت دارد و خلاصهٔ آخرین تیکتش را بگو.»
دستیار مخاطب را پیدا میکند، تیکتها را فهرست میکند و برای تیکت آخر support_get_ticket را صدا میزند تا گفتگو را خلاصه کند.
لازم نیست نام ابزارها را بدانید یا کد پرتال را وارد کنید — کافی است هدف را طبیعی بگویید. اگر دستیار به دادهای دسترسی نداشت، خودش میگوید کدام دسترسی (scope) کم است.
۱۰) ابزارهای کاربردی (تاریخ و QR)
ابزارهای کاربردی به هیچ scope خاصی نیاز ندارند و برای هر توکن معتبری در دسترساند — مثل گرفتن ساعت و تاریخ مرجع سرور یا ساخت QR code.
💬 «الان دقیقاً ساعت و تاریخ شمسی سرور چیست؟»
دستیار با utilities_get_datetime زمان فعلی را میگیرد و هم میلادی (UTC/محلی) هم شمسی (جلالی) را با نام روز و ماه برمیگرداند.
💬 «از این لینک یک QR code بساز: https://www.HomaCRM.com»
دستیار با utilities_generate_qrcode یک QR (PNG بهصورت data URL یا SVG) میسازد؛ اندازه، حاشیه و سطح تصحیح خطا قابل تنظیم است.
نکات
- با دستیار بپرسید توکن به چه چیزهایی دسترسی دارد.
- توکن ثانویه با دسترسی متناسب بسازید — برخی ابزارها (ارسال پیامک، ثبت مخاطب و تیکت) نوشتنی هستند.