في ChatGPT، تتم إضافة خادم HilltopAds MCP كموصل مخصص (Custom Connector). ويتطلب إضافة موصلات MCP المخصصة تفعيل Developer mode في ChatGPT، وهي ميزة متاحة ضمن الخطط المدفوعة ويجب تفعيلها أولًا.
كيفية الاتصال في ChatGPT؟
1. فعّل Developer mode. انتقل إلى Settings → Security and login، ثم ابحث عن قسم Developer mode وقم بتفعيل المفتاح. يتيح هذا الوضع لـ ChatGPT إضافة موصلات مخصصة مثل HilltopAds MCP. ويظهر بجانبه تحذير ELEVATED RISK لأن هذه الموصلات يمكنها تعديل البيانات، وهو بالضبط ما تفعله عمليات الكتابة.
الخطوة 1 — فعّل Developer mode من Settings → Security and login.
2. افتح لوحة Plugins، ثم انقر على زر + لإضافة موصل جديد.
الخطوة 2 — لوحة Plugins، زر +.
3. املأ نموذج New Plugin:
Name — على سبيل المثال: HilltopAds MCP
Connection — اترك Server URL كما هو، ثم الصق:
https://mcp.hilltopads.com/mcpAuthentication — اختر OAuth
ضع علامة بجانب I understand and want to continue، ثم انقر على Create
الخطوة 3 — نموذج New Plugin مع عنوان URL للخادم ومصادقة OAuth.
4. في شاشة Add HilltopAds MCP to ChatGPT، انقر على Sign in with HilltopAds MCP.
الخطوة 4 — Sign in with HilltopAds MCP.
5. ستنتقل إلى صفحة HilltopAds MCP Authorization. الصق مفتاح API الذي أنشأته في الخطوة السابقة، ثم انقر على Authorize. لا حاجة إلى إدخال البريد الإلكتروني أو كلمة المرور.
الخطوة 5 — الصق مفتاح API في صفحة تفويض HilltopAds، ثم انقر على Authorize.
6. سيعرض ChatGPT الموصل على أنه متصل. أصبح كل شيء جاهزًا للاستخدام.
الخطوة 6 — تم توصيل الموصل، ويمكنك رؤية تفاصيله.
كيفية استخدامه في ChatGPT
ما عليك سوى كتابة طلبك بلغة طبيعية. سيحدد ChatGPT تلقائيًا أداة HilltopAds المناسبة لتنفيذ طلبك. على سبيل المثال:
"What operations are available to me in HilltopAds MCP"
"List my campaigns and their ads."
يعرض المساعد العمليات المتاحة وفقًا للصلاحيات الممنوحة لحسابك.
"List my campaigns and their ads"– يعرض المساعد ملخصًا للمخزون الإعلاني (Inventory) الخاص بك.
يمكنك أيضًا توجيه الطلب إلى الموصل مباشرةً عن طريق إرفاق HilltopAds MCP مع رسالتك، ثم كتابة طلب مثل:
"Show me my statistics for the last month by geo."
إرفاق موصل HilltopAds MCP بالطلب.
النتيجة: عرض إحصائيات المعلن مجمعة حسب GEO.
إنشاء حملة في ChatGPT
يمكن للموصل أيضًا إنشاء حملة نيابةً عنك. أخبر المساعد بما تريد، وسيجمع المعلومات المطلوبة، ويعرض لك الطلب الذي سيرسله بالتفصيل، ثم يطلب موافقتك قبل تنفيذ أي عملية كتابة.
في هذا المثال، يقوم المساعد أيضًا بإنشاء الحملة بحالة Inactive حتى تتمكن من مراجعتها أولًا. هذا مجرد سلوك افتراضي اختاره المساعد، وليس قاعدة ثابتة، لذا إذا كنت ترغب في ذلك، فاذكره صراحةً في طلبك.
1. اطلب إنشاء حملة، على سبيل المثال:
"I want to create a campaign."
سيعرض المساعد المعلومات المطلوبة، مثل اسم الحملة، وصيغة الإعلان، ونموذج التسعير، ورابط الصفحة المقصودة (Landing URL)، وقناة (أو قنوات) الترافيك، وقيمة المزايدة (Bid)، كما سيقترح نموذجًا من سطر واحد يمكنك تعبئته.
الخطوة 1 — يعرض المساعد البيانات المطلوبة ونموذجًا من سطر واحد لإدخالها.
2. إذا لم تكن متأكدًا من إحدى القيم، فما عليك سوى السؤال. على سبيل المثال:
"What channel names are available for pops according to documentation?"
سيجيب المساعد استنادًا إلى وثائق HilltopAds.
الخطوة 2 — التحقق من القيم المسموح بها؛ وتأتي الإجابة من الوثائق.
3. أرسل تفاصيل الحملة. سيعيد المساعد عرض إعدادات الحملة، ثم يطلب تأكيدك:
Allow ChatGPT to use HilltopAds MCP?
انقر على See details إذا أردت مراجعة الطلب بالكامل قبل الموافقة عليه.
الخطوة 3 — بطاقة تأكيد عملية الكتابة. استخدم See details لمراجعة الطلب.
4. تعرض نافذة التفاصيل الطلب بالكامل، حقلًا بحقل، بما في ذلك الصيغة، والنوع، والاسم، وعنوان URL، والقنوات، وقيمة المزايدة، وحالة التفعيل. انقر على Allow للمتابعة.
الخطوة 4 — عرض الطلب الكامل قبل منحه الإذن.
5. يؤكد المساعد إنشاء الحملة ويعرض معرّفها (ID). في هذا المثال، يتم إنشاء الحملة بحالة Inactive، لذلك لن يتم إنفاق أي ميزانية حتى تقوم بتشغيلها.
الخطوة 5 — تم إنشاء الحملة بنجاح، مع عرض ID الخاص بها، وتظل غير مفعّلة.
6. أصبحت الحملة الجديدة الآن موجودة في حسابك على HilltopAds، وهي جاهزة للمراجعة، وتمويلها، ثم تشغيلها.
الخطوة 6 — أصبحت الحملة متوفرة في حساب HilltopAds الخاص بك (لن يبدأ استقبال الترافيك حتى تقوم بتشغيلها).