دليل تقني محدث

Meta Developer Tools MCP: ربط Claude وChatGPT وCursor وCodex بمنصة Meta

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

آخر تحقق: 4 أغسطس 2026المصدر الأساسي: Meta for Developersالحالة المعلنة: Beta
الإجابة المختصرة: Meta Developer Tools MCP هو خادم بعيد رسمي يربط حسابك في Meta for Developers بمساعد متوافق مع MCP، مثل Claude أو ChatGPT أو Cursor أو Codex. بعد المصادقة عبر OAuth يستطيع المساعد استخدام أدوات Meta المتاحة لفهم التطبيقات التي تملك صلاحية عليها، والبحث في وثائق المطورين، وفحص App Review والامتثال والاستخدام واشتراكات Webhooks، مع اختلاف العمليات المتاحة بحسب الصلاحيات التي تمنحها.

ما هو Meta Developer Tools MCP؟

عند تطوير تكامل على WhatsApp أو Instagram أو Messenger أو Facebook أو Threads، تتوزع المعلومات عادة بين لوحة التطبيق، وصفحات App Review، وإعدادات Webhooks، وتقارير الاستخدام، ووثائق واجهات Meta. خادم Developer Tools MCP يجعل هذه الطبقات قابلة للوصول من خلال محادثة واحدة داخل أداة التطوير أو المساعد الذكي.

MCP اختصار لـ Model Context Protocol. فكرته أن يقدّم النظام الخارجي مجموعة أدوات منظمة يستطيع المساعد استدعاءها بدل الاعتماد على التخمين أو على نسخة قديمة من المعلومات. هنا يكون النظام الخارجي هو منصة Meta للمطورين، ويكون العميل هو Claude أو ChatGPT أو Cursor أو Codex أو عميل آخر يدعم Remote MCP وOAuth.

الفرق المهم: هذا الخادم مخصص لإدارة وفحص تطبيقات وتكاملات Meta للمطورين. ليس هو Meta Ads MCP المخصص لإدارة الحملات الإعلانية، وليس بديلًا عن Graph API الذي يستخدمه تطبيقك في الإنتاج.

لماذا أطلقت Meta هذه الأداة؟

المشكلة التي تعالجها الأداة هي التشتت. قد يعرف المساعد الكود الموجود في مشروعك، لكنه لا يعرف تلقائيًا حالة التطبيق الفعلية في Meta: هل الصلاحية معتمدة؟ هل توجد ملاحظة امتثال؟ ما الحقول المشتركة في Webhook؟ وهل اقترب التطبيق من حد استخدام؟ وعند البحث اليدوي قد تخلط بين إصدار قديم من Graph API ووثيقة محدثة.

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

ما الأدوات التي يمكن ربطها؟

Claude

يشمل ذلك عملاء Claude الذين يدعمون إضافة خادم MCP بعيد والمصادقة عبر المتصفح.

ChatGPT

يتم الربط بإنشاء Connector مخصص بعد تفعيل Developer Mode في إعدادات Connectors.

Cursor

يمكن إضافته كخادم MCP بعيد داخل بيئة Cursor، ثم إتمام OAuth بحساب Meta للمطور.

Codex

توضح Meta إعداد Codex App بإضافة Streamable HTTP Server ثم إعادة تشغيل التطبيق والتحقق من التسجيل.

هذه ليست قائمة مغلقة من حيث المبدأ. أي عميل يدعم Remote MCP عبر Streamable HTTP ويدعم تدفق OAuth المتوافق قد يتمكن من الاتصال، لكن نجاحه يعتمد على توافق تنفيذ OAuth في العميل وقبول Meta لعنوان إعادة التوجيه.

كيف يعمل الاتصال؟

  1. تضيف الخادم إلى عميل MCP. تستخدم اسمًا واضحًا مثل Meta Developer Tools وعنوان الخادم الرسمي.
  2. يفتح العميل تسجيل دخول Meta. لا يفترض أن تضع App Secret أو كلمة مرور Facebook داخل ملف الإعداد.
  3. تسجل الدخول بحساب المطور. تظهر لك عملية OAuth وتوافق على نطاق الوصول المطلوب.
  4. يرتبط الوصول بأدوارك. ما يمكن عرضه أو إدارته يتأثر بالتطبيقات والأعمال التي يملك حسابك دورًا عليها والصلاحيات التي منحتها للموصل.
  5. يستدعي المساعد الأدوات عند الحاجة. يعرض العميل عادة اسم الأداة أو يطلب تأكيدك، خاصة قبل أي عملية تغيير.
