{ مستندات }

اتصال دستیار هوش مصنوعی به بیا دایرکت

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

پرامپت آماده برای ChatGPT و Claude

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

پرامپت آماده برای ChatGPT و Claude

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

این‌طوری کار کن:
۱. اول با whoami و list_accounts ببین به کدوم پیج وصلیم. اگه بیشتر از یه پیج بود، بپرس با کدوم کار کنیم.
۲. قبل از ساختن یا عوض کردن چیزی، با list_flows و list_scheduled_posts ببین الان چی داریم که کار تکراری نسازی.
۳. اتوماسیون جدید رو با generate_flow بساز. ساخته‌شده‌ها پیش‌نویس می‌مونن؛ قبل از روشن کردن (activate_flow) خلاصه‌ش رو به زبان ساده بگو و ازم تأیید بگیر.
۴. پست رو با create_scheduled_post بساز. ساعت‌ها رو به وقت تهران (Asia/Tehran) حساب کن و موقع گزارش، تاریخ رو شمسی بگو.
۵. هر کاری که برگشت نداره، مثل انتشار فوری پست (publish_post_now) یا روشن کردن اتوماسیون، فقط بعد از تأیید صریح من انجام بشه.
۶. برای آمار از get_flow_stats و get_analytics_overview استفاده کن و عدد رو با یه جمله‌ی کوتاه توضیح بده که یعنی چی.
۷. اگه ابزاری خطا داد، متن خطا رو برام ساده کن و بگو چی کار کنم؛ حدس نزن و چیزی از خودت نساز.

اول بگو به کدوم پیج وصلیم و چه اتوماسیون‌هایی روشنه.

آدرس سرور

همه‌ی برنامه‌ها به همین یه آدرس وصل می‌شن:

MCP server
https://app.biadirect.ir/api/mcp

راحت‌ترین راه، پنجره‌ی «اتصال به هوش مصنوعی شما» توی داشبورده: از تنظیمات ← کلیدهای API بازش کنید، برنامه‌تون رو انتخاب کنید و همون‌جا کلید بسازید و تنظیمات آماده رو کپی کنید. مراحل زیر همون کاره، برای وقتی که بخواید دستی انجامش بدید.

Claude.ai و ChatGPT: فقط با ورود، بدون کلید

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

Claude.ai

بدون کلید: با حساب بیا دایرکت وارد می‌شید و اجازه می‌دید.

  1. توی Claude.ai برید به Settings ← Connectors.
  2. یه کانکتور سفارشی اضافه کنید و این آدرس رو بچسبونید: https://app.biadirect.ir/api/mcp
  3. وارد حساب بیا دایرکت بشید و توی صفحه‌ی مجوز «اجازه دادن» رو بزنید. تمومه؛ حالا Claude می‌تونه ابزارهای بیا دایرکت رو اجرا کنه.
باز کردن Claude.ai

ChatGPT

بدون کلید: ChatGPT صفحه‌ی ورود بیا دایرکت رو خودش پیدا می‌کنه.

  1. توی ChatGPT برید به Settings ← Connectors.
  2. یه کانکتور اضافه کنید و این آدرس رو بچسبونید: https://app.biadirect.ir/api/mcp
  3. وارد حساب بیا دایرکت بشید و توی صفحه‌ی مجوز «اجازه دادن» رو بزنید. بقیه‌ش با خود ChatGPT.
باز کردن ChatGPT

برنامه‌هایی که با کلید API وصل می‌شن

Claude Desktop، Claude Code، Codex، Gemini، Cursor و بقیه‌ی برنامه‌های MCP با کلید API وصل می‌شن. کلید رو توی هدر X-API-Key می‌فرستن.

کلید رو از تنظیمات ← کلیدهای API بسازید. کلید با sk_ شروع می‌شه و فقط یه بار نشونش می‌دیم، پس همون لحظه کپیش کنید. اگه کلید رو با «ساخت کلید API» می‌سازید، حتماً تیک «استفاده از دستیار هوش مصنوعی (سرور MCP و CLI)» رو بزنید و دسترسی کارایی که می‌خواید رو هم اضافه کنید.

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

Claude Desktop

با کلید API.

  1. یه کلید API بسازید و کپیش کنید.
  2. توی Claude Desktop برید به Settings ← MCP Servers و تنظیمات زیر رو بچسبونید؛ جای sk_... کلید خودتون رو بذارید.
  3. Claude Desktop رو ببندید و دوباره باز کنید. از گفتگوی بعدی، ابزارهای بیا دایرکت در دسترسن.
