اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

في هذه الصفحة

خادم Brevo MCP

يوفّر Brevo خادم MCP رسميًا مُستضافًا على mcp.brevo.com يعرض 27 وحدة، تشمل جهات الاتصال والحملات والصفقات والقوالب وواتساب وSMS وغيرها، على هيئة أدوات يمكن لأي وكيل ذكاء اصطناعي استدعاؤها. لا حاجة إلى أي تثبيت محلي.

Tip

يستخدم خادم Brevo MCP بروتوكول Model Context Protocol (MCP)، وهو معيار مفتوح من Anthropic يربط مساعدي الذكاء الاصطناعي بالأدوات والخدمات الخارجية.

البداية السريعة

1. احصل على رمز MCP الخاص بك

يستخدم Brevo MCP رمز MCP مخصصًا (وليس مفتاح API عاديًا):

سجّل الدخول إلى app.brevo.com
اذهب إلى Account > SMTP & API > API Keys
اضغط Generate a new API key وفعّل خيار Create MCP server API key
انسخ الرمز واحفظه بأمان

Caution

يمنح رمز MCP الخاص بك وصول قراءة وكتابة كاملًا إلى حساب Brevo لديك. لا تودعه إطلاقًا في نظام التحكم بالإصدارات ولا تشاركه علنًا.

2. اربط أداة الذكاء الاصطناعي لديك

أضف ما يلي إلى ملف إعدادات Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

أعد تشغيل Claude Desktop بعد الحفظ. يتطلب ذلك تثبيت Node.js.

أضف ما يلي إلى ~/.agents/config.json:

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

تحقّق عبر:

claude mcp list

أضف ما يلي إلى ~/.cursor/mcp.json (عام) أو .cursor/mcp.json (لكل مشروع):

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

أضف ما يلي إلى .vscode/mcp.json (لكل مشروع) أو إلى mcp.json على مستوى المستخدم:

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

أضف ما يلي إلى ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

3. اختبر الاتصال

بعد إتمام الربط، اسأل مساعد الذكاء الاصطناعي لديك:

> How many contacts do I have?
> Create an email campaign for my product launch
> Show me deals in the Negotiation stage
> Add a contact to my newsletter list

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

يشمل الخادم الرئيسي على /v1/brevo/mcp جميع الوحدات الـ 27. للحصول على جودة استجابة أفضل في حالات الاستخدام المحددة، اتصل بخوادم مفردة تمنح الذكاء الاصطناعي مجموعة أدوات أصغر وأكثر تركيزًا.

الخادم الرئيسي

نقطة النهاية	الوصف
`https://mcp.brevo.com/v1/brevo/mcp`	جميع الميزات مجتمعة (27 وحدة)

الخوادم المفردة

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

جهات الاتصال وCRM

الخادم	نقطة النهاية	الغرض
contacts	`/v1/brevo_contacts/mcp`	إدارة جهات الاتصال والقوائم
lists	`/v1/brevo_lists/mcp`	إدارة قوائم جهات الاتصال
segments	`/v1/brevo_segments/mcp`	إدارة شرائح جهات الاتصال
attributes	`/v1/brevo_attributes/mcp`	إدارة سمات جهات الاتصال
groups	`/v1/brevo_groups/mcp`	إدارة مجموعات جهات الاتصال
contact_import_export	`/v1/brevo_contact_import_export/mcp`	استيراد وتصدير جهات الاتصال بالجملة

الحملات والمراسلة

الخادم	نقطة النهاية	الغرض
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	إنشاء حملات البريد الإلكتروني وإدارتها
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	عرض أداء الحملات
templates	`/v1/brevo_templates/mcp`	إدارة قوالب البريد الإلكتروني
transac_templates	`/v1/brevo_transac_templates/mcp`	إدارة قوالب البريد الإلكتروني التعاملي
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	إنشاء حملات SMS وإرسالها
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	إنشاء حملات واتساب وإرسالها
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	ضبط إعدادات واتساب

Sales CRM

الخادم	نقطة النهاية	الغرض
deals	`/v1/brevo_deals/mcp`	إدارة صفقات CRM
companies	`/v1/brevo_companies/mcp`	إدارة شركات CRM
tasks	`/v1/brevo_tasks/mcp`	إدارة مهام CRM
pipelines	`/v1/brevo_pipelines/mcp`	ضبط مسارات CRM
notes	`/v1/brevo_notes/mcp`	إضافة ملاحظات إلى جهات الاتصال والصفقات

