وثائق خادم MCP

يتيح خادم Biscotti CMP MCP للمساعدات التي تعمل بالذكاء الاصطناعي التفاعل مع حساب Biscotti CMP الخاص بك برمجياً. يمكنك إدارة المواقع الإلكترونية واللافتات وفحوصات الامتثال وتحليلات الموافقة والوثائق القانونية وغير ذلك الكثير — كل ذلك من خلال أوامر باللغة الطبيعية في بيئة تطوير التطبيقات (IDE) الخاصة بك.

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

المتطلبات الأساسية

• Node.js الإصدار 18 أو أحدث
• حساب Biscotti CMP مع خطة "وكالة" أو خطة "وكالة محدودة"
• مفتاح واجهة برمجة التطبيقات (API) من صفحة "إعدادات المطور"

البدء السريع

أسرع طريقة للبدء هي استخدام npx — لا يتطلب التثبيت:

npx @biscotti-cmp/mcp-server

قم بتشغيل خادم MCP مباشرةً دون تثبيته على مستوى النظام. هذه هي الطريقة الموصى بها لمعظم المستخدمين:

npx @biscotti-cmp/mcp-server

إذا كنت تفضل تثبيت خادم MCP عالميًا على نظامك:

npm install -g @biscotti-cmp/mcp-server

بعد التثبيت، يمكنك تشغيل الخادم مباشرة:

biscotti-mcp

لاستخدام خادم Biscotti CMP MCP مع Claude Desktop، أضف التكوين التالي إلى ملف إعدادات Claude Desktop.

موقع ملف التكوين

• نظام macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• ويندوز: %APPDATA%\Claude\claude_desktop_config.json

الإعدادات

أضف ما يلي إلى ملف التكوين الخاص بك:

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

أعد تشغيل Claude Desktop بعد حفظ ملف التكوين. ستظهر أدوات Biscotti CMP في قائمة الأدوات.

لاستخدام خادم Biscotti CMP MCP مع Cursor، أضف التكوين التالي إلى إعدادات Cursor MCP الخاصة بك.

موقع ملف التكوين

• على مستوى المشروع: .cursor/mcp.json في جذر مشروعك
• عالمي: ~/.cursor/mcp.json

الإعدادات

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

بعد الحفظ، سيقوم Cursor تلقائيًا باكتشاف خادم MCP وإتاحة الأدوات في المساعد الذكي.

لاستخدام خادم Biscotti CMP MCP مع Kiro، قم بتكوينه من خلال إعدادات MCP.

موقع ملف التكوين

• على مستوى المشروع: .kiro/settings/mcp.json في جذر مشروعك
• عالمي: ~/.kiro/settings/mcp.json

الإعدادات

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

سيقوم Kiro تلقائيًا باكتشاف تكوين خادم MCP وإتاحة أدوات Biscotti CMP.

يتوافق خادم Biscotti CMP MCP مع أي عميل متوافق مع MCP. استخدم التكوين العام التالي:

الإعدادات العامة

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

إذا كان عميل MCP الخاص بك يستخدم تنسيق تكوين مختلف، فإن المعلمات الرئيسية هي:

• الأمر: npx
• الحجج: -y @biscotti-cmp/mcp-server
• متغير البيئة: BISCOTTI_API_KEY اضبطه على مفتاح API الخاص بك

أدوات لإدارة مواقعك في Biscotti CMP.

أدوات لإنشاء وإدارة لافتات الموافقة.

أدوات لفحص المواقع والتحقق من حالة الامتثال.

أدوات للوصول إلى إحصائيات الموافقة وبيانات التحليلات.

أدوات لإدارة المستندات القانونية مثل سياسات الخصوصية وشروط الخدمة وصفحات بيانات النشر.

أدوات لإدارة خدمات الطرف الثالث المكتشفة وفئات الموافقة الخاصة بها.

أدوات لإدارة تكاملات webhook للإشعارات الفورية للأحداث.

أدوات لإدارة حسابات العملاء وعمليات الوكالة.

يوفر خادم Biscotti CMP MCP الموارد التالية التي يمكن للمساعدات الذكية قراءتها لفهم السياق:

• biscotti://مواقع الويب — قائمة بجميع مواقع الويب الموجودة في حسابك
• biscotti://website/{id} — إعدادات الموقع التفصيلية
• biscotti://compliance/{id} — الحالة الحالية للامتثال لموقع ويب
• biscotti://banners/{websiteId} — جميع اللافتات الخاصة بموقع ويب

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

يحتوي خادم MCP على قوالب مطالبات مدمجة مخصصة لسير العمل الشائع:

تدقيق الامتثال

إجراء تدقيق شامل للامتثال على موقع ويب، بما في ذلك البحث عن ملفات تعريف الارتباط، والتحقق من إعدادات الموافقة، وإعداد تقرير.

قم بإجراء تدقيق امتثال على موقع الويب الخاص بي example.com واقترح تحسينات.

إعداد اللافتة

قم بإنشاء وتهيئة شعار الموافقة باستخدام التصميم وإعدادات السلوك التي تفضلها.

أنشئ إعلان موافقة متوافق مع GDPR لموقع الويب الخاص بي بمظهر داكن وموضع أسفل اليسار.

إعداد الوثائق القانونية

قم بإنشاء مستندات قانونية بناءً على إعدادات موقعك الإلكتروني والولاية القضائية المستهدفة.

أنشئ سياسة خصوصية لموقعي الألماني الذي يغطي Google Analytics و Facebook Pixel.

يحتاج خادم Biscotti CMP MCP إلى مفتاح واجهة برمجة التطبيقات (API) للمصادقة عبر واجهة برمجة تطبيقات Biscotti CMP. تتم مصادقة جميع الطلبات التي يرسلها خادم MCP باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك.

كيف تعمل عملية المصادقة

1. يمكنك إنشاء مفتاح API من صفحة "إعدادات المطور" في لوحة تحكم Biscotti CMP الخاصة بك.
2. يتم تعيين مفتاح واجهة برمجة التطبيقات (API) كمتغير BISCOTTI_API_KEY متغير بيئة في تكوين عميل MCP الخاص بك.
3. يقوم خادم MCP بتضمين هذا المفتاح كرمز "Bearer" في جميع طلبات واجهة برمجة التطبيقات (API).
4. تقوم واجهة برمجة تطبيقات Biscotti CMP بالتحقق من صحة المفتاح وتُرجع البيانات الخاصة بحسابك.

للحصول على مفتاح API لخادم MCP:

1. سجّل الدخول إلى لوحة تحكم Biscotti CMP الخاصة بك على app.biscotti-cmp.com.
2. انتقل إلى "إعدادات المطور" في الشريط الجانبي.
3. انقر على «إنشاء مفتاح جديد» في علامة التبويب «مفاتيح واجهة برمجة التطبيقات».
4. أعطِ مفتاحك اسمًا وصفياً (على سبيل المثال، "خادم MCP - التطوير").
5. يمكنك تحديد تاريخ انتهاء صلاحية للمفتاح، إذا رغبت في ذلك.
6. انسخ المفتاح الذي تم إنشاؤه على الفور — فلن يظهر إلا مرة واحدة.

أفضل الممارسات في إدارة المفاتيح

• استخدم مفاتيح API منفصلة لبيئات التطوير والإنتاج.
• تعيين تواريخ انتهاء الصلاحية للمفاتيح المستخدمة مؤقتًا.
• قم بتبديل المفاتيح بانتظام وإلغاء المفاتيح غير المستخدمة.
• استخدم ميزة تدوير المفاتيح لاستبدال المفاتيح دون توقف.