Google Ads MCP Server: ربط Google Ads مع Claude (الرسمي)

اطرح سؤالًا على حساب إعلاناتك بلغة طبيعية وبسيطة، واحصل على الإجابة خلال ثوانٍ. هذا ما يَعِد به خادم Google Ads MCP، وهو جسر مفتوح المصدر من Google يتيح لمساعد ذكاء اصطناعي مثل Claude قراءة بيانات حملاتك المباشرة، بدلًا من انتظارك لتصدير ملف CSV آخر. وهو المسار الرسمي: تنشره Google في مؤسستها googleads على GitHub بموجب ترخيص Apache 2.0، وهو حاليًا للقراءة فقط بصرامة. يمكنه الاطلاع على كل شيء، ولا يمكنه تغيير أي شيء.

يشرح هذا المقال كيفية ربط Google Ads مع Claude، وأي الأسئلة تستحق أن تُطرح أولًا، وأي الفخاخ تنتج أرقامًا خاطئة دون أن تلاحظ. هناك تغيير حديث مهم: أوقفت Google توكنات المطورين نهائيًا في 9 سبتمبر 2026، لذلك تصف كثير من الشروحات القديمة خطوة إعداد لم تعد لازمة. يتبع كل ما يلي الوثائق الحالية لـ Google وملف README الخاص بالمشروع.

ما الذي يفعله الخادم الرسمي

بروتوكول سياق النموذج (MCP) معيار يتيح لعميل الذكاء الاصطناعي استدعاء أدوات يوفرها برنامج منفصل. يغلّف خادم Google واجهة Google Ads API داخل ثلاث من هذه الأدوات، فيستطيع Claude العثور على حساباتك وتشغيل الاستعلامات والبحث عن تعريفات الحقول دون أن تكتب سطر تكامل برمجي واحدًا. يعمل الخادم على جهازك عبر stdio، ويتعامل Claude معه كما يتعامل مع أي خادم MCP آخر.

إليك ما يتغير مقارنةً بروتين التصدير الأسبوعي الذي ما زال معظم المعلنين يتبعونه:

ثلاث أدوات، للقراءة فقط

عمليًا، لن تكتب الاستعلام بنفسك أبدًا. تقول: "أي الحملات أنفقت الأكثر الأسبوع الماضي؟"، فيتحقق Claude من الحقول الموجودة، ثم يبني استعلام GAQL، ويشغّله عبر search، ويلخّص الصفوف. ما زال بإمكانك قراءة الاستعلام الذي شغّله، وهذه هي الطريقة التي تكتشف بها الأخطاء.

ما الذي لا يستطيع فعله

توضح وثائق Google الأمر بصراحة: التنفيذ "لا يمكنه تعديل المزايدات أو إيقاف الحملات أو إنشاء أصول جديدة". وهذا يستبعد:

• تغيير الميزانيات أو المزايدات
• إيقاف الحملات أو تفعيلها
• إنشاء الإعلانات أو تعديلها
• رفع تصميمات إبداعية جديدة

💡 القراءة فقط ميزة. الإجابة الخاطئة من النموذج تكلفك ظهيرة سيئة، لا ميزانية مستنزفة، لأنه لا يملك وسيلة لدفع أي تغيير إلى الحساب.

قبل أن تربط أي شيء

يجب توفر ثلاثة أشياء قبل أن يصبح ملف الإعداد ذا أهمية: مشروع Google Cloud بمستوى الوصول الصحيح، وبيانات اعتماد تعمل، وأدوات محلية لتشغيل الخادم. تجاهل أيٍّ منها ينتج أخطاء تبدو غير مرتبطة بالسبب الحقيقي.

مشروع Cloud ومستوى الوصول

يُضاف معرّف مشروع Google Cloud الخاص بك إلى الإعداد بوصفه GOOGLE_PROJECT_ID. افتح صفحة نظرة عامة على Google Ads API في وحدة تحكم Cloud، وتأكد من أن المشروع يقع ضمن أحد مستويات الوصول الثلاثة المدرجة هناك: المستوى المبدئي، أو Basic، أو Standard. إذا لم يكن لديه أيٌّ منها، فقدّم طلبًا للحصول على واحد. ترتبط مستويات الوصول الآن بمشروع Cloud، وهذا بالضبط ما جعل توكنات المطورين غير ضرورية.

توكنات المطورين لم تعد موجودة

