ربط مساعد ذكاء اصطناعي

اربط مساعد ذكاء اصطناعي بـ Gloriads واسأله عن حسابك بلغة بسيطة.

يرى المساعد بالضبط ما تراه Gloriads API، ولا يغيّر شيئًا في حسابك.

ما يستطيع المساعد رؤيته

• كل ما تراه الـ API، ولا شيء غيره.
• لا شيء يستطيع تغييره: لا إعدادات، ولا فوترة.
• بياناتك تغادر Gloriads فعلًا. لا تربط إلا مساعدًا تثق به: فبعد أن يقرأ حسابك، يوقف إلغاء ربطه (الإعدادات ← API ← التطبيقات المتصلة) أي قراءة لاحقة، لكنه لا يستعيد ما قرأه بالفعل.

ما يمكنك أن تسأل عنه

• « كيف كان أداء إعلاناتي الشهر الماضي، وفي أي سوق أنفقت أكثر؟ »
• « هل ACOS لديّ أفضل من الشهر السابق؟ »
• « ما المنتجات التي سجّلت أسوأ ACOS خلال آخر 30 يومًا؟ »
• « اعرض إنفاقي يومًا بيوم هذا الشهر. »
• « اعرض حملاتي المتوقفة مؤقتًا في ألمانيا. »
• « ما الكلمات الرئيسية التي تستهدفها هذه الحملة؟ »
• « ما الذي غيّرته قواعدي هذا الأسبوع، في كل عرض أسعار على حدة؟ »

يقرأ المساعد الأرقام نفسها التي تعرضها لوحة التحكم: وقائمة ما يستطيع قراءته موجودة في ما تقرؤه الـ API.

العنوان، وما يحتاجه كل مساعد

عنوان واحد، هو نفسه لكل المساعدين:

https://gloriads.com/api/mcp

ويمكن لأي أداة أخرى تدعم خوادم MCP المخصصة استخدام العنوان نفسه.

كل شيء في صفحة واحدة داخل التطبيق، هي الإعدادات ← API: العنوان، والأوامر الجاهزة، ومفاتيحك. ولكل كتلة زر نسخ.

claude.ai

1. في claude.ai، افتح Customize في القائمة الجانبية.

2. افتح علامة التبويب Connectors.

3. انقر على Add، ثم Add custom connector.

4. سمِّه Gloriads، والصق https://gloriads.com/api/mcp، ثم انقر على Continue.

5. لا تغيّر شيئًا في الصفحة التالية: فقد اكتشف claude.ai أن Gloriads تتولى تسجيل دخولك وتنشر هويتها الخاصة. انقر على Add.

6. انقر على Connect.

7. سجّل الدخول إلى Gloriads إذا طُلب منك ذلك.

8. تحقق من التطبيق الذي يطلب الوصول، ثم انقر على سماح.

9. تعود بعد ذلك إلى claude.ai. في صفحة الموصّل، تحت Tool permissions، اختر Always allow: عندئذٍ يقرأ Claude أرقامك دون أن يستأذن في كل مرة، ولا يستطيع هذا الموصّل فعل أي شيء آخر.

في المحادثة، فعّل الموصّل إذا طلب منك التطبيق ذلك، ثم اطرح سؤالك.

اسأل Haiku. إنه أسرع نماذج Claude وأقلها تكلفة، وقراءة أرقامك لا تتطلب منه أكثر من ذلك. اختره من قائمة النماذج في محادثتك.

يمكن لحساب Claude المجاني إضافة موصّل مخصص واحد.

لإلغاء ربطه، افتح الإعدادات ← API ← التطبيقات المتصلة في Gloriads واختر إلغاء الربط. فيتوقف فورًا عن قراءة أرقامك.

Claude Desktop

يستخدم Claude Desktop الموصّلات نفسها التي يستخدمها claude.ai، فلا حاجة إلى تثبيت أي شيء آخر: أضف الموصّل من أي منهما، وسجّل الدخول، وانقر على سماح. وسيعمل بعد ذلك في كليهما.

ChatGPT

