خادم zaDojo MCP: إعداد Claude وCursor وCodex

يشغّل zaDojo خادم MCP عن بُعد يمكن لأي عميل يدعم MCP البعيد الاتصال به. MCP (Model Context Protocol) هو الطريقة المعيارية التي تستدعي بها تطبيقات الذكاء الاصطناعي أدوات خارجية. من خلاله يستطيع وكيلك البحث في الكلمات المفتاحية، وقراءة نتائج Google المباشرة، والاطلاع على ترتيب أي نطاق وروابطه الخلفية، وتشغيل تدقيقات المواقع، وتتبع الترتيب وإجابات الذكاء الاصطناعي، وقراءة بيانات Search Console وGoogle Analytics الخاصة بك.

عنوان الخادم:

https://app.zadojo.com/mcp

في أول اتصال، يفتح العميل صفحة تسجيل الدخول إلى zaDojo في متصفحك ويطلب منك الموافقة على الوصول. بعد ذلك يستطيع العميل استخدام الأدوات للمشاريع التي يمكنك رؤيتها. لمهام CI والخوادم التي لا تحتوي على متصفح، استخدم مفتاح API.

يستفيد مستخدمو Claude Code وCodex أكثر من الإضافة (plugin)، التي تضيف هذا الاتصال ومهارات zaDojo الاثنتي عشرة بتثبيت واحد. استخدم الخطوات في هذه الصفحة عندما تريد اتصال MCP فقط، أو عندما لا تتوفر إضافة لعميلك. يحتوي دليل إعداد الوكيل على أمر يختار لك المسار المناسب.

ما تحتاج إليه

حساب zaDojo. سجّل لتحصل على رصيد تجريبي بقيمة 0.10 يورو دون بطاقة.
عميل يدعم خوادم MCP البعيدة عبر HTTP: Claude Code أو Claude Desktop أو Cursor أو Codex CLI أو Codex في تطبيق ChatGPT لسطح المكتب أو ChatGPT مع اتصال مخصص أو VS Code مع Copilot أو Windsurf (Devin Desktop) أو Gemini CLI أو Zed أو ما شابه.
متصفح لتسجيل الدخول، أو مفتاح API للاستخدام دون واجهة.

تعرض صفحة Agent setup داخل التطبيق العنوان نفسه مع زر نسخ. تريد تجربة بيانات zaDojo قبل التسجيل؟ أدوات SEO المجانية لا تحتاج إلى حساب.

ربط عميلك

Claude Code

إضافة Claude Code هي الخيار الأفضل لمعظم الناس. للاتصال وحده، شغّل هذا في الطرفية:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

يجعل --scope user أداة zaDojo متاحة في كل مشروع على جهازك. استخدم --scope local لقصرها على المستودع الحالي. بعدها يطلب منك Claude Code تسجيل الدخول إلى zaDojo. إذا لم يظهر الطلب، شغّل /mcp واختر zaDojo وأكمل تسجيل الدخول هناك.

Claude Desktop

في خطة Claude مدفوعة، تضيف إضافة zaDojo الاتصال والمهارات معًا. في الخطة المجانية، أو للاتصال وحده، أضف موصلًا مخصصًا:

افتح Customize > Connectors.
انقر Add أو + واختر Add custom connector.
الصق https://app.zadojo.com/mcp.
سجّل الدخول إلى zaDojo ووافق على الوصول.

تعمل الموصلات المخصصة في Claude Free وPro وMax وTeam وEnterprise. تسمح الخطة المجانية بموصل مخصص واحد.

Cursor

افتح Customize واذهب إلى خوادم MCP، أو عدّل ~/.cursor/mcp.json مباشرة.
أضف إدخال zaDojo:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

احفظ الملف ووافق على تسجيل الدخول إلى zaDojo عندما يطلب Cursor ذلك.

يحتوي دليل Cursor على رابط تثبيت بنقرة واحدة وخطوات تثبيت المهارات.

Codex CLI

تضيف إضافة Codex الاتصال والمهارات معًا. للاتصال وحده:

codex mcp add zadojo --url https://app.zadojo.com/mcp

وافق على تسجيل الدخول إلى zaDojo عندما يُفتح. إذا لم يُفتح، شغّل codex mcp login zadojo.

Codex في تطبيق ChatGPT لسطح المكتب

تتضمن إضافة Codex المهارات أيضًا. للاتصال وحده:

