اتصال ایجنت به پیامک باهات با MCP

آدرس MCP باهات را به میزبان سازگار اضافه کنید، حساب و مجوز را انتخاب کنید و دریافت پیام یا کد آزمایشی را در محدوده مشخص بسنجید.

MCP راه اتصال یک میزبان ایجنت سازگار به ابزارهای باهات است. در باهات، ابزارها برای جستجوی پیام، خواندن پیام مشخص و دریافت کد تازه هستند. این اتصال به حساب و پنل انتخاب‌شده محدود می‌شود.

پیش از شروع، گوشی را به پنل وصل کنید و ورود یک پیام آزمایشی را در صندوق ببینید. میزبان شما باید اتصال HTTP و روش مجوز قابل استفاده با همین سرویس را پشتیبانی کند.

مسیر ایجنت از مجوز اتصال محدود به پیام مجاز، در پنل و منبع انتخاب‌شده و در حد دسترسی فعلی فردتصویر را در اندازه اصلی ببین
مجوز اتصال، پنل، منبع و مدت اعتبار را محدود می‌کند؛ دسترسی ایجنت از دسترسی فعلی شخص گسترده‌تر نمی‌شود.

۱. آدرس اتصال را اضافه کنید

در بخش اتصال MCP میزبان، این آدرس را وارد کنید:

نمونه مسیر
https://my.bahat.app/mcp

محل و نام این بخش در میزبان‌ها یکسان نیست. اگر میزبان مسیر ورود مرورگری سازگار دارد، ورود و انتخاب حساب در مرورگر آغاز می‌شود. اگر به توکن دستی نیاز دارید، از «ابزارها و اتصال‌ها» و «اتصال ایجنت‌ها» در باهات اتصال محدود بسازید و توکن را فقط در محل امن تنظیمات میزبان قرار دهید.

توکن را در پیام گفتگو، آدرس URL یا نمونه تنظیمات قابل انتشار نگذارید. اگر میزبان روش سازگار ندارد، اضافه‌کردن URL به تنهایی اتصال را کامل نمی‌کند.

۲. پنل و محدوده لازم را انتخاب کنید

حساب، پنل، مدت اعتبار و محدوده منبع را بررسی کنید. مجوز otp:read برای ابزار کد و messages:read برای خواندن متن پیام استفاده می‌شود. دسترسی متن پیام، کد موجود در همان متن را هم در بر می‌گیرد؛ این دو را هنگام انتخاب مجوز در نظر بگیرید.

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

۳. ابزارهای قابل استفاده را ببینید

ابزار کاربرد
search_messages جستجوی پیام‌های مجاز با فیلترهایی مثل فرستنده، متن و منبع.
get_message خواندن پیام مشخص در محدوده دسترسی.
get_latest_otp گرفتن کد تازه با فرستنده یا عبارت جستجوی مشخص.

برای اولین بررسی، فهرست ابزارها را تازه کنید. سپس با داده آزمایشی، درخواست محدودی مثل «پیام آزمایشی امروز از فرستنده مشخص را پیدا کن» بدهید.

۴. برای کد، منبع را روشن کنید

درخواست ابزار کد باید sender یا q داشته باشد. نمونه ورودی برای فرستنده آزمایشی:

json
{"sender":"DemoService","max_age":120}

DemoService نمونه است و باید با فرستنده واقعی آزمایش خودتان جایگزین شود. اگر چند منبع مطابق پیدا شوند، انتخاب را با خط یا device_id محدود کنید. تازگی از زمان ورود به سرور سنجیده می‌شود و تضمین اعتبار کد نزد فرستنده نیست.

۵. خطا را با محدوده دسترسی بررسی کنید

OTP_NOT_FOUND یعنی کدی مطابق فیلتر فعلی پیدا نشده؛ OTP_EXPIRED به قدیمی‌بودن نتیجه مربوط است و OTP_AMBIGUOUS انتخاب منبع دقیق‌تر می‌خواهد. خطای مجوز را با افزایش بی‌دلیل دسترسی حل نکنید؛ مجوز لازم همان ابزار و پنل انتخاب‌شده را بررسی کنید.

قطع اتصال

از فهرست اتصال‌های ایجنت در باهات، اتصال را لغو کنید. خروج از حساب وب به تنهایی توکن مستقل MCP را لغو نمی‌کند. خواندن خودکار ابزار هم مشاهده انسانی پیام محسوب نمی‌شود.

چارچوب مجوز HTTP در مستندات رسمی MCP توضیح داده شده است. سازگاری عملی باید با همان میزبان و نسخه‌ای که استفاده می‌کنید بررسی شود.

اتصال ایجنت را در پنل بساز.

در بخش اتصال ایجنت‌ها، پنل، مجوز و اعتبار را به اندازه کار موردنظر انتخاب کن و با داده آزمایشی ادامه بده.

باز کردن اتصال ایجنت‌ها