لا يُربط ChatGPT بالطريقة نفسها التي يُربط بها Claude: فخوادمه المخصصة متاحة عبر وضع المطوّر (developer mode)، الذي لا يتوفر إلا في باقات ChatGPT المدفوعة. إليك المسار كاملًا.

1. في إعدادات ChatGPT، فعّل developer mode.

2. افتح Plugins، ثم New plugin.

3. Name: اكتب Gloriads. الأيقونة والوصف اختياريان.

4. Connection: أبقِ على Server URL والصق https://gloriads.com/api/mcp.

5. Authentication: اختر OAuth. لا شيء لملئه تحته: فـ Gloriads تنشر إعداداتها على ذلك العنوان، وChatGPT يقرأها.

6. حدّد I understand and want to continue (يعرض ChatGPT هذا التحذير لكل خادم مخصص، بما في ذلك خادمنا)، ثم انقر على Create.

7. يفتح ChatGPT صفحة Gloriads: سجّل الدخول إذا طُلب منك ذلك، وتحقق من أن التطبيق الذي يطلب الوصول هو ChatGPT، ثم انقر على سماح.

8. في المحادثة، فعّل الإضافة قبل طرح سؤالك الأول.

9. اختر مقدار ما يُسمح لـ ChatGPT بفعله بنفسه، في Settings ← Plugins ← Gloriads ← Permissions. يكفي Allow read actions: فهذا الموصّل لا يستطيع إلا القراءة. أما Allow all actions فمُصنَّف بأنه عالي المخاطر ولا يضيف لك شيئًا هنا.

لإلغاء ربطه، افتح الإعدادات ← API ← التطبيقات المتصلة في Gloriads واختر إلغاء الربط، تمامًا كما في claude.ai.

Claude Code

أنشئ مفتاحًا من الإعدادات ← API ← إنشاء مفتاح، وسمِّه « Claude Code »، وانسخه. فهو لا يُعرض إلا مرة واحدة.

ثم شغّل هذا الأمر في الطرفية، مع وضع مفتاحك مكان YOUR_API_KEY:

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

• تحقق منه بالأمر claude mcp list، أو بالأمر /mcp داخل Claude Code.
• يُضاف الخادم إلى المشروع الحالي. أضف --scope user لاستخدامه في كل مكان.
• لإزالته: claude mcp remove gloriads.

Cursor

ضع مفتاحك في متغير البيئة GLORIADS_API_KEY، ثم الصق ما يلي في ~/.cursor/mcp.json (لكل مشاريعك) أو في .cursor/mcp.json (لمشروع واحد):

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

يقرأ Cursor المفتاح من ذلك المتغير، فلا يحتويه الملف أبدًا. اضبط المتغير قبل فتح Cursor.

VS Code

افتح MCP: Open User Configuration من لوحة الأوامر (Command Palette) لكل مشاريعك، أو أنشئ .vscode/mcp.json في مشروع، وأضف:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

يطلب VS Code المفتاح في أول مرة يبدأ فيها الخادم ويتذكره، فلا يحتويه الملف أبدًا.

الأدوات التي يستخدمها

يختار المساعد الأداة المناسبة لسؤالك. وتقرأ كل أداة جزءًا واحدًا من الـ API.

من المفيد معرفة ما يلي

• الأرقام نفسها التي في التطبيق. تذكر كل إجابة الفترة والعملة اللتين استخدمتهما، وتنبّه عندما يكون رقم ما غير مكتمل.
• المفتاح يقرأ حسابك كله. أبعده عن الملفات المشتركة، وأبطله من الإعدادات ← API يوم تتوقف عن استخدام المساعد.
• حدود مشتركة مع الـ API: 60 طلبًا في الدقيقة و10,000 طلب في اليوم لحسابك. وقد يكلّف سؤال واحد عدة طلبات. راجع الحدود والأخطاء.
• جرّبه دون حساب في أداة للمطوّرين: مفتاح العرض التوضيحي العام في مرجع API يعمل هنا أيضًا، ويقرأ الأرقام التركيبية لحساب العرض التوضيحي.