اتصال دستیار هوش مصنوعی به بیا دایرکت
وصل که بشید، کافیه هر کاری میخواید رو ساده به دستیارتون بگید؛ خودش با حساب شما توی بیا دایرکت انجامش میده. اینجا مراحل وصل کردن هر برنامه، چند تا نمونه درخواست و همهی ابزارها رو میبینید.
پرامپت آماده برای ChatGPT و Claude
وصل که شدید، اینو کپی کنید و اولین پیام بفرستید. دستیار میفهمه از کجا شروع کنه و کارای برگشتناپذیر رو فقط با تأیید شما انجام میده.
آدرس سرور
همهی برنامهها به همین یه آدرس وصل میشن:
https://app.biadirect.ir/api/mcpراحتترین راه، پنجرهی «اتصال به هوش مصنوعی شما» توی داشبورده: از تنظیمات ← کلیدهای API بازش کنید، برنامهتون رو انتخاب کنید و همونجا کلید بسازید و تنظیمات آماده رو کپی کنید. مراحل زیر همون کاره، برای وقتی که بخواید دستی انجامش بدید.
Claude.ai و ChatGPT: فقط با ورود، بدون کلید
این دو تا کلید نمیخوان. آدرس سرور رو اضافه میکنید، وارد حساب بیا دایرکت میشید و توی صفحهی مجوز اجازه میدید. همین.
Claude.ai
بدون کلید: با حساب بیا دایرکت وارد میشید و اجازه میدید.
- توی Claude.ai برید به Settings ← Connectors.
- یه کانکتور سفارشی اضافه کنید و این آدرس رو بچسبونید:
https://app.biadirect.ir/api/mcp - وارد حساب بیا دایرکت بشید و توی صفحهی مجوز «اجازه دادن» رو بزنید. تمومه؛ حالا Claude میتونه ابزارهای بیا دایرکت رو اجرا کنه.
ChatGPT
بدون کلید: ChatGPT صفحهی ورود بیا دایرکت رو خودش پیدا میکنه.
- توی ChatGPT برید به Settings ← Connectors.
- یه کانکتور اضافه کنید و این آدرس رو بچسبونید:
https://app.biadirect.ir/api/mcp - وارد حساب بیا دایرکت بشید و توی صفحهی مجوز «اجازه دادن» رو بزنید. بقیهش با خود ChatGPT.
برنامههایی که با کلید API وصل میشن
Claude Desktop، Claude Code، Codex، Gemini، Cursor و بقیهی برنامههای MCP با کلید API وصل میشن. کلید رو توی هدر X-API-Key میفرستن.
کلید رو از تنظیمات ← کلیدهای API بسازید. کلید با sk_ شروع میشه و فقط یه بار نشونش میدیم، پس همون لحظه کپیش کنید. اگه کلید رو با «ساخت کلید API» میسازید، حتماً تیک «استفاده از دستیار هوش مصنوعی (سرور MCP و CLI)» رو بزنید و دسترسی کارایی که میخواید رو هم اضافه کنید.
کلیدی که پنجرهی «اتصال به هوش مصنوعی شما» میسازه به اکانتها، پستها، اتوماسیونها، آمار و قالبها دسترسی داره. برای پیام همگانی و پیام زنجیرهای، خودتون توی همون صفحه یه کلید با این دسترسیها بسازید.
Claude Desktop
با کلید API.
- یه کلید API بسازید و کپیش کنید.
- توی Claude Desktop برید به Settings ← MCP Servers و تنظیمات زیر رو بچسبونید؛ جای sk_... کلید خودتون رو بذارید.
- Claude Desktop رو ببندید و دوباره باز کنید. از گفتگوی بعدی، ابزارهای بیا دایرکت در دسترسن.
{
"mcpServers": {
"biadirect": {
"url": "https://app.biadirect.ir/api/mcp",
"headers": {
"X-API-Key": "sk_..."
}
}
}
}Claude Code
با کلید API، از ترمینال.
- یه کلید API بسازید.
- این دستور رو توی ترمینال اجرا کنید؛ جای sk_... کلید خودتون رو بذارید.
- یه جلسهی Claude Code باز کنید. ابزارهای بیا دایرکت آمادهان.
claude mcp add --transport http biadirect https://app.biadirect.ir/api/mcp --header "X-API-Key: sk_..."Codex
با کلید API، بهعنوان سرور MCP.
- یه کلید API بسازید.
- با تنظیمات زیر، بیا دایرکت رو به MCPهای Codex اضافه کنید.
- Codex رو دوباره باز کنید که سرور تازه رو ببینه.
{
"mcpServers": {
"biadirect": {
"url": "https://app.biadirect.ir/api/mcp",
"headers": {
"X-API-Key": "sk_..."
}
}
}
}Gemini
با کلید API، توی هر برنامهی Gemini که MCP رو پشتیبانی کنه.
- یه کلید API بسازید.
- با تنظیمات زیر، بیا دایرکت رو به MCPهای برنامهی Gemini اضافه کنید.
- برنامه رو دوباره باز کنید که سرور بالا بیاد.
{
"mcpServers": {
"biadirect": {
"url": "https://app.biadirect.ir/api/mcp",
"headers": {
"X-API-Key": "sk_..."
}
}
}
}Cursor
با کلید API؛ نصب با یه کلیک یا دستی.
- یه کلید API بسازید.
- دکمهی «باز کردن Cursor» رو بزنید. Cursor باز میشه و تنظیمات MCP رو خودش پر میکنه.
- توی تنظیمات، جای YOUR_API_KEY کلیدی که ساختید رو بذارید. اگه دکمه کار نکرد، تنظیمات زیر رو توی Cursor در Settings ← MCP بچسبونید.
{
"mcpServers": {
"biadirect": {
"url": "https://app.biadirect.ir/api/mcp",
"headers": {
"X-API-Key": "sk_..."
}
}
}
}هر برنامهی MCP
هر برنامهای که Model Context Protocol رو پشتیبانی کنه.
- یه کلید API بسازید.
- برنامه رو با آدرس
https://app.biadirect.ir/api/mcpو هدر X-API-Key تنظیم کنید؛ مقدار هدر، کلید خودتونه.
چند تا نمونه درخواست
وصل که شدید، اینا رو امتحان کنید. لازم نیست اسم ابزارها رو بدونید؛ دستیار خودش ابزار درست رو انتخاب میکنه.
- «چه اکانتهایی به بیا دایرکت وصله و اتصالشون سالمه؟»اکانتها و وضعیت اتصال هر کدوم رو میگه.
- «یه اتوماسیون بساز: هرکی زیر پستام «قیمت» کامنت گذاشت، لینک فروشگاه رو براش دایرکت کن.»یه اتوماسیون پیشنویس میسازه که ببینید و روشنش کنید.
- «اتوماسیونهام رو بر اساس تعداد اجرا مرتب کن و بگو کدوم بهتر جواب داده.»فهرست مرتبشده رو با آمار هر اتوماسیون میده.
- «اتوماسیون خوشآمدگویی رو فعلاً خاموش کن.»اتوماسیون رو پیدا میکنه و خاموشش میکنه.
- «اتوماسیون فرم ثبتنام تا حالا چند تا شماره جمع کرده؟»میگه از هر نوع اطلاعات چند تا جمع شده.
- «این هفته چه پستایی توی صف دارم؟»پستهای زمانبندیشدهی این هفته رو فهرست میکنه.
- «همهی پستایی که برای جمعه گذاشتم رو ببر شنبه، همون ساعت.»ساعت پستها رو با هم جابهجا میکنه.
- «آمار پستای ماه پیش رو خلاصه کن و بگو کدوم پست بیشتر از همه تعامل گرفت.»جمع آمار ماه و پستهای پرتعامل رو نشون میده.
همهی ابزارها
دستیارتون این ابزارها رو میتونه صدا بزنه. اسم ابزار همونیه که توی برنامهتون میبینید. هر ابزار فقط با دسترسیهایی کار میکنه که به کلید یا اتصال دادید.
اکانتها و پستهای منتشرشده
list_accounts- اکانتهایی که به بیا دایرکت وصل کردید و اینکه اتصال هر کدوم سالمه یا نه.
get_capabilities- هر اکانت چه کارایی میتونه بکنه: اتوماسیون دایرکت و کامنت، یا زمانبندی پست.
list_published_media- پستها و ریلزهایی که اخیراً روی اینستاگرام گذاشتید.
get_latest_published_media- آخرین پست یا ریلزتون؛ مثلاً برای اینکه اتوماسیون روی همون پست کار کنه.
get_published_media- همهی جزئیات یه پست، با کپشن کامل.
search_published_media- توی کپشن پستها میگرده؛ مثلاً «پستی که دربارهی تخفیف یلدا بود».
پستها و زمانبندی
list_scheduled_posts- پیشنویسها، پستهای توی صف و پستهایی که با زمانبندی منتشر شدن.
get_scheduled_post- جزئیات یه پست زمانبندیشده.
get_scheduler_calendar- پستهای زمانبندیشده توی یه بازه؛ مثلاً «این هفته».
create_scheduled_post- یه پست تازه بهشکل پیشنویس میسازه و اگه بخواید همونجا زمانبندیش میکنه.
schedule_post- یه پیشنویس رو برای یه ساعت مشخص میذاره توی صف.
update_scheduled_post- متن یا ساعت یه پیشنویس یا پست زمانبندیشده رو عوض میکنه.
bulk_reschedule_posts- ساعت تا ۵۰ تا پست رو با هم جابهجا میکنه.
cancel_scheduled_post- زمانبندی رو لغو میکنه و پست برمیگرده به پیشنویس.
publish_post_now- پست رو همین الان منتشر میکنه. برگشت نداره، برای همین قبلش ازتون تأیید میگیره.
ساختن اتوماسیون
هر چی هوش مصنوعی بسازه اول پیشنویسه و تا خودتون روشنش نکنید، کار نمیکنه.
generate_flow- از یه توضیح ساده، یه اتوماسیون کامل میسازه؛ مثلاً «هرکی کامنت قیمت گذاشت، لینک رو دایرکت کن».
create_flow- یه اتوماسیون خالی میسازه که قدم به قدم پرش کنید.
list_system_templates- قالبهای آمادهی اتوماسیون رو نشون میده.
add_node- یه مرحله (پیام، مکث، شرط، گرفتن اطلاعات و…) به اتوماسیون اضافه میکنه.
update_node- متن، کلمهی کلیدی، لینک یا تنظیمات یه مرحله رو عوض میکنه.
add_edge- دو تا مرحله رو به هم وصل میکنه؛ مثلاً دکمهی پیام اول رو به مرحلهی بعد.
delete_node- یه مرحله رو از اتوماسیون برمیداره.
delete_edge- اتصال بین دو تا مرحله رو برمیداره؛ خود مرحلهها میمونن.
مدیریت اتوماسیونها
مرحلههای یه اتوماسیون روشن رو نمیشه عوض کرد: اول خاموشش کنید یا ازش کپی بگیرید.
list_flows- همهی اتوماسیونها، و اینکه روشنن یا پیشنویس.
get_flow- نشون میده یه اتوماسیون دقیقاً چی کار میکنه: با چی شروع میشه، چه مرحلههایی داره و چطور به هم وصلن.
search_flows- وقتی چند تا اتوماسیون اسمشون شبیه همه، درستش رو پیدا میکنه.
summarize_flow_purpose- میگه یه اتوماسیون برای چیه، توی یه جمله.
activate_flow- اتوماسیون رو روشن میکنه و اگه کلمهی کلیدیش با یه اتوماسیون دیگه یکی باشه، خبر میده.
deactivate_flow- اتوماسیون رو خاموش میکنه.
duplicate_flow- از یه اتوماسیون یه کپی پیشنویس میگیره.
update_flow- اسم یا توضیح اتوماسیون رو عوض میکنه.
bulk_update_flows- اسم یا توضیح تا ۵۰ تا اتوماسیون رو با هم عوض میکنه.
get_flow_revisions- نسخههای قبلی یه اتوماسیون.
revert_flow_to_version- اتوماسیون رو برمیگردونه به یه نسخهی قبلی؛ هیچ نسخهای پاک نمیشه.
آمار
list_flows_with_stats- اتوماسیونها رو بر اساس تعداد اجرا، آدم یا کلیک مرتب میکنه.
get_flow_stats- آمار یه اتوماسیون، با نمودار هفت روز اخیر.
get_collected_data- یه اتوماسیون تا حالا چند تا ایمیل، شماره یا جواب جمع کرده. خود اطلاعات به هوش مصنوعی نشون داده نمیشه.
get_post_analytics- بازدید، ریچ، لایک، کامنت و سیو یه پست.
get_analytics_overview- جمع آمار همهی پستها توی یه بازه، با روند سی روز اخیر.
get_content_insights- چه جور پستی و چه روزی از هفته برای پیجتون بهتر جواب میده.
پیام همگانی و رشد
create_broadcast- پیشنویس یه پیام همگانی برای همه یا یه گروه از مخاطبها میسازه. خودش چیزی نمیفرسته؛ فرستادنش با خودتونه.
create_sequence- پیشنویس پیامهای زنجیرهای میسازه؛ مثلاً خوشآمدگویی سهروزه.
create_ref_url- یه لینک میسازه که کلیکهاش شمرده میشه؛ مثلاً برای لینک بیو.
محدودیتها
- هر حساب توی هر دقیقه تا ۱۲۰ بار میتونه اطلاعات بخونه و تا ۳۰ بار چیزی رو عوض کنه (ساختن، ویرایش، زمانبندی).
- کارای سنگین، مثل ساختن اتوماسیون با هوش مصنوعی یا گشتن توی کپشنها: ۵ بار در دقیقه.
- روی هم، حداکثر ۱۰۰۰ بار اجرای ابزار در روز.
اگه به سقف برسید، دستیار پیام «محدودیت تعداد درخواست» میگیره؛ یه کم صبر کنید و دوباره بخواید. جزئیات بیشتر توی صفحهی API.
قطع اتصال
هر کلیدی رو هر وقت خواستید از تنظیمات ← کلیدهای API باطل کنید؛ برنامهای که ازش استفاده میکنه همون لحظه دسترسیش قطع میشه. برای Claude.ai و ChatGPT، کانکتور رو توی تنظیمات خود اون برنامه پاک کنید.