Server name: Meta Developer Tools
Transport: Streamable HTTP
Server URL: https://mcp.facebook.com/devtools
Authentication: OAuth with your Meta developer account
لا تضف App Secret أو Access Token يدويًا إلى أوامر المحادثة ما دام تدفق OAuth الرسمي هو المطلوب. وإذا عرض عليك موقع أو دليل عنوان خادم مختلفًا، ارجع إلى وثائق Meta قبل الاتصال.

ماذا يستطيع المساعد أن يفعل بعد الربط؟

تقسم Meta الوصول عمليًا إلى معلومات قابلة للقراءة وعمليات إدارة تعتمد على النطاق الممنوح. لا تفترض أن كل عميل أو كل حساب سيعرض جميع الأدوات؛ فالخدمة في Beta وقد يتغير السطح المتاح.

المجالأمثلة عمليةما الذي يجب التحقق منه؟
التطبيقاتعرض التطبيقات التي يستطيع حسابك الوصول إليها، وفهم إعدادات التطبيق ومنتجاته وأدوارك عليه.تأكد من App ID الصحيح، خصوصًا إذا كانت لديك تطبيقات بأسماء متشابهة.
البحث في الوثائقالبحث عن واجهة API أو صلاحية أو متطلب إعداد من وثائق Meta للمطورين ضمن سياق المهمة.اطلب رابط الوثيقة وتاريخها، ولا تعتمد على التلخيص وحده في القرارات الحساسة.
App Reviewفحص الصلاحيات والميزات المطلوبة وحالتها ومعرفة ما إذا كانت هناك مراجعة أو وصول متقدم مرتبط بالتطبيق.ميّز بين Standard Access وAdvanced Access وبين الموافقة على التطبيق وإتاحة الأصل التجاري.
الامتثالإظهار الإجراءات المطلوبة أو عناصر الامتثال التي قد تحتاج إلى انتباه فريق التطوير.لا تعتبر غياب تنبيه واحد إثباتًا نهائيًا على اكتمال جميع التزامات النشاط.
الاستخدام والحدودفهم بيانات الاستخدام أو مؤشرات الحدود التي تعرضها أدوات Meta للتطبيق.حدود Graph API قد تختلف حسب الواجهة والإصدار ونوع الأصل.
Webhooksعرض الاشتراكات والحقول، وفحص إعداد Webhook، وقد تتاح عمليات إدارة أو اختبار حسب النطاق.أي تعديل قد يوقف استقبال الأحداث؛ راجع التطبيق والمنتج والـcallback والحقول قبل التأكيد.

ما الذي لا يعنيه هذا الربط؟

  • لا يمنح حسابك صلاحيات على تطبيق لا تملك دورًا عليه.
  • لا يحول الصلاحيات المرفوضة إلى صلاحيات معتمدة ولا يتجاوز App Review.
  • لا يضمن ظهور ميزة ما لحسابك إذا كانت في طرح محدود أو تتطلب أهلية منفصلة.
  • لا يستبدل اختبارات API وWebhooks الفعلية في بيئة التطوير.
  • لا يجعل كل طلب صحيحًا تلقائيًا؛ المساعد قد يختار تطبيقًا أو أصلًا غير مقصود إذا كان وصفك مبهمًا.
  • لا يعني أن Claude أو ChatGPT أو Cursor أو Codex يحصل على كلمة مرورك؛ المصادقة تتم عبر OAuth، لكنك تظل مسؤولًا عن مراجعة نطاق الوصول.

الإعداد على الأدوات المدعومة

واجهات البرامج تتغير، لذلك استخدم المسار التالي بوصفه مطابقًا للوثائق وقت التحقق، ثم ارجع إلى صفحة Meta إذا تغير اسم القائمة في إصدار أحدث.

الإعداد على ChatGPT

  1. افتح Settings ثم Connectors.
  2. ادخل إلى Advanced settings وفعّل Developer Mode.
  3. ارجع إلى صفحة Connectors واختر إنشاء Connector جديد.
  4. اكتب اسمًا مثل Meta Developer Tools وأدخل عنوان الخادم https://mcp.facebook.com/devtools.
  5. احفظ الاتصال، ثم أكمل تسجيل الدخول إلى Meta عبر OAuth وراجع الصلاحيات المطلوبة.
  6. ابدأ بمهمة قراءة آمنة، مثل طلب عرض التطبيقات المتاحة، قبل تجربة أي عملية إدارة.

