MCP راه اتصال یک میزبان ایجنت سازگار به ابزارهای باهات است. در باهات، ابزارها برای جستجوی پیام، خواندن پیام مشخص و دریافت کد تازه هستند. این اتصال به حساب و پنل انتخابشده محدود میشود.
پیش از شروع، گوشی را به پنل وصل کنید و ورود یک پیام آزمایشی را در صندوق ببینید. میزبان شما باید اتصال HTTP و روش مجوز قابل استفاده با همین سرویس را پشتیبانی کند.
۱. آدرس اتصال را اضافه کنید
در بخش اتصال MCP میزبان، این آدرس را وارد کنید:
https://my.bahat.app/mcp
محل و نام این بخش در میزبانها یکسان نیست. اگر میزبان مسیر ورود مرورگری سازگار دارد، ورود و انتخاب حساب در مرورگر آغاز میشود. اگر به توکن دستی نیاز دارید، از «ابزارها و اتصالها» و «اتصال ایجنتها» در باهات اتصال محدود بسازید و توکن را فقط در محل امن تنظیمات میزبان قرار دهید.
توکن را در پیام گفتگو، آدرس URL یا نمونه تنظیمات قابل انتشار نگذارید. اگر میزبان روش سازگار ندارد، اضافهکردن URL به تنهایی اتصال را کامل نمیکند.
۲. پنل و محدوده لازم را انتخاب کنید
حساب، پنل، مدت اعتبار و محدوده منبع را بررسی کنید. مجوز otp:read برای ابزار کد و messages:read برای خواندن متن پیام استفاده میشود. دسترسی متن پیام، کد موجود در همان متن را هم در بر میگیرد؛ این دو را هنگام انتخاب مجوز در نظر بگیرید.
اگر فقط کد یک سرویس لازم است، اتصال را به نیاز واقعی محدود کنید. مجوز اتصال با دسترسی فعلی خود شخص محدود میشود و پنل دیگری را باز نمیکند.
۳. ابزارهای قابل استفاده را ببینید
| ابزار | کاربرد |
|---|---|
search_messages |
جستجوی پیامهای مجاز با فیلترهایی مثل فرستنده، متن و منبع. |
get_message |
خواندن پیام مشخص در محدوده دسترسی. |
get_latest_otp |
گرفتن کد تازه با فرستنده یا عبارت جستجوی مشخص. |
برای اولین بررسی، فهرست ابزارها را تازه کنید. سپس با داده آزمایشی، درخواست محدودی مثل «پیام آزمایشی امروز از فرستنده مشخص را پیدا کن» بدهید.
۴. برای کد، منبع را روشن کنید
درخواست ابزار کد باید sender یا q داشته باشد. نمونه ورودی برای فرستنده آزمایشی:
{"sender":"DemoService","max_age":120}
DemoService نمونه است و باید با فرستنده واقعی آزمایش خودتان جایگزین شود. اگر چند منبع مطابق پیدا شوند، انتخاب را با خط یا device_id محدود کنید. تازگی از زمان ورود به سرور سنجیده میشود و تضمین اعتبار کد نزد فرستنده نیست.
۵. خطا را با محدوده دسترسی بررسی کنید
OTP_NOT_FOUND یعنی کدی مطابق فیلتر فعلی پیدا نشده؛ OTP_EXPIRED به قدیمیبودن نتیجه مربوط است و OTP_AMBIGUOUS انتخاب منبع دقیقتر میخواهد. خطای مجوز را با افزایش بیدلیل دسترسی حل نکنید؛ مجوز لازم همان ابزار و پنل انتخابشده را بررسی کنید.
قطع اتصال
از فهرست اتصالهای ایجنت در باهات، اتصال را لغو کنید. خروج از حساب وب به تنهایی توکن مستقل MCP را لغو نمیکند. خواندن خودکار ابزار هم مشاهده انسانی پیام محسوب نمیشود.
چارچوب مجوز HTTP در مستندات رسمی MCP توضیح داده شده است. سازگاری عملی باید با همان میزبان و نسخهای که استفاده میکنید بررسی شود.
ورود به باهات