مرجع أدوات MCP
هذه هي المرجعية الكاملة للأدوات الخمس التي يوفّرها خادم ASAPilot MCP حالياً لإدارة Apple Search Ads.
للمطورين
إذا كنت تستخدم اللوحة فقط فلن تحتاج عادةً إلى هذه الأدوات. المعلومات هنا موجهة للعملاء الداعمين لـ MCP وأدوات البرمجة المعززة بالذكاء الاصطناعي.
يعرض ASAPilot خمس أدوات عبر خادم MCP. يمكنك استخدامها لقراءة بيانات الإعلانات وتشغيل الأتمتة ودمج سير العمل باللغة الطبيعية داخل عميلك.
أدوات Chat
chat.send
أرسل رسالة إلى ASAPilot وواصل محادثة خارجية موجودة.
المعلمات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| message | string | مطلوب | رسالة المستخدم المراد إرسالها إلى ASAPilot. |
| thread_id | string | اختياري | معرّف ثابت للمحادثة الخارجية. أعد استخدامه في المتابعات. |
| mode | string | اختياري | تجاوز اختياري لوضع ASAPilot مثل free_talk أو account_health. |
| connection_id | string | اختياري | معرّف حساب ASA متصل اختيارياً. |
| time_range | string | اختياري | نطاق زمني اختياري للتقارير. |
مثال
{
"name": "chat.send",
"arguments": {
"message": "Show me campaigns with CPI above $5",
"thread_id": "analysis-session-1",
"mode": "account_health",
"time_range": "last_7_days"
}
}أدوات الحساب
accounts.list
أعد قائمة حسابات Apple Search Ads المتصلة والمتاحة لمساحة ASAPilot الحالية.
مثال
{
"name": "accounts.list",
"arguments": {}
}أدوات الأتمتة
automations.list
أعد قائمة الأتمتات المهيأة حالياً في ASAPilot.
مثال
{
"name": "automations.list",
"arguments": {}
}أدوات الأتمتة
automations.create
أنشئ أتمتة جديدة في ASAPilot.
المعلمات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| name | string | مطلوب | اسم الأتمتة. |
| type | string | مطلوب | نوع الأتمتة مثل daily_account_health أو daily_budget_guard. |
| connectionId | string | مطلوب | معرّف حساب ASA المتصل. |
| agentName | string | اختياري | تجاوز اختياري لاسم الوكيل. |
| configJson | string | اختياري | سلسلة JSON اختيارية للإعداد. |
| scheduleType | string | اختياري | نوع الجدولة: hourly أو daily أو weekly. |
| cronExpr | string | اختياري | قيمة الجدولة مثل 09:00 لليومي و6h للساعة وMON@09:00 للأسبوعي. |
| timezone | string | اختياري | منطقة زمنية IANA مثل UTC أو America/Los_Angeles. |
مثال
{
"name": "automations.create",
"arguments": {
"name": "Daily Budget Alert",
"type": "daily_budget_guard",
"connectionId": "conn_abc123",
"scheduleType": "daily",
"cronExpr": "09:00",
"timezone": "America/Los_Angeles"
}
}أدوات الأتمتة
automations.run
ضع تشغيل أتمتة في قائمة التنفيذ فوراً.
المعلمات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| automationId | string | مطلوب | معرّف الأتمتة المطلوب تشغيلها. |
مثال
{
"name": "automations.run",
"arguments": {
"automationId": "auto_xyz789"
}
}تفاصيل البروتوكول
المصادقة
كل الطلبات تحتاج إلى API key. مرّره عبر Authorization: Bearer YOUR_API_KEY أو X-API-Key.
إدارة الجلسة
بعد التهيئة يعيد الخادم رأس Mcp-Session-Id. أرسل الرأس نفسه في الطلبات اللاحقة للحفاظ على session continuity.
استمرارية الخيط
في chat.send، أعد استخدام thread_id نفسه عبر عدة استدعاءات للحفاظ على الربط بين الخيط الخارجي ومحادثة ASAPilot الداخلية.
البدء السريع مع MCP
شغّل خادم MCP أولاً ثم عد إلى هذه الصفحة للتفاصيل.
القنوات والتكاملات
افهم موضع MCP ضمن نموذج التكامل الكامل.
الأسئلة الشائعة
كم أداة MCP يوفّرها ASAPilot حالياً؟
يوفّر خادم MCP الحالي خمس أدوات تغطي chat وaccounts وautomations.
كيف أحافظ على استمرارية جلسة MCP؟
أعد استخدام ترويسة Mcp-Session-Id التي يعيدها الخادم في الطلبات التالية.
كيف أربط المحادثة الخارجية بخيط ASAPilot واحد؟
استمر في استخدام thread_id نفسه في استدعاءات chat.send.