الإعداد على Claude

  1. افتح إعدادات Integrations أو Connectors في عميل Claude الذي تستخدمه.
  2. اختر إضافة تكامل أو MCP Server بعيد.
  3. استخدم عنوان الخادم الرسمي واختر النقل البعيد المدعوم.
  4. أكمل نافذة OAuth بحساب Meta Developer، ثم اسمح بالوصول المناسب.
  5. تحقق من ظهور أدوات Meta داخل المحادثة، وابدأ بطلب قراءة لا يغيّر الإعدادات.
قد تختلف أسماء القوائم بين Claude Desktop وClaude Code وإصداراتهما. لا تنسخ إعدادًا محليًا يعتمد على أمر تشغيل إذا كانت وثائق Meta تعرض الخادم كاتصال بعيد؛ استخدم Remote MCP.

الإعداد على Cursor

  1. افتح إعدادات Cursor ثم قسم MCP أو Tools & Integrations بحسب إصدار الواجهة.
  2. أضف خادمًا بعيدًا باسم Meta Developer Tools.
  3. أدخل https://mcp.facebook.com/devtools بدل إعداد أمر محلي.
  4. فعّل الخادم وأكمل OAuth في المتصفح.
  5. افتح مشروعك واطلب من Agent فحص حالة تطبيق محدد مع ذكر App ID صراحة.

الإعداد على Codex App

  1. افتح Settings من رمز الترس أسفل اليسار.
  2. اختر MCP Servers ثم Add servers.
  3. اختر Streamable HTTP.
  4. ضع الاسم Meta Developer Tools والعنوان https://mcp.facebook.com/devtools.
  5. أكمل OAuth، ثم أعد تشغيل Codex App كما توضح وثائق Meta.
  6. تحقق من ظهور إدخال الخادم في ملف ~/.codex/config.toml، ثم اختبر طلبًا للقراءة.

الإعداد على عميل MCP آخر

استخدم Remote MCP مع Streamable HTTP وOAuth. إذا كان العميل لا يدعم OAuth للخوادم البعيدة، أو يستخدم callback غير مقبول لدى Meta، فقد يفشل الاتصال حتى لو كان يدعم MCP نظريًا. لا تحاول تجاوز المصادقة بوضع Access Token ثابت دون أن تنص وثائق Meta على ذلك.

أول اختبار بعد نجاح الربط

ابدأ بالتدرج التالي حتى تتأكد من أن الاتصال يعمل على التطبيق الصحيح:

  1. اطلب: «اعرض تطبيقات Meta التي يمكنني الوصول إليها مع App ID ودوري على كل تطبيق».
  2. اختر تطبيقًا واحدًا واطلب تلخيص منتجاته وصلاحياته دون إجراء أي تعديل.
  3. اطلب حالة App Review والإجراءات المطلوبة للتطبيق المحدد.
  4. اطلب عرض Webhook subscriptions فقط، مع المنتج والحقول وعنوان callback.
  5. إذا احتجت تعديلًا، اطلب أولًا خطة التغيير والقيمة الحالية والجديدة، ثم أكد العملية بعد مراجعتها.

أمثلة أوامر عملية

اعرض تطبيقات Meta التي أملك صلاحية عليها،
واذكر App ID ودوري على كل تطبيق. لا تنفذ أي تعديل.
افحص App ID: 123456789
وأخبرني بحالة App Review والصلاحيات والميزات المطلوبة
وأي إجراء امتثال معلق. أرفق رابط الوثيقة الرسمية لكل نتيجة.
اعرض Webhook subscriptions لتطبيق App ID: 123456789.
اذكر المنتج والـcallback URL والحقول المشترك بها فقط.
لا تضف أو تحذف أو تعدل أي اشتراك.
ابحث في وثائق Meta الرسمية عن الصلاحية
instagram_business_manage_messages.
اشرح متطلبات الوصول الحالي، ولا تعتمد على مصادر خارج Meta.
قبل تنفيذ أي تغيير على التطبيق، اعرض:
1) القيمة الحالية
2) التغيير المقترح
3) الأثر المحتمل
4) طريقة التراجع
وانتظر تأكيدي.

