תיעוד שרת MCP

שרת ה-Biscotti CMP MCP מאפשר לעוזרי AI ליצור אינטראקציה עם חשבון ה-Biscotti CMP שלך באופן תוכנתי. נהל אתרי אינטרנט, באנרים, סריקות תאימות, ניתוח הסכמה, מסמכים משפטיים ועוד - הכל באמצעות פקודות בשפה טבעית בסביבת הפיתוח שלך.

שרת ה-MCP (Model Context Protocol) פועל כגשר בין עוזר ה-AI שלך לבין ה-Biscotti CMP API, ומספק מערכת כלים שניתן לקרוא להם ישירות מסביבת הפיתוח שלך.

Prerequisites

• Node.js 18 or later
• חשבון Biscotti CMP עם תוכנית Agency או LTD Agency
• מפתח API מדף הגדרות מפתחים

Quick Start

הדרך המהירה ביותר להתחיל היא באמצעות 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
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration

הוסף את הפרטים הבאים לקובץ התצורה שלך:

{
  "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, הוסף את התצורה הבאה להגדרות ה-MCP של Cursor.

מיקום קובץ התצורה

• ברמת הפרויקט: .cursor/mcp.json בשורש הפרויקט שלך
• גלובלי: ~/.cursor/mcp.json

Configuration

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

לאחר השמירה, Cursor יזהה אוטומטית את שרת ה-MCP ויהפוך את הכלים לזמינים בעוזר ה-AI.

כדי להשתמש בשרת Biscotti CMP MCP עם Kiro, הגדר אותו דרך הגדרות ה-MCP.

מיקום קובץ התצורה

• ברמת הפרויקט: .kiro/settings/mcp.json בשורש הפרויקט שלך
• גלובלי: ~/.kiro/settings/mcp.json

Configuration

{
  "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 להעברות אירועים בזמן אמת.

כלים לניהול חשבונות לקוחות וסוכנויות.

שרת ה-MCP של Biscotti CMP חושף את המשאבים הבאים שעוזרי AI יכולים לקרוא עבור הקשר:

• biscotti://websites — רשימת כל אתרי האינטרנט בחשבון שלך
• biscotti://website/{id} — תצורת אתר מפורטת
• biscotti://compliance/{id} — מצב תאימות נוכחי עבור אתר אינטרנט
• biscotti://banners/{websiteId} — כל הבאנרים עבור אתר אינטרנט

משאבים מספקים הקשר לקריאה בלבד המסייע לעוזרי AI להבין את ההגדרה הנוכחית שלך לפני ביצוע שינויים.

שרת ה-MCP כולל תבניות הנחיות מובנות עבור תהליכי עבודה נפוצים:

Compliance Audit

הפעלת ביקורת תאימות מלאה באתר, סריקת קובצי Cookie, בדיקת תצורת הסכמה ויצירת דוח.

הפעלת ביקורת תאימות באתר שלי example.com והצעת שיפורים.

Banner Setup

יצירה והגדרת באנר הסכמה עם העיצוב והתנהגות המועדפים עליך.

יצירת באנר הסכמה תואם GDPR עבור האתר שלי עם ערכת נושא כהה ומיקום בצד שמאל למטה.

יצירת מסמכים משפטיים

יצירת מסמכים משפטיים המבוססים על תצורת האתר שלך ותחום השיפוט היעד.

יצירת מדיניות פרטיות עבור האתר הגרמני שלי המכסה את Google Analytics ו-Facebook Pixel.

שרת ה-MCP של Biscotti CMP דורש מפתח API כדי לבצע אימות מול ה-API של Biscotti CMP. כל הבקשות שבוצעו על ידי שרת ה-MCP מאומתות באמצעות מפתח ה-API שלך.

כיצד פועל האימות

1. אתה יוצר מפתח API בדף הגדרות מפתחים בלוח המחוונים של Biscotti CMP שלך.
2. מפתח ה-API מוגדר כמשתנה סביבה BISCOTTI_API_KEY בתצורת הלקוח של MCP שלך.
3. שרת ה-MCP כולל מפתח זה כאסימון Bearer בכל בקשות ה-API.
4. ה-API של Biscotti CMP מאמת את המפתח ומחזיר נתונים המוגבלים לחשבון שלך.

כדי לקבל מפתח API עבור שרת MCP:

1. היכנס ללוח המחוונים של Biscotti CMP שלך בכתובת app.biscotti-cmp.com.
2. נווט אל הגדרות מפתח בסרגל הצד.
3. לחץ על צור מפתח חדש בלשונית מפתחות API.
4. תן למפתח שלך שם תיאורי (לדוגמה, "שרת MCP - פיתוח").
5. אפשרותית הגדר תאריך תפוגה עבור המפתח.
6. העתק את המפתח שנוצר מיד - הוא יוצג רק פעם אחת.

שיטות עבודה מומלצות לניהול מפתחות

• השתמש במפתחות API נפרדים עבור סביבות פיתוח וייצור.
• הגדר תאריכי תפוגה למפתחות המשמשים באופן זמני.
• סובב מפתחות באופן קבוע ובטל מפתחות שאינם בשימוש.
• השתמש בתכונת סיבוב המפתחות כדי להחליף מפתחות ללא השבתה.