خادم MCP: اربط مساعد ذكاء اصطناعي

يتيح خادم MCP من WbizTool لمساعد ذكاء اصطناعي العمل مع مساحة عملك. يمكنك أن تسأله أشياء مثل «ما الرسائل التي فشلت اليوم، ولماذا؟» أو «أوقف تذكير الإيجار مؤقتًا» أو «أرسل مواعيد عملنا الجديدة إلى هؤلاء العملاء الخمسة»، فيستخدم حسابك في WbizTool لتنفيذها.

يتحدث الخادم بروتوكول Model Context Protocol ‏(MCP)، الذي تفهمه Claude Code وCursor وVS Code وأدوات ذكاء اصطناعي أخرى. وفي الخلفية، كل إجراء هو استدعاء لـ API v2 يتم بمفتاح API v2 الخاص بك، لذا يحدّد المفتاح ما يمكن للمساعد رؤيته وفعله.

ما يمكن للمساعد فعله#

لا يرى المساعد إلا الأدوات التي يسمح بها المفتاح (راجع النطاقات):

ويقدّم أيضًا ثلاثة طلبات جاهزة (prompts): ملخص يومي والرسائل الفاشلة وصياغة إعلان.

لا يمكنه ربط رقم جديد (يبقى ذلك في لوحة التحكم)، ولا رفع الملفات، ولا إدارة webhooks، ولا قراءة صندوق الوارد في Unibox.

1. أنشئ مفتاحًا للمساعد#

1. افتح بطاقة مفاتيح API v2

   في WbizTool، انتقل إلى الإعدادات ← مفاتيح API وابحث عن بطاقة مفاتيح API v2.

2. استخدم الإعداد الجاهز لمساعد الذكاء الاصطناعي

   انقر على إنشاء مفتاح v2، ثم على لمساعد ذكاء اصطناعي. يُنشئ ذلك مفتاحًا للقراءة فقط يمكنه قراءة الرسائل والأرقام وينتهي بعد 90 يومًا – وهي بداية آمنة: يستطيع المساعد أن يطّلع، لكنه لا يستطيع إرسال أي شيء أو تغييره.

3. اسمح بالإرسال فقط إن أردت ذلك

   إذا كان على المساعد إرسال الرسائل أو إدارة التذكيرات، فألغِ تحديد للقراءة فقط وحدّد إرسال الرسائل (والتذكيرات عند الحاجة). ويمكنك أيضًا قصر المفتاح على بعض أرقامك.

4. انسخ المفتاح

   يُعرض المفتاح (wbz_live_…) مرة واحدة فقط. احفظه في متغير بيئة على جهازك، مثل WBIZTOOL_API_KEY – ولا تلصقه أبدًا في ملف تشاركه أو تضيفه إلى commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. أضف الخادم إلى أداة الذكاء الاصطناعي#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: شغّل الأمر مرة واحدة (أضف --scope project لمشاركته مع مشروع عبر .mcp.json؛ يحتوي الملف على ${WBIZTOOL_API_KEY}، لا على المفتاح نفسه).
• Cursor: ضعه في ~/.cursor/mcp.json، أو في .cursor/mcp.json داخل مشروع.
• VS Code: ضعه في .vscode/mcp.json. يطلب VS Code المفتاح مرة واحدة ويحفظه في مخزن الأسرار الخاص به.

ثم اسأل المساعد شيئًا مثل «ما حسابي في WbizTool؟» – ينبغي أن يجيب باسم مساحة عملك وباقتها.

3. كيف يبقى الإرسال آمنًا#

• كل إرسال تسبقه معاينة. عندما تطلب رسالة، يحصل المساعد أولًا على معاينة من WbizTool – من أي رقم ستُرسَل، وإلى من، والنص بالضبط، وأي ملف، ومتى – ولم يُرسَل شيء بعد. ويُطلب منه أن يعرض عليك هذه المعاينة وأن ينتظر موافقتك. ولا يرسل إلا بعدها، وبالضبط ما رأيته.
• إعادة المحاولة لا ترسل مرتين أبدًا. إذا كرّر المساعد إرسالًا مؤكَّدًا (بعد انتهاء مهلة مثلًا)، يردّ WbizTool بالرسالة التي أرسلها من قبل.
• المفتاح هو الحدّ الصارم. المفتاح الذي للقراءة فقط لا يستطيع الإرسال إطلاقًا. والمفتاح الذي لا يملك إرسال الرسائل لا يرى أدوات الإرسال أصلًا، والمفتاح المقيد ببعض الأرقام لا يستطيع استخدام غيرها. وتنطبق حدود WbizTool نفسها أيضًا: 60 طلبًا في الدقيقة لكل مفتاح، و1,000 رسالة في اليوم على الأكثر لكل رقم.
• النص الوارد من الآخرين يُعلَّم كبيانات. تصل الرسائل والأسماء والملفات القادمة من الخارج إلى المساعد مُعلَّمة بأنها غير موثوقة، ويُطلب منه ألا يتّبع أبدًا أي تعليمات بداخلها.
• لا أسرار في الإجابات. لا تُعرض رموز QR ورموز الربط أبدًا، ولا تتضمن القوائم روابط الملفات.
• أبطِله في أي وقت. إبطال المفتاح في الإعدادات ← مفاتيح API يوقف المساعد فورًا.

الخصوصية#

عندما تربط مساعدًا، فإن ما يقرؤه من WbizTool (الرسائل والأسماء والأرقام التي تسمح للمفتاح برؤيتها) يُرسَل إلى مزوّد ذلك المساعد – مثل Anthropic في حالة Claude، أو OpenAI في حالة ChatGPT – ويُعالَج وفق شروطه. أما خادم MCP من WbizTool نفسه فلا يحتفظ بشيء: يمرّر كل طلب إلى API v2 ويسجّل الأداة التي استُخدمت، ولا يسجّل أبدًا نص الرسائل ولا مفتاحك. لا تمنح المفتاح إلا الصلاحيات التي يحتاجها المساعد.

استكشاف الأخطاء وإصلاحها#

صفحات ذات صلة#

• نظرة عامة على API v2
• مفاتيح API
• الرسائل في API v2
• التطبيقات والتكاملات