افتح Codex، ثم اذهب إلى Settings > MCP servers > Add server.
أدخل الاسم zadojo، واختر Streamable HTTP، والصق https://app.zadojo.com/mcp.
احفظ، ثم انقر Restart عندما يطلب Codex ذلك.
انقر Authenticate بجانب zaDojo ووافق على تسجيل الدخول.
افتح محادثة Codex جديدة وشغّل فحص الاتصال.

يغطي هذا الاتصال Codex فقط. يحتاج ChatGPT على الويب إلى اتصال خاص به. مرجع OpenAI هو توثيق Codex MCP.

ChatGPT

أضف zaDojo اتصال MCP مخصصًا مع OAuth. يعمل في خطط ChatGPT المجانية والمدفوعة، مع أن مسؤولي مساحات العمل يستطيعون حظر الاتصالات المخصصة. يشرح دليل ChatGPT كل شاشة.

VS Code وWindsurf وGemini CLI

لكل منها صفحتها الخاصة مع الإعداد الدقيق وإعداد مفتاح API وتثبيت المهارات:

عملاء MCP آخرون

أي عميل يستطيع الوصول إلى خادم MCP بعيد عبر streamable HTTP ويدعم تسجيل الدخول بـ OAuth يمكنه استخدام العنوان أعلاه. إذا لم يكن العميل يدعم OAuth، أرسل مفتاح API في ترويسة كما هو موضح أدناه.