تنص وثائق Google على أن توكنات المطورين (GOOGLE_ADS_DEVELOPER_TOKEN) أُوقفت في 9 سبتمبر 2026، ولم تعد مطلوبة في أحدث إصدار من الخادم. ما زال ملف README على GitHub يدرج هذا المتغير كخيار اختياري، لذا إن ثبّتّ إصدارًا أقدم فقد تحتاج إلى ضبطه. في الإصدار الحالي، احذفه.

💡 تحقّق من تاريخ أي شرح. إذا طلب منك أن تتقدم بطلب للحصول على توكن مطور وتنتظر الموافقة، فهو يصف المسار القديم.

بيانات اعتماد OAuth أو ADC

تحتاج إلى أحد أمرين: زوج معرّف عميل ورمز سري من OAuth 2.0 منشأ في المشروع نفسه، أو مجموعة من Application Default Credentials (ADC). النطاق المطلوب هو https://www.googleapis.com/auth/adwords. يُعد ADC عبر أداة سطر الأوامر gcloud الطريق الأقصر لمستخدم واحد، وهو ما تستخدمه الأوامر أدناه.

جهّز هذه الأشياء قبل أن تكمل:

• pipx مثبّت، وهي أداة Python تشغّل الخادم مباشرةً من GitHub
• أداة سطر الأوامر gcloud مثبّتة ومسجّل الدخول إليها
• مستخدم Google لديه صلاحية الوصول إلى حساب Google Ads
• معرّف مشروع Cloud الخاص بك

ربط Claude خطوة بخطوة

تسجيل الدخول باستخدام gcloud

شغّل أمر تسجيل الدخول مع النطاقين اللذين يحتاجهما الخادم، مع الإشارة إلى ملف عميل OAuth الذي نزّلته:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

نسخ الأمر النصي

تفتح نافذة متصفح، فتوافق على النطاقات، ويكتب gcloud ملف بيانات اعتماد بصيغة JSON. لاحظ المكان الذي يُحفظ فيه، لأن هذا المسار يصبح GOOGLE_APPLICATION_CREDENTIALS. الفرق التي تفضّل حسابات الخدمة يمكنها استبدال ذلك بـ --impersonate-service-account=SERVICE_ACCOUNT_EMAIL مع النطاقات نفسها.

أضفه إلى Claude Desktop

افتح ملف إعداد Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json على macOS أو %APPDATA%\Claude\claude_desktop_config.json على Windows. أضف الخادم:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

نسخ الأمر النصي

أغلق Claude Desktop تمامًا ثم أعد فتحه. يُنزّل التشغيل الأول الخادم عبر pipx، لذا توقّع توقفًا قصيرًا. للإعدادات القابلة للتكرار، يقترح ملف README تثبيت إصدار منشور باستخدام pipx run --spec "google-ads-mcp==X.Y.Z" google-ads-mcp بدلًا من اتباع أحدث حالة للمستودع.

Claude Code بأمر واحد

يمكن لـ Claude Code تسجيل الخادم نفسه من الطرفية:

claude mcp add google-ads-mcp \
  --env GOOGLE_PROJECT_ID=your-project-id \
  --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json \
  -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

نسخ الأمر النصي

بعد ذلك، شغّل /mcp داخل Claude Code، وتأكد من ظهور google-ads-mcp بحالة متصل.

اختبر بسؤال واحد

اطرح الأمر النصي النموذجي من وثائق Google: "What customers do I have access to?". ينبغي أن يستدعي Claude list_accessible_customers ويعيد معرّفات الحسابات وأسماءها. إذا تعطّل شيء، يسرد هذا الجدول المشتبه بهم المعتادين:

هذه أرجح الأسباب، وليست فهرسًا رسميًا للأخطاء، لذا اقرأ الرسالة الفعلية التي يعرضها Claude قبل أن تغيّر أي شيء.

أسئلة تستحق أن تُطرح أولًا

ابدأ بالعثور على حساباتك. يعطيك السؤال "What customers do I have access to?" معرّفات العملاء المكوّنة من 10 أرقام، مكتوبة بلا شرطات، والتي يحتاجها كل استعلام لاحق. أخبر Claude بالمعرّف الذي تعمل عليه مرة واحدة، وسيعيد استخدامه طوال المحادثة. ثم انتقل إلى أسئلة توفر وقتًا حقيقيًا. تُظهر الاستعلامات أدناه ما يميل Claude إلى بنائه خلف الكواليس، حتى تتمكن من التحقق منه.

سحب أداء أسبوعي

يقدّم الأمر النصي النموذجي الثاني من Google عبارة "How is my campaign performance this week?"، وهذا مثال معقول لصياغة الاستعلام الذي يقف خلفه:

SELECT
  campaign.name,
  metrics.cost_micros,
  metrics.clicks,
  metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC
LIMIT 10

نسخ الأمر النصي

انتبه إلى cost_micros. تخزن Google Ads الأموال بوحدة micros، لذا فإن 12,500,000 تعني 12.50 بعملة الحساب. النموذج الذي ينسى القسمة سيُبلغ عن إنفاق أعلى بمليون مرة، لذا اطلب منه أن يحوّل القيم وأن يذكر العملة.

البحث عن الإنفاق المهدور

أكثر مشروع مفيد في البداية هو مراجعة عبارات البحث. يجد هذا الاستعلام العبارات التي أنفقت أكثر من 5 وحدات من العملة خلال 30 يومًا ولم تحقق أي تحويل:

SELECT
  search_term_view.search_term,
  campaign.name,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
  AND metrics.cost_micros > 5000000
ORDER BY metrics.cost_micros DESC
LIMIT 25

نسخ الأمر النصي

أعد الصفوف إلى Claude واطلب منه تجميعها في موضوعات: الباحثون عن عمل، والباحثون عن المجاني، والمنتج الخطأ، والموقع الخطأ. تصبح هذه الموضوعات قائمة الكلمات السلبية لديك، ثم تضيفها بنفسك في واجهة Google Ads، لأن الخادم لا يستطيع الكتابة.

بعض الأوامر الإضافية التي تستحق الاحتفاظ بها في ملاحظة:

💡 اذكر نطاق التاريخ والعملة في كل مرة. الأوامر الغامضة هي المكان الذي تبدأ فيه الأخطاء الصامتة. "آخر 30 يومًا، باليورو" أفضل من "مؤخرًا". ثم تحقّق من رقم واحد مقابل واجهة Google Ads قبل أن تثق بالباقي.

السلامة والبيانات والحدود

بياناتك تصل إلى النموذج

يحذّر ملف README من أن الخادم "سيكشف بياناتك للوكيل أو النموذج اللغوي الذي تربطه به". ويشير أيضًا إلى أن ترويسة إضافية تُضاف إلى طلبات API الخاصة بك، تستخدمها Google لتحسين المنتج. قبل أن تربط حساب وكالة يحتوي على بيانات عملاء، راجع عقدك وسياسة عميلك. عامل الربط كما تعامل إرسال تقرير بالبريد الإلكتروني: أي شيء يُرجعه الاستعلام يصل إلى النموذج.

إجراء وقائي بسيط: سجّل الدخول بمستخدم Google يقتصر وصوله إلى الحساب على ما يحتاجه العمل. يتصرف الخادم بصلاحيات المستخدم الذي سجّل الدخول، لذا تُطبَّق صلاحيات ذلك المستخدم فوق تصميم الخادم الخاص للقراءة فقط.

حسابات المدير والاستضافة

إذا وصلت إلى حساب عميل عبر حساب مدير (MCC)، فاضبط GOOGLE_ADS_LOGIN_CUSTOMER_ID على معرّف العميل الخاص بالمدير في كتلة env. تشير Google إلى أنه مطلوب لهذه الحالة.

يستخدم الإعداد المحلي أعلاه stdio ويناسب شخصًا واحدًا. توثّق Google أيضًا نشرًا على Cloud Run للفرق. هناك يحتاج الخادم إلى المتغيرات GOOGLE_ADS_MCP_OAUTH_CLIENT_ID و GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET و FASTMCP_HOST=0.0.0.0، ويوجّه إعداد العميل httpUrl إلى مسار /mcp الخاص بخدمتك.

الخوادم الرسمية مقابل خوادم المجتمع

توجد كثير من خوادم Google Ads MCP التي بناها المجتمع، وقد يقدم بعضها صلاحية الكتابة. تحقّق من النطاقات والقدرات قبل توجيه أي منها إلى حساب فعلي.

حوّل الرؤى إلى تصميمات إعلانية

يخبرك خادم MCP بما يجب إصلاحه، لكنه لا يصنع الصور. بعد أن يوضح Claude أي موضوعات بحث تحقق تحويلات، ما زلت تحتاج إلى مرئيات ونصوص جديدة لها، وهنا يأتي دور PicassoIA. لا يربط شيء هنا PicassoIA بحساب إعلاناتك، لذا عليك نقل النتائج بنفسك.