claude_desktop_config.json
{
  "mcpServers": {
    "biadirect": {
      "url": "https://app.biadirect.ir/api/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

Claude Code

با کلید API، از ترمینال.

  1. یه کلید API بسازید.
  2. این دستور رو توی ترمینال اجرا کنید؛ جای sk_... کلید خودتون رو بذارید.
  3. یه جلسه‌ی Claude Code باز کنید. ابزارهای بیا دایرکت آماده‌ان.
Terminal
claude mcp add --transport http biadirect https://app.biadirect.ir/api/mcp --header "X-API-Key: sk_..."

Codex

با کلید API، به‌عنوان سرور MCP.

  1. یه کلید API بسازید.
  2. با تنظیمات زیر، بیا دایرکت رو به MCPهای Codex اضافه کنید.
  3. Codex رو دوباره باز کنید که سرور تازه رو ببینه.
MCP config
{
  "mcpServers": {
    "biadirect": {
      "url": "https://app.biadirect.ir/api/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

Gemini

با کلید API، توی هر برنامه‌ی Gemini که MCP رو پشتیبانی کنه.

  1. یه کلید API بسازید.
  2. با تنظیمات زیر، بیا دایرکت رو به MCPهای برنامه‌ی Gemini اضافه کنید.
  3. برنامه رو دوباره باز کنید که سرور بالا بیاد.
MCP config
{
  "mcpServers": {
    "biadirect": {
      "url": "https://app.biadirect.ir/api/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

Cursor

با کلید API؛ نصب با یه کلیک یا دستی.

  1. یه کلید API بسازید.
  2. دکمه‌ی «باز کردن Cursor» رو بزنید. Cursor باز می‌شه و تنظیمات MCP رو خودش پر می‌کنه.
  3. توی تنظیمات، جای YOUR_API_KEY کلیدی که ساختید رو بذارید. اگه دکمه کار نکرد، تنظیمات زیر رو توی Cursor در Settings ← MCP بچسبونید.
باز کردن Cursor
mcp.json
{
  "mcpServers": {
    "biadirect": {
      "url": "https://app.biadirect.ir/api/mcp",
      "headers": {
        "X-API-Key": "sk_..."
      }
    }
  }
}

هر برنامه‌ی MCP

هر برنامه‌ای که Model Context Protocol رو پشتیبانی کنه.

  1. یه کلید API بسازید.
  2. برنامه رو با آدرس 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
چه جور پستی و چه روزی از هفته برای پیجتون بهتر جواب می‌ده.

پیام همگانی و رشد

این سه تا ابزار فقط توی پلن‌های پولی کار می‌کنن و کلیدی می‌خوان که توی تنظیمات با همون دسترسی ساخته باشید (جدول دسترسی‌ها توی صفحه‌ی API هست).
create_broadcast
پیش‌نویس یه پیام همگانی برای همه یا یه گروه از مخاطب‌ها می‌سازه. خودش چیزی نمی‌فرسته؛ فرستادنش با خودتونه.
create_sequence
پیش‌نویس پیام‌های زنجیره‌ای می‌سازه؛ مثلاً خوش‌آمدگویی سه‌روزه.
create_ref_url
یه لینک می‌سازه که کلیک‌هاش شمرده می‌شه؛ مثلاً برای لینک بیو.

محدودیت‌ها

  • هر حساب توی هر دقیقه تا ۱۲۰ بار می‌تونه اطلاعات بخونه و تا ۳۰ بار چیزی رو عوض کنه (ساختن، ویرایش، زمان‌بندی).
  • کارای سنگین، مثل ساختن اتوماسیون با هوش مصنوعی یا گشتن توی کپشن‌ها: ۵ بار در دقیقه.
  • روی هم، حداکثر ۱۰۰۰ بار اجرای ابزار در روز.

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

قطع اتصال

هر کلیدی رو هر وقت خواستید از تنظیمات ← کلیدهای API باطل کنید؛ برنامه‌ای که ازش استفاده می‌کنه همون لحظه دسترسیش قطع می‌شه. برای Claude.ai و ChatGPT، کانکتور رو توی تنظیمات خود اون برنامه پاک کنید.

دیگه هیچ کامنتی بی‌جواب نمی‌مونه!

پلن رایگان همیشگی · کارت بانکی نمی‌خواد