الحساب والإعدادات

الخادم	نقطة النهاية	الغرض
senders	`/v1/brevo_senders/mcp`	إدارة هويات المُرسِلين
domains	`/v1/brevo_domains/mcp`	إدارة نطاقات الإرسال
ips	`/v1/brevo_ips/mcp`	إدارة عناوين IP المخصصة
accounts	`/v1/brevo_accounts/mcp`	إدارة الحساب والحسابات الفرعية
users	`/v1/brevo_users/mcp`	إدارة المستخدمين والصلاحيات
webhooks_management	`/v1/brevo_webhooks_management/mcp`	ضبط الـ webhooks
external_feeds	`/v1/brevo_external_feeds/mcp`	إدارة خلاصات RSS
folders	`/v1/brevo_folders/mcp`	تنظيم الحملات داخل مجلدات
processes	`/v1/brevo_processes/mcp`	مراقبة العمليات في الخلفية

تستخدم جميع نقاط النهاية الرابط الأساسي https://mcp.brevo.com.

تحديد نطاق الأدوات للوكلاء

بالنسبة لوكلاء Tajo، اربط فقط الخوادم التي يحتاجها وكيلك. هكذا تطبّق تحديد نطاق الصلاحيات، إذ يحصل كل وكيل على مجموعة مختلفة من خوادم MCP.

مثال: وكيل استرداد السلات

يحتاج هذا الوكيل إلى جهات الاتصال وحملات البريد الإلكتروني وSMS فقط:

{
  "mcpServers": {
    "brevo_contacts": {
      "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_email": {
      "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_templates": {
      "url": "https://mcp.brevo.com/v1/brevo_templates/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_sms": {
      "url": "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

مثال: وكيل Sales CRM

يعمل هذا الوكيل مع الصفقات والشركات فقط:

{
  "mcpServers": {
    "brevo_deals": {
      "url": "https://mcp.brevo.com/v1/brevo_deals/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_companies": {
      "url": "https://mcp.brevo.com/v1/brevo_companies/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_pipelines": {
      "url": "https://mcp.brevo.com/v1/brevo_pipelines/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_tasks": {
      "url": "https://mcp.brevo.com/v1/brevo_tasks/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    },
    "brevo_notes": {
      "url": "https://mcp.brevo.com/v1/brevo_notes/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

كيف تستخدم Tajo خدمة Brevo MCP

تقع Tajo بين نيّتك وأدوات MCP في Brevo. تدفق التنسيق:

Marketer Intent
    "Win back customers who haven't ordered in 90 days"
        ↓
Tajo Agent Layer
    Selects: Win-Back Agent
    Agent reads its spec: tools, constraints, strategy
        ↓
Brevo MCP Tools
    brevo_contacts → find churned customers
    brevo_segments → create target segment
    brevo_email    → send recovery campaign
    brevo_sms      → SMS follow-up for non-openers
        ↓
Brevo Platform
    Emails delivered, SMS sent, events tracked

تحدد مواصفة كل وكيل في Tajo خوادم Brevo MCP التي يحتاجها. تربط طبقة التنسيق تلك الخوادم فقط، بما يفرض وصولًا بأقل قدر من الامتيازات.

حل المشكلات

”Command not found: npx”

ثبّت Node.js. جسر npx mcp-remote مطلوب لكل من Claude Desktop وClaude Code.

الأدوات لا تظهر

أعد تشغيل تطبيقك بالكامل (وليس مجرد إعادة تحميل)
تأكد من خلو ملف JSON لديك من الأخطاء النحوية (فواصل زائدة، أقواس ناقصة)
تحقّق من خلو رمز MCP من أي مسافات زائدة

أخطاء المصادقة

تأكد من أن رمز MCP لديك لا يزال نشطًا في Brevo Dashboard > SMTP & API
تأكد من أن ترويسة Authorization مكتوبة بصيغة Bearer <token> مع مسافة

الخطوات التالية

بناء وكيلك الأول، استخدم أدوات Brevo MCP لبناء وكيل تسويقي
صيغة مواصفة الوكيل، عرّف وكلاء مخصصين بوصول محدد النطاق إلى الأدوات
مرجع Skills، اطّلع على كيفية تركيب Tajo Skills فوق أدوات MCP
التوثيق الرسمي من Brevo، توثيق Brevo MCP الكامل