البدء السريع مع MCP

صِل IDE أو إطار الوكيل أو runtime مخصص إلى ASAPilot خلال أقل من 5 دقائق باستخدام Model Context Protocol.

ما هو MCP؟

Model Context Protocol معيار مفتوح يتيح للمساعدات الذكية الوصول إلى الأدوات ومصادر البيانات الخارجية. يعرّض ASAPilot قدرات chat والبحث عن الحسابات وإدارة الأتمتة كخادم MCP لتتمكن من دمج تدفقات Apple Search Ads في أي بيئة متوافقة.

الخطوة 1: وفّر قناة MCP

1. سجّل الدخول إلى app.asapilot.com ثم افتح Channels.
2. اضغط Provision على بطاقة MCP.
3. انسخ MCP server URL وAPI key الناتجين. ستحتاجهما في الخطوة التالية.

الخطوة 2: اضبط MCP client

أضف خادم ASAPilot MCP إلى إعدادات عميلك. يختلف التنسيق حسب العميل، لكن المثال التالي شائع في Claude Desktop أو العملاء المشابهين.

{
  "mcpServers": {
    "asapilot": {
      "url": "https://api.asapilot.com/mcp/YOUR_WORKSPACE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

الخطوة 3: هيّئ الاتصال واعرض الأدوات

بعد الإعداد سيستدعي العميل initialize وtools/list تلقائياً لاكتشاف الأدوات المتاحة. يجب أن ترى خمس أدوات: chat.send وaccounts.list وautomations.list وautomations.create وautomations.run.

الخطوة 4: نفّذ أول استدعاء للأداة

جرّب أولاً عرض الحسابات المتصلة:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts.list",
    "arguments": {}
  }
}

أو أرسل رسالة chat مباشرةً:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "chat.send",
    "arguments": {
      "message": "Show me my top spending campaigns this week",
      "thread_id": "my-first-thread"
    }
  }
}

ما التالي؟