الأمان والصلاحيات: أهم جزء قبل الاستخدام

  • استخدم حسابك الحقيقي عبر OAuth فقط: لا ترسل كلمة المرور أو App Secret أو رمز وصول داخل المحادثة.
  • ابدأ بأقل صلاحية: إذا كان هدفك التدقيق فقط، اختر نطاق القراءة ولا تمنح الإدارة إلا عند الحاجة.
  • حدد App ID: لا تقل «عدّل تطبيقي» إذا كان لديك أكثر من تطبيق.
  • افصل القراءة عن التنفيذ: اطلب عرض الوضع الحالي أولًا، ثم اطلب خطة، ثم وافق على التغيير.
  • انتبه إلى Webhooks: حذف اشتراك أو تغيير callback قد يوقف الرسائل والأحداث فورًا.
  • راجع أدوات الطرف الثالث: اتصل فقط بعنوان Meta الرسمي وتأكد من اسم النطاق قبل تسجيل الدخول.
  • ألغِ الوصول عند الانتهاء: إذا كان الاتصال مؤقتًا أو على جهاز غير دائم، افصل الموصل وراجع التطبيقات المصرح لها في حسابك.
قاعدة عملية: تعامل مع المساعد كما تتعامل مع مطور لديه وصول إلى لوحة تطبيقاتك. امنحه الحد الأدنى، وراقب ما سيغيّره، واحتفظ بقيمة الإعداد السابقة قبل أي عملية تعديل.

حل المشكلات الشائعة

المشكلةالتحقق المقترح
الخادم لا يظهر في الأداةتحقق من اختيار Streamable HTTP ومن العنوان الرسمي، ثم أعد تشغيل العميل إذا كانت تعليماته تتطلب ذلك.
لا تفتح نافذة تسجيل الدخولتأكد من أن العميل يدعم OAuth لخادم MCP بعيد، وأن المتصفح لا يمنع النوافذ أو إعادة التوجيه.
التطبيق المطلوب غير ظاهرسجل الدخول بحساب Meta الصحيح، وتأكد من وجود دور فعلي لك على التطبيق أو النشاط التجاري المرتبط.
أداة القراءة تعمل والإدارة لا تعملقد يكون الاتصال ممنوحًا نطاق القراءة فقط، أو أن دورك على التطبيق لا يسمح بالتغيير.
تختلف النتيجة عن لوحة Metaحدد App ID والأصل المطلوب، واطلب تحديث القراءة. إذا استمر التعارض فلوحة Meta والواجهة الرسمية هما المرجع النهائي.
الميزة غير متاحة للحسابالخدمة في Beta وقد يكون الطرح تدريجيًا. تحقق من وثائق Meta وحسابك بدل افتراض أن كل الحسابات مؤهلة.

كيف يمكن أن يفيد فريق أوتوربلاي؟

بالنسبة لفريق يدير تكاملات WhatsApp وInstagram وتطبيقات Meta متعددة، القيمة الأكبر ليست كتابة الكود تلقائيًا، بل تقليل وقت التحقق والتشخيص. يمكن استخدامه لمراجعة صلاحيات تطبيق محدد، مقارنة حالة App Review بما يحتاجه التكامل، فحص Webhooks قبل تغييرها، والبحث في وثائق Meta من داخل بيئة العمل.

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

أسئلة شائعة

هل Meta Developer Tools MCP خاص بـChatGPT؟

لا. توثق Meta استخدامه مع Claude وChatGPT وCursor وCodex، ويمكن أن يعمل مع عملاء آخرين متوافقين مع Remote MCP وOAuth.

هل أحتاج App Secret للاتصال؟

التعليمات الرسمية تعتمد على OAuth بحساب Meta Developer. لا تضع App Secret أو كلمة المرور داخل إعداد MCP أو المحادثة ما لم تنص وثائق Meta الرسمية صراحة على مسار مختلف.

هل يستطيع المساعد تعديل تطبيقاتي؟

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

هل الخدمة بديل عن Graph API؟

لا. هي قناة لمساعد التطوير على فحص وإدارة جوانب من منصة المطورين. تطبيقك في الإنتاج يظل يستخدم واجهات Meta المناسبة وWebhooks.

هل هو نفسه Meta Ads MCP؟

لا. Developer Tools MCP مخصص لتطبيقات وتكاملات منصة المطورين، بينما أدوات الإعلانات لها نطاق مختلف لإدارة الحملات والبيانات الإعلانية.

لماذا لا يظهر لي الاتصال أو بعض الأدوات؟

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

ما أفضل أول أمر بعد الربط؟

ابدأ بطلب عرض التطبيقات وApp ID ودورك على كل تطبيق، مع توجيه صريح بعدم تنفيذ أي تغيير.

المصادر الرسمية

تمت مراجعة الصفحة في 4 أغسطس 2026 مقابل المصادر الرسمية التالية:

قد تتغير أسماء القوائم والأدوات والصلاحيات أثناء فترة Beta. وثائق Meta وحالة حسابك وقت التنفيذ هما المرجع النهائي.