لنفترض أن البيانات تُظهر أن "waterproof hiking boots" يحقق تحويلات بجزء صغير من تكلفة "cheap boots". اطلب من Claude ثلاث زوايا بصرية للموضوع الفائز: لقطة قريبة لمسار موحل، ولقطة لأسلوب حياة في يوم ممطر، وحذاء على عتبة باب. ثم ولّد كل واحدة. طابق نسبة العرض إلى الارتفاع مع موضع الإعلان: 1:1 للخلاصات، و16:9 للبانرات العريضة، و9:16 لفيديو عمودي.

أمر نصي يعمل جيدًا لهذا النوع من مفاهيم الإعلانات يسمّي الشخص والمكان والإضاءة والعدسة، ويذكر بوضوح ما يجب تجنّبه:

لقطة قريبة لأحذية تنزه مقاومة للماء وموحلة على مسار غابة مبتل عند الفجر، ضوء جانبي ناعم، عمق ميدان ضحل، عدسة 50 مم، واقعي كالصور الفوتوغرافية، بلا نص، بلا شعارات.

أنشئ نسختين أو ثلاثًا، واحتفظ بالنسخة التي تطابق الزاوية التي تفضّلها بياناتك، وتخلّص من البقية. اجعل الأسلوب طبيعيًا: صورة تبدو حقيقية للحظة واقعية تناسب إعلان حذاء التنزه أفضل من صورة مصقولة مُصيَّرة.

كيفية استخدام Claude Sonnet 5

Claude Sonnet 5 على PicassoIA هو مكتب الكتابة في هذا المسار. لا يشغّل خادم Google Ads MCP. تلصق فيه ما أعادته جلسة MCP لديك، فيصوغ نص الإعلان. الخطوات:

1. افتح صفحة Claude Sonnet 5 على PicassoIA.
2. املأ System Prompt مرة واحدة: "أنت تكتب إعلانات البحث المتجاوبة في Google. يجب أن تبقى العناوين أقل من 30 حرفًا، والأوصاف أقل من 90 حرفًا. لغة بسيطة، بلا مبالغة، وبلا ادعاءات لا يمكننا إثباتها."
3. الصق بياناتك في Prompt: أعلى عبارات البحث تحويلًا، وعناوينك الحالية، والعرض.
4. اختر مستوى Effort. المستوى الافتراضي، low، يوقف التفكير ويجيب بأسرع وقت، وهذا مناسب لنسخ الإعلانات المختلفة. استخدم high أو max عندما تريد خطة إعادة هيكلة لحساب فوضوي.
5. أبقِ Max Tokens على 8,192 ما لم ترِد مخرجات أقصر.
6. اختياريًا، أرفق Image، مثل لقطة شاشة لمخطط أداء. يقرأها النموذج كسياق.
7. راجع المسودة، وعدّلها، والصق النص في Google Ads بنفسك.

تقبل إعلانات البحث المتجاوبة حتى 15 عنوانًا و4 أوصاف، لذا يملأ تشغيل واحد إعلانًا كاملًا. هل تريد رأيًا ثانيًا؟ شغّل الأمر نفسه عبر Gemini 3.5 Flash أو Claude Opus 4.7، وقارن المسودات جنبًا إلى جنب.

أنشئ مرئيات إعلاناتك الخاصة اليوم

تخبرك البيانات بما يجب اختباره، والمرئيات تقرر ما إذا كان أحد سيتوقف عن التمرير. افتح PicassoIA Image، والصق أمرًا نصيًا لأفضل موضوع لديك يحقق تحويلات، واختر 1:1 أو 16:9، ثم ولّد أي عدد تشاء من الإصدارات، لأن النموذج لا يفرض حدًا لكل صورة. ثبّت قيمة البذرة عندما تنجح تركيبة واحدة، ثم غيّر الصياغة وحدها لاختبار فروق صغيرة.

يشغّل PicassoIA أيضًا اتصال MCP خاصًا به، لذا يمكن أن يطلب Claude، الذي يقرأ بيانات Google Ads لديك، صورًا ومقاطع فيديو في المحادثة نفسها. انظر صفحة PicassoIA API للتفاصيل، وتحقّق من الخطة التي تتضمن الوصول.

جرّب هذا الليلة: اربط خادم Google Ads MCP، وشغّل استعلام الإنفاق المهدور، واختر أفضل موضوع يحقق تحويلات، وولّد خمسة إصدارات بصرية على Picasso IA قبل أن تكتب أي شيء آخر. في الأسبوع القادم، شغّل استعلام الأداء الأسبوعي من جديد، وانظر أي إصدار كسب النقرات.