ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتسجيل الدخول (ضرورية) وللتحليلات (اختيارية). مزيد من التفاصيل - سياسة الخصوصية.

ADS Beast لمساعدي الذكاء الاصطناعي

ربط أي عميل MCP بـ ADS Beast

أي عميل يتحدث MCP عبر HTTP ويستطيع إرسال ترويسة طلب يتصل بالطريقة نفسها. الأمران أدناه يفحصان الخادم بلا أي عميل.

أولًا، أنشئ مفتاح API

  1. 1سجّل الدخول إلى ADS Beast وافتح مفاتيح API من القائمة. إنشاء مفتاح يتطلب دور المسؤول.
  2. 2أنشئ مفتاحًا بالصلاحيات التي يحتاجها المساعد فقط. read:* تكفي للاطلاع على البيانات. أضف write:proposals ليتمكن من اقتراح تغييرات وبناء مسودات حملات، وwrite:leads ليتمكن من تحديث العملاء المحتملين.
  3. 3انسخ المفتاح الذي يبدأ بـ absk_. يُعرض مرة واحدة. تلغيه من الشاشة نفسها، والمفتاح الملغى يتوقف عن العمل فورًا.

ما يحتاجه العميل

  1. 1النقل: Streamable HTTP. العنوان هو https://adsbeast.pro/api/mcp/workspace لحسابك وhttps://adsbeast.pro/api/mcp للأدوات المفتوحة.
  2. 2الترويسة: Authorization: Bearer absk_your_key. وتعمل X-API-Key: absk_your_key أيضًا.
  3. 3يقبل كثير من العملاء مقطع JSON أدناه كما هو. والعميل الذي يشغّل برامج محلية فقط يمكنه المرور عبر الجسر mcp-remote.
{
  "mcpServers": {
    "adsbeast": {
      "type": "http",
      "url": "https://adsbeast.pro/api/mcp/workspace",
      "headers": {
        "Authorization": "Bearer absk_your_key"
      }
    }
  }
}

افحص الخادم يدويًا

  1. 1الأمر الأول يطبع قائمة الأدوات ولا يحتاج إلى مفتاح.
  2. 2الثاني يستدعي whoami بمفتاحك ويعيد المؤسسة وصلاحيات المفتاح.
macOS, Linux
curl -s https://adsbeast.pro/api/mcp/workspace \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Windows PowerShell
(Invoke-RestMethod -Method Post -Uri https://adsbeast.pro/api/mcp/workspace -ContentType "application/json" -Body '{"jsonrpc":"2.0","id":1,"method":"tools/list"}').result.tools.name
macOS, Linux
curl -s https://adsbeast.pro/api/mcp/workspace \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer absk_your_key" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'
Windows PowerShell
(Invoke-RestMethod -Method Post -Uri https://adsbeast.pro/api/mcp/workspace -ContentType "application/json" -Headers @{ Authorization = "Bearer absk_your_key" } -Body '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"whoami","arguments":{}}}').result.structuredContent | ConvertTo-Json -Depth 5

طلبات أولى للتجربة

  • استدعِ whoami في ADS Beast وأخبرني ما المؤسسة وما الصلاحيات التي يملكها هذا الاتصال.
  • اعرض ملخص لوحة الحملات والتنبيهات غير المقروءة.
  • افحص عنوان Google Ads هذا وفق حدود المنصة: "Plumber in Bratislava, same day".

إذا لم يعمل

  • الرد 401 يعني أن المفتاح مفقود أو مكتوب خطأ أو ملغى. المصافحة وقائمة الأدوات تستجيبان بلا مفتاح، فقد يعرض العميل الأدوات ثم يفشل عند أول استدعاء.
  • ظهور 403 في الرد يعني أن المفتاح تنقصه الصلاحية التي تحتاجها تلك الأداة. أداة whoami تعرض الصلاحيات التي يحملها المفتاح.
  • لا أدوات بعد تعديل ملف الإعداد: أعد تشغيل العميل أو أعد تحميل خوادم MCP فيه.

نفّذنا الأوامر الواردة في هذه الصفحة بأنفسنا بتاريخ 18 نوفمبر 2026، على إعداد نظيف وبمفتاح محدد الصلاحيات، على بيئة الإنتاج. وثائق المورّد