Connect Profound CMS to your AI client

يوفّر Profound CMS خادم MCP بعيدًا يتيح لعملاء الذكاء الاصطناعي المتوافقين اكتشاف محتوى CMS وإنشائه وتحديثه ونشره وإدارته.

نقطة نهاية MCP:

http://107.21.107.99:8081/mcp

في بيئة الإنتاج، استخدم إصدار HTTPS من عنوان MCP المهيّأ متى كان متاحًا.

المصادقة

يستخدم Profound CMS MCP بروتوكول OAuth من WorkOS.

للاتصال:

1. أنشئ حسابًا في Profound CMS.
2. تأكد من أن حسابك ينتمي إلى المؤسسة الصحيحة.
3. أضف خادم MCP إلى عميل الذكاء الاصطناعي الخاص بك.
4. أكمل تسجيل الدخول عبر المتصفح عند طلب ذلك.

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

يتحكم دورك في CMS في مستوى الوصول:

• يمكن للأعضاء قراءة محتوى CMS.
• يمكن للمحررين والمسؤولين إنشاء المحتوى وتحديثه ونشره.

Claude Code

شغّل:

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

ثم شغّل Claude Code وأكمل عملية المصادقة عبر المتصفح.

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

claude mcp list

Codex CLI

شغّل:

codex mcp add Profound --url http://107.21.107.99:8081/mcp

سيطلب Codex المصادقة عند استخدام الخادم لأول مرة.

يمكنك التحقق من الاتصال باستخدام:

codex mcp list

OpenCode

أضف ما يلي إلى:

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

ثم صادق:

opencode mcp auth profound

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

opencode mcp list

يجب أن يظهر الخادم على أنه متصل عبر OAuth.

Cursor وWindsurf وClaude Desktop وعملاء MCP الآخرون

تدعم معظم العملاء المتوافقين مع MCP إعداد HTTP البعيد القياسي:

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

في Cursor أو Windsurf أو Claude Desktop أو أي عميل MCP آخر:

1. افتح إعدادات MCP أو التكاملات.
2. أضف خادم MCP بعيدًا عبر HTTP.
3. استخدم عنوان Profound MCP.
4. فعّل مصادقة OAuth إذا كان العميل يوفر خيار OAuth.
5. أكمل تسجيل الدخول إلى Profound CMS في متصفحك.

يجب أن يدعم العميل MCP عبر HTTP القابل للبث وOAuth. ولا يمكن للعملاء الذين يدعمون الخوادم المحلية أو مفاتيح API الثابتة فقط المصادقة مباشرةً مع هذا الخادم.

ابدأ كل جلسة بالاكتشاف

بعد الاتصال، اطلب من عميل الذكاء الاصطناعي اكتشاف المؤسسات والمواقع الإلكترونية المتاحة لك:

استخدم خادم Profound MCP فقط.

استدعِ list_my_organizations أولًا.
ثم استدعِ list_organizations.
استخدم معرّف المؤسسة الذي يعيده list_organizations لاستدعاء list_websites.

اعرض أسماء المؤسسات وأسماء المواقع الإلكترونية ومعرّفات المواقع الإلكترونية في جدول.

تتطلب جميع عمليات CMS وجود website_id.

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

يوفّر خادم MCP حاليًا 35 أداة لـ CMS.

المؤسسات والمواقع الإلكترونية

• list_my_organizations
• list_organizations
• list_websites

الصفحات

• create_page
• update_page
• delete_page
• get_page
• list_pages

ربط المسارات

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

تربط عمليات ربط المسارات صفحات القوالب بمحتوى محدد أو بقيم للمعلمات.

المكوّنات

• create_component
• update_component
• delete_component
• list_components

تعرّف المكوّنات أنواع المحتوى القابلة لإعادة الاستخدام وحقولها.

الكتل

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

الكتل هي مثيلات محتوى موضوعة على الصفحات.

الحقول الديناميكية وتعبيرات Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

تدير هذه الأدوات تعبيرات fx الديناميكية التي تحسب قيم الحقول وقت العرض.

المستندات والنسخ

• create_document
• update_document
• delete_document
• get_document
• list_documents

المستندات هي إدخالات محتوى قابلة لإعادة الاستخدام، وتُسمى أيضًا النسخ. يعيد list_documents البيانات الوصفية؛ استخدم get_document لاسترداد المحتوى الكامل.

الترجمات

• list_document_translations
• upsert_document_translation
• delete_document_translation

ينبغي تخزين الترجمات كصفوف للغات المحلية ضمن مستند واحد بدلًا من إنشاء مستند منفصل لكل لغة.

سير عمل CMS المعتاد

عادةً ما يبدو سير عمل المحتوى الكامل كما يلي:

1. اكتشف المؤسسات والمواقع الإلكترونية.
2. افحص المكوّنات والصفحات والكتل والمستندات الموجودة.
3. أنشئ المحتوى المطلوب أو حدّثه.
4. استخدم expected_version عند تحديث الكتل أو المكوّنات أو المستندات.
5. انشر الكتل أو المستندات.
6. عيّن حالة الصفحة إلى Live.
7. تحقّق من المحتوى المنشور.

لا تكون الصفحة مرئية للعامة إلا عندما تكون في حالة العرض المباشر ويكون محتواها منشورًا.

أمثلة على الطلبات

إنشاء صفحة:

باستخدام Profound CMS، أنشئ صفحة على المسار /pricing للموقع الإلكتروني <website_id>.
أنشئ الكتل المطلوبة، وانشرها، وعيّن الصفحة إلى حالة العرض المباشر.

تحديث محتوى موجود:

اعثر على الصفحة الرئيسية للموقع الإلكتروني <website_id>.
اقرأ كتلها الحالية، وحدّث العنوان الرئيسي للقسم البارز، ثم انشر التغيير.

إنشاء محتوى مترجم:

للمستند <document_id>، أضف ترجمات بالفرنسية والألمانية.
استخدم المستند الموجود وأنشئ صفوف ترجمة بدلًا من إنشاء مستندات مكررة.

استخدام المحتوى الديناميكي:

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

سير عمل المحتوى من البداية إلى النهاية

يمكن دمج Profound CMS MCP مع خوادم MCP أخرى لدعم سير عمل كامل:

على سبيل المثال:

Figma MCP + Profound CMS MCP

يمكنه ربط اكتشاف التصميم وإنشاء المحتوى وتأليف CMS والتوطين والنشر في سير عمل واحد بمساعدة الذكاء الاصطناعي.