العميل	مكان الإضافة	الإعداد
Zed	Settings > AI > MCP Servers > Add Remote Server	`"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Cline	MCP Servers > Remote Servers، أو `cline mcp add zadojo https://app.zadojo.com/mcp --transport http`	`"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"`
opencode	`opencode.json`	`"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }`
Goose	`goose configure` > Add Extension > Remote Extension (Streamable HTTP)	`type: streamable_http`, `uri: https://app.zadojo.com/mcp`
Kiro	`~/.kiro/settings/mcp.json`	`"mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Warp	Settings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL)	`{ "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
JetBrains Junie	`~/.junie/mcp/mcp.json`، ثم `/mcp` > Authorize	`"zadojo": { "url": "https://app.zadojo.com/mcp" }`

كل هذه العملاء تفتح صفحة تسجيل الدخول إلى zaDojo في متصفحك عند أول اتصال.

الاتصال باستخدام مفتاح API

يحل مفتاح API محل تسجيل الدخول عبر المتصفح. استخدمه لخطوط CI والخوادم البعيدة والوكلاء مثل Hermes حيث لا يعمل مسار تسجيل الدخول، أو أي عميل لا يدعم OAuth.

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

لإنشاء مفتاح، افتح Settings في تطبيق zaDojo، وابحث عن API keys وانقر Create API key. انسخ المفتاح فورًا، لأن zaDojo يعرضه مرة واحدة فقط. تبدأ المفاتيح بـ zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: أضف كتلة headers إلى إدخال zaDojo في mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: احفظ المفتاح في متغير بيئة ووجّه Codex إليه:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

أي عميل آخر: أرسل Authorization: Bearer zadojo_YOUR_KEY أو x-api-key: zadojo_YOUR_KEY مع كل طلب.

لإلغاء مفتاح، افتح قسم API keys نفسه واحذفه.

التحقق من الاتصال

افتح محادثة أو جلسة جديدة وأرسل:

استخدم zaDojo للتحقق من اتصالي وعرض مشاريعي.

يجب أن يستدعي الوكيل whoami وlist_projects. ستحصل على حسابك ورصيدك المتبقي ومشاريعك، أو قائمة فارغة إن لم تكن لديك مشاريع بعد. الأداتان مجانيتان. إذا شرح الوكيل MCP بدلًا من استدعاء أداة، فالخادم غير محمّل في هذه الجلسة: أعد تحميل العميل أو ابدأ محادثة جديدة.

الأدوات المتاحة

يضم الخادم أكثر من 80 أداة. يجمعها الجدول حسب المهمة. أسماء الأدوات هي ما يراه وكيلك.

المجال	الأدوات الرئيسية	الرصيد
الحساب والمشاريع	`whoami`, `list_projects`, `create_project`, `get_project_context`, `update_project_context`	مجاني
أبحاث الكلمات المفتاحية	`research_keywords` (أفكار من 1 إلى 5 كلمات بذرية)، `get_keyword_metrics` (الحجم والصعوبة والنية وتكلفة النقرة والاتجاهات لما يصل إلى 700 كلمة مفتاحية)، `search_serp_locations`	مدفوع، باستثناء البحث عن المواقع الجغرافية
نتائج Google	`get_serp_results` (النتائج العضوية المباشرة لـ 1 إلى 10 كلمات مفتاحية)، `find_serp_competitors`	مدفوع
أبحاث النطاقات	`get_domain_overview`, `get_ranked_keywords`, `get_domain_keyword_suggestions`	مدفوع
الروابط الخلفية	`get_backlinks_overview`, `get_backlinks_profile`	مدفوع
الكلمات المحفوظة	`list_saved_keywords`, `save_keywords`, `remove_saved_keywords`	مجاني
تتبع الترتيب	`create_rank_tracker`, `add_rank_tracking_keywords`, `estimate_rank_tracker_cost`, `run_rank_tracker`, `get_rank_tracker`, `pin_rank_tracking_keywords`, `remove_rank_tracking_keywords`	الفحوص مدفوعة، والإعداد والقراءة مجانيان
تدقيق الموقع	`run_site_audit`, `get_audit_status`, `get_audit_issues`, `get_audit_pages`, `list_site_audits`, `delete_site_audit`	مجاني دون Lighthouse أو عرض JavaScript
SEO المحلي	`search_local_businesses`، `get_local_serp_results` (Maps أو Local Finder)، `get_local_rank_grid`, `get_business_profile`, `get_business_reviews`, `get_business_updates`, `get_google_business_questions`, `list_business_categories`	مدفوع، باستثناء البحث عن الفئات
Google Search Console	`get_search_console_performance`، `get_search_console_insights` (صفحات بنسبة نقر منخفضة، واستعلامات متنافسة داخليًا، ومكاسب النقرات وتراجعها)، `get_search_console_hourly` (آخر 48 ساعة)، `get_search_console_sitemaps`، `inspect_urls` (حتى 10 روابط في كل استدعاء)	مجاني
Google Analytics	`get_google_analytics_organic_overview`, `get_google_analytics_organic_landing_pages`, `get_google_analytics_page_performance`, `get_google_analytics_traffic_acquisition`, `get_google_analytics_key_events`, `get_google_analytics_ecommerce_performance`, `get_google_analytics_site_search`, `get_google_analytics_audience_breakdown`, `get_google_analytics_measurement_health`, `get_google_analytics_traffic_overview`, `get_google_analytics_breakdown`, `get_google_analytics_realtime_users`, `get_search_opportunities`	مجاني
الظهور في الذكاء الاصطناعي	`research_ai_visibility_prompts`, `explore_prompt`, `generate_ai_visibility_prompts`, `save_ai_visibility_tracker`, `estimate_ai_visibility_cost`, `set_ai_visibility_schedule`, `run_ai_visibility_check`	مدفوع
نتائج الظهور في الذكاء الاصطناعي	`get_ai_visibility_tracker`, `get_ai_visibility_run`, `get_ai_visibility_results`, `get_ai_visibility_answer`, `get_ai_visibility_sources`, `get_ai_visibility_trend`, `export_ai_visibility_data`	مجاني
التقارير	`save_report`, `list_reports`, `get_report`, `delete_report`, `set_report_sharing`, `list_report_templates`, `save_report_template`, `delete_report_template`	مجاني

بعض السلوكيات التي تستحق المعرفة:

سياق المشروع ذاكرة مشتركة للمشروع: نظرة عامة على النشاط التجاري، والهدف الحالي، والتموضع، وتفضيلات الكتابة، والمنافسون، والصفحات الرئيسية، وسجل الأبحاث. يقرؤه الوكلاء قبل أن يبدؤوا، ويرى التطبيق والوكلاء الآخرون الإدخالات نفسها.
التقارير التي يحفظها الوكيل تظهر في المشروع ليقرأها فريقك كله أو يطبعها أو يصدّرها. التقارير الجديدة خاصة. لا يُنشأ رابط عام إلا عندما تطلب من الوكيل استدعاء set_report_sharing مع public: true، وpublic: false يلغيه. تعيد get_report القيمة report.shareUrl عند وجود رابط عام، أو null عند عدم وجوده.
أدوات Search Console وGoogle Analytics تقرأ الخاصية المربوطة بالمشروع مسبقًا. الوصول للقراءة فقط.
التقدير يأتي أولًا لأي شيء متكرر. لتتبع الترتيب وتتبع الذكاء الاصطناعي أدوات تقدير، فيستطيع الوكيل أن يعرض لك التكلفة قبل جدولة الفحوص.

ما الذي يستهلك الرصيد

يأتي الرصيد من حسابك في zaDojo. كل 1,000 رصيد تساوي 1 يورو، والخطة بسعر 10 يورو شهريًا تتضمن استخدامًا بقيمة 10 يورو. أسعار معتادة:

الإجراء	التكلفة المعتادة
بحث كلمات مفتاحية	نحو 0.07 يورو
نظرة عامة على نطاق أو روابط خلفية مع سجل 12 شهرًا	نحو 0.10 يورو
فحص Local Maps أو Local Finder	نحو 0.006 يورو
فحص سؤال ذكاء اصطناعي واحد على محرك واحد	نحو 0.002 يورو
Prompt Research لكلمة مفتاحية واحدة	نحو 0.25 يورو
تتبع 100 كلمة مفتاحية أسبوعيًا على جهاز واحد	نحو 1 إلى 2 يورو شهريًا

مجاني: فحوص الحساب، وسياق المشروع، والكلمات المحفوظة، والتقارير، وSearch Console، وGoogle Analytics، وتدقيقات المواقع العادية، وقراءة نتائج تتبع الترتيب أو التدقيق أو الظهور في الذكاء الاصطناعي التي جمعتها مسبقًا. يُطلب من الوكلاء المتصلين بـ zaDojo أن يستأذنوك قبل أي دفعة مخطط لها تتجاوز 2,000 رصيد (نحو 2 يورو). عندما يصل الرصيد إلى الصفر، تتوقف الأدوات المدفوعة حتى تعيد الشحن. راجع الأسعار لاستخدام أداة التقدير.

بعد الاتصال

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

أعطِ الوكيل مهمة واحدة محددة بدلًا من أن تطلب منه "القيام بـ SEO":

SEO Project Setup: احفظ هدفك وتموضعك ومنافسيك وصفحاتك الرئيسية لتبدأ منها كل مهمة لاحقة.
SEO Coach: احصل على خطوة تالية واحدة موصى بها إذا كنت جديدًا على SEO.
SEO Audit: اعثر على التغييرات القليلة الأكثر احتمالًا لزيادة الزيارات.
Keyword Research وKeyword Clustering: اعثر على عبارات بحث تستحق الاستهداف ووزّعها على صفحات.
Competitive Landscape وCompetitor Analysis: ارسم خريطة السوق، أو ادرس منافسًا واحدًا بعمق.
Link Prospecting: اعثر على مواقع قد تضع رابطًا لصفحة واكتب مسودات رسائل التواصل.
AI Prompt Research وAI Visibility Audit: اعرف ما تقوله أدوات الذكاء الاصطناعي عن سوقك ولماذا يُذكر منافسوك.

يشرح دليل الظهور في الذكاء الاصطناعي المحركات والتغطية والتكاليف لتتبع إجابات الذكاء الاصطناعي.

حل المشكلات

لا يستطيع العميل الاتصال. تأكد من أن العنوان هو https://app.zadojo.com/mcp بالضبط، مع https:// ودون مسافات زائدة في نهايته.

يعرض Codex الرسالة Authorization server response missing required issuer: expected https://app.zadojo.com. إصدارات Codex من 0.143 إلى 0.146 تُسقط قيمة issuer أثناء OAuth. حدّث Codex CLI أو تطبيق Codex لسطح المكتب إلى 0.147.0 أو أحدث، أو استخدم مفتاح API.

يفشل تسجيل الدخول أو تنتهي صلاحيته باستمرار. احذف خادم zaDojo من عميلك، ثم أضفه مجددًا وكرر تسجيل الدخول.

لا يجد الوكيل المشروع. اطلب منه استدعاء list_projects أولًا وإعادة استخدام معرّف المشروع الناتج في الاستدعاءات اللاحقة. إذا لم تكن لديك مشاريع، اطلب منه إنشاء مشروع لنطاقك باستخدام create_project، وهي مجانية.

أداة مدفوعة تقول إن رصيدك نفد. في الخطة المدفوعة، اشترِ رصيدًا إضافيًا من صفحة الفوترة في التطبيق أو انتظر تجديد رصيدك الشهري. في الفترة التجريبية، اشترك لمواصلة استخدام الأدوات المدفوعة.

ما زلت تواجه مشكلة؟ راسلنا على hello@zadojo.com مع اسم عميلك وإصداره والخطأ بالضبط. لا تُرفق مفاتيح API أبدًا.