Sendveo لوكلاء الذكاء الاصطناعي

تتحدّث Sendveo بروتوكول Model Context Protocol (MCP). أضفها إلى Claude أو Cursor أو ChatGPT أو أي وكيل يدعم MCP، ثم اطلب بلغة طبيعية: اعرض أرقامي، اربط هذا الرقم، رُدّ على تلك المحادثة. والوكيل ينادي Sendveo نيابة عنك.

ما هو

خادم MCP الخاص بـ Sendveo جسر صغير بين مساعدك الذكي وحسابك في Sendveo. يعرض الإجراءات نفسها الموجودة في الـ API ولوحة التحكم، على هيئة أدوات يستطيع المساعد استدعاءها. وكل شيء يجري ضمن حسابك أنت: تسجّل الدخول ببريدك وكلمة مرورك في Sendveo، أو تستخدم مفتاح API من لوحة التحكم إن كان الأمر يتعلّق بسكربت أو أداة سطر أوامر.

هناك طريقتان للربط، وكلتاهما تتيحان الأدوات نفسها. مستضافة: تلصق رابطًا واحدًا في المساعد وتسجّل الدخول، دون تثبيت أي شيء ودون نسخ أي مفتاح. ومحلية: يشغّل المساعد أمر Sendveo صغيرًا على جهازك بمفتاح API لا يغادره أبدًا.

ما يمكنك فعله

أداة واحدة لكل إجراء، مجمّعة كما يجمّعها الدليل: الأرقام، الرسائل، المحادثات، جهات الاتصال، المجموعات، السلامة والملف الشخصي، التسميات، webhook، الفوترة. وميزات المشغّل غير معروضة: الخادم محصور في الحساب الذي يخصّه الاتصال.

تقبل connect_number وrefresh_qr وreconnect_number معاملًا اختياريًا method. يعيد qr (الافتراضي) رمز QR تمسحه من واتساب في الأجهزة المرتبطة، ربط جهاز. ويعيد code رمزًا من 8 أحرف تكتبه في الربط برقم الهاتف: استخدمه حين تكون على الهاتف نفسه الذي يحمل الرقم ولا تستطيع مسح الشاشة. كلاهما ينتهي ويتغيّر، فاطلب رمزًا جديدًا إن توقّف عن العمل.

الخيار أ: الصق الرابط وسجّل الدخول (موصى به)

أضف Sendveo إلى مساعدك كخادم MCP بعيد. تحتاج إلى قيمة واحدة فقط: رابط MCP الخاص بـ Sendveo. لا شيء لتثبّته ولا مفتاح لتلصقه: يفتح مساعدك صفحة Sendveo تسجّل فيها الدخول وتوافق على الاتصال.

https://mcp.sendveo.com/mcp

في Claude

1. افتح الإعدادات، ثم الموصلات، واختر إضافة موصل مخصّص.
2. الصق رابط MCP الخاص بـ Sendveo الظاهر أعلاه واحفظ. ويتكفّل مساعدك بالباقي وحده.
3. تُفتح صفحة Sendveo في متصفّحك. سجّل الدخول بالبريد وكلمة المرور اللذين تستخدمهما للوحة التحكم.
4. اقرأ ما يطلبه المساعد والعنوان الذي سيعيدك إليه، ثم اضغط السماح. وإن ضغطت رفض فلن يُمنح شيء.

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

لقطع الاتصال، احذف الموصل من مساعدك. والاتصال الذي تحذفه من جهة Sendveo يتوقّف فورًا ونهائيًا.

إن لم تُفتح أي صفحة لتسجيل الدخول، تأكّد من أن الرابط ينتهي بـ /mcp. وإن أبلغ مساعدك أنه لم يستطع الوصول إلى خدمة تسجيل الدخول، فمعنى ذلك أن Sendveo غير متاح من شبكتك: الفحص نفسه المستخدَم لفتح لوحة التحكم.

يستخدم ChatGPT وCursor وسائر المساعدين الداعمين لـ MCP الرابط نفسه في إعدادات خادم MCP البعيد لديهم، ويسجّلون دخولك بالطريقة نفسها.

الخيار ب: محلي (يعمل على جهازك)

إن كنت تفضّل إبقاء المفتاح على جهازك، شغّل خادم MCP الخاص بـ Sendveo محليًا. يتطلّب Node.js 22 أو أحدث. يشغّله المساعد عبر npx @sendveo/mcp ويمرّر له مفتاحك من خلال متغيّر البيئة SENDVEO_API_KEY.

أضف الكتلة أدناه إلى إعدادات MCP في مساعدك. في Claude Desktop هي claude_desktop_config.json؛ وفي Claude Code شغّل claude mcp add أو عدّل .mcp.json؛ ويستخدم Cursor الملف .cursor/mcp.json. الكتلة نفسها في كل مكان.

{
  "mcpServers": {
    "sendveo": {
      "command": "npx",
      "args": ["-y", "@sendveo/mcp"],
      "env": {
        "SENDVEO_API_KEY": "YOUR_SENDVEO_API_KEY"
      }
    }
  }
}

استبدل النص المؤقت بمفتاحك، وأعد تشغيل المساعد، ثم اطلب منه عرض أرقامك في Sendveo. إن توقّف الخادم فورًا، تحقّق من أن SENDVEO_API_KEY مضبوط.

بمفتاح API بدل تسجيل الدخول

تسجيل الدخول هو الطريقة المعتادة لاستخدام الرابط المستضاف. وإن كانت أداتك لا تستطيع ذلك، كسكربت أو استدعاء curl أو عميل لا يتيح سوى ضبط الترويسات، فالرابط نفسه يقبل أيضًا مفتاح API من Sendveo يُرسَل كرمز bearer. ويُوثَّق كل طلب بذلك المفتاح وحده ويبقى محصورًا في حساب ذلك المفتاح.

https://mcp.sendveo.com/mcp

Authorization: Bearer YOUR_SENDVEO_API_KEY

النطاقات

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

أُضيفت النطاقات messages:manage وchats:read وchats:manage وcontacts:read وgroups:read وgroups:manage في 16 سبتمبر 2026. والمفتاح الذي أُنشئ قبل هذا التاريخ لا يحمل أيًا منها ولا يمكن إضافتها إليه: أنشئ مفتاحًا جديدًا من لوحة التحكم، أو أعد ربط المساعد ووافق على الصلاحيات. وكل ما عدا ذلك يواصل العمل بالمفتاح القديم.

الفوترة للقراءة فقط ويغطيها النطاق numbers:read: لا يوجد نطاق فوترة منفصل.

الأمان

• تسجيل الدخول لا يمنح المساعد كلمة مرورك أبدًا، ولا يخزّن الخادم المستضاف أي مفتاح API. يُوثَّق كل طلب ببيانات الاعتماد التي يحملها، ولا يحتفظ الخادم بأي منها.
• كل طلب معزول في الحساب الذي يقف خلف الاتصال. وميزات المشغّل غير متاحة عبر MCP.
• تُطبَّق حدود للمعدّل، لكل مفتاح ولكل مصدر. الاستجابة 429 تعني: خفّف الوتيرة وأعد المحاولة بعد قليل.
• تعامل مع المفتاح كأنه كلمة مرور. اختر مفتاحًا محدودًا بما يحتاجه المساعد فقط، وألغِه من لوحة التحكم إن تسرّب.

حل المشكلات