---
title: "Claude Code مع OmniChannels.ai: ابنِ المراسلة واختبرها من الطرفية"
description: "أضف خادم MCP من OmniChannels.ai إلى Claude Code لإرسال رسائل تجريبية ومتابعة تقارير التسليم، واستخدم مواصفات OpenAPI لبناء تكامل واتساب وSMS."
canonical: "https://omnichannels.ai/ar/integrations/claude-code/"
language: "ar"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Claude Code مع OmniChannels.ai: ابنِ المراسلة واختبرها من الطرفية

Canonical: https://omnichannels.ai/ar/integrations/claude-code/
Language: ar
Publisher: OmniChannels.ai by BroadNet Technologies

**باختصار:** يتصل Claude Code بمنصة OmniChannels.ai بأمر واحد: claude mcp add --transport http موجّهًا إلى https://mcp.broadnet.me/mcp مع ترويسة Authorization: Bearer. بعدها يستطيع إرسال رسائل تجريبية، وعرض قوالب واتساب، والاطلاع على تقارير التسليم، بينما يكتب شيفرة التكامل اعتمادًا على مواصفات OpenAPI 3.1 لدينا. ويتشارك الفريق الخادم عبر الملف .mcp.json، وتحدد قواعد الأذونات الأدوات التي تعمل دون طلب تأكيد.

الربط عبر MCP · الربط عبر API وWebhooks

## ما الذي يمكنك فعله

### كتابة الشيفرة من القوالب الفعلية

يقرأ Claude Code قوالب واتساب المعتمدة لديك عبر MCP، ويكتب دالة تتضمن المتغيرات التي يحتاجها كل قالب بالضبط.

> جرّب أن تطلب: "استخدم أدوات omnichannels لعرض قوالب واتساب المعتمدة لديّ، ثم اكتب دالة TypeScript ترسل القالب order_update بالحقول التي يحتاجها."

### بناء معالج Webhooks

وجّه Claude Code إلى دليل Webhooks، فيكتب نقطة استقبال تحفظ حالات التسليم والرسائل الواردة، وتتعامل مع الحقول التي تختلف من قناة لأخرى.

> جرّب أن تطلب: "اكتب معالج Webhook باستخدام Express يسجّل الحالات SUBMITTED وSENT وDELIVERED وREAD وFAILED وREJECTED حسب معرّف الرسالة، ويسجّل الحقول غير المعروفة في السجل بدلًا من أن يفشل."

### توليد عميل برمجي من المواصفات

عندما تكون مواصفات OpenAPI محفوظة في مستودعك، يستخدم Claude Code المسارات والحقول الصحيحة بدلًا من تخمينها.

> جرّب أن تطلب: "اعتمادًا على docs/omnichannels-openapi.yaml، اكتب وحدة Python ترسل رسالة SMS عبر POST /sms/sendSms، واذكر كل حقل استخدمته مع نوعه كما ورد في المواصفات."

### اختبار شامل على رقمك

يرسل Claude Code رسالة تجريبية بعد موافقتك على استدعاء الأداة، ثم يتحقق من تقرير التسليم ليؤكد أن مسار شيفرتك يعمل.

> جرّب أن تطلب: "أرسل رسالة SMS تجريبية من OmniDemo إلى رقمي 447700900123، ثم تحقق من تقرير تسليمها."

### تتبّع الرسائل الفاشلة

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

> جرّب أن تطلب: "اطّلع على تقرير تسليم حملة أمس، ولخّص أسباب الفشل، وراجع شيفرة إعادة المحاولة لدينا مقارنةً بدليل الأخطاء."

## كيف يتم الربط

يضيف Claude Code خوادم MCP البعيدة بالأمر claude mcp add --transport http مع ترويسة Authorization. وتعوّض الطرفية (Shell) قيمة الرمز من متغير البيئة عند تنفيذ الأمر. أما للفرق، فيتيح ملف .mcp.json على مستوى المشروع لكل مطوّر أن يزوّد رمز الوصول الخاص به عبر ${BROADNET_TOKEN}، ويطلب Claude Code من كل شخص الموافقة على الخادم قبل استخدامه.

يغطي MCP العمليات على حسابك: إرسال رسائل تجريبية، والاطلاع على القوالب وتقارير التسليم. أما لكتابة شيفرة التكامل، فزوّد Claude Code بمواصفات OpenAPI 3.1 لدينا مرجعًا معتمدًا لنقاط الاتصال والحقول، إضافة إلى دليل Webhooks، لأن حمولات Webhooks غير مذكورة في المواصفات. وتتيح قواعد أذونات مثل mcp__omnichannels__get_* تشغيل أدوات القراءة دون طلب تأكيد، بينما تظل أدوات الإرسال تطلبه.

- الأمر: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
- إعداد الفريق: ارفع .mcp.json بقيمة Bearer ${BROADNET_TOKEN}، ولا ترفع مفتاحًا أبدًا
- تُسمّى الأدوات في قواعد الأذونات بالصيغة mcp__omnichannels__<tool>
- مواصفات OpenAPI 3.1 على /developers/openapi.json لمعرفة حقول الطلب بدقة
- إرسال SMS الفردي بصيغة JSON، أما الإرسال الجماعي ومعظم القنوات الأخرى فبصيغة multipart/form-data

## خطوات الإعداد

1. **اطلب الوصول إلى API:** اطلب وصولًا تجريبيًا واحصل على رمز وصول لواجهة API. تُرسل الرسائل التجريبية إلى أرقامك الموثّقة فقط.
2. **احصل على مفتاح مؤقت:** في بوابة الإدارة افتح Integrations ثم MCP Integration، واختر Get temporary key (الحصول على مفتاح مؤقت)، ثم صدّره في المتغير BROADNET_TOKEN. (الدليل: https://omnichannels.ai/developers/mcp/)
3. **أضف الخادم:** نفّذ claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp مع ترويسة Authorization، أو ارفع ملف .mcp.json للمشروع ليستخدمه فريقك، ثم تحقق منه عبر /mcp. (الدليل: https://omnichannels.ai/developers/mcp-claude-code/)
4. **اضبط قواعد الأذونات:** اسمح بأدوات القراءة مثل mcp__omnichannels__get_* إن شئت، وأبقِ كل أدوات الإرسال على طلب التأكيد، وامنع الأدوات التي لا يحتاجها المشروع. (الدليل: https://omnichannels.ai/developers/mcp-claude-code/)
5. **أضف مواصفات OpenAPI:** نزّل openapi.yaml إلى مستودعك، واطلب من Claude Code اعتماده في مسارات نقاط الاتصال والحقول والقيم المسموح بها. (الدليل: https://omnichannels.ai/developers/openapi/)
6. **اختبر على رقمك:** اطلب من Claude Code إرسال رسالة تجريبية إلى رقمك الموثّق، ثم اطّلع على تقرير التسليم.

## مثال على سير العمل

Claude Code (يكتب شيفرة التكامل ويستدعي الأدوات عند الطلب) → MCP وAPI من OmniChannels.ai (أدوات MCP للاختبار، وشيفرتك تستدعي واجهة REST API) → هاتفك التجريبي (رسالة SMS أو واتساب تجريبية إلى رقمك الموثّق) → معالج Webhooks لديك (يستقبل حالات التسليم والرسائل الواردة)

## أسئلة شائعة

### هل توجد إضافة رسمية من OmniChannels.ai لـ Claude Code؟

لا. يتصل Claude Code عبر دعمه القياسي لخوادم MCP البعيدة، باستخدام نقطة الاتصال العامة لدينا ورمز الوصول الخاص بك، ويقرأ مواصفات OpenAPI العامة لدينا كأي ملف آخر في مستودعك.

### كيف أشارك الخادم مع فريقي دون مشاركة مفتاح؟

ارفع ملف .mcp.json على مستوى المشروع تستخدم فيه ترويسة Authorization القيمة ${BROADNET_TOKEN}. يضبط كل مطوّر هذا المتغير في طرفيته، ويطلب Claude Code منه الموافقة على خادم المشروع قبل استخدامه.

### هل يستطيع Claude Code إرسال رسائل دون أن يسأل؟

يطلب Claude Code التأكيد افتراضيًا قبل استخدام أي أداة MCP. أبقِ ذلك لأدوات الإرسال، لأن كل إرسال رسالة حقيقية تُحتسب عليها رسوم. واسمح بأدوات القراءة فقط في قواعد الأذونات، وتحقق أولًا من أسماء الأدوات عبر /mcp لأنها تتوقف على إصدار الخادم وإعدادات حسابك.

### هل أستخدم MCP أم واجهة REST API في منتجي؟

استخدم MCP ليتمكن Claude Code من الاختبار وفحص حسابك أثناء التطوير. أما الشيفرة التي تطلقها في الإنتاج، فيجب أن تستدعي واجهة REST API مباشرة برمز وصول من مخزن الأسرار لديك، معتمدةً على مواصفات OpenAPI لمعرفة الحقول بدقة.

## أدلة المطوّرين

- https://omnichannels.ai/developers/mcp-claude-code/
- https://omnichannels.ai/developers/openapi/
- https://omnichannels.ai/developers/webhooks/
- https://omnichannels.ai/developers/mcp/

## توثيق الجهة المطوّرة

- [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Claude Code permissions](https://code.claude.com/docs/en/permissions)

## تكاملات ذات صلة

- https://omnichannels.ai/ar/integrations/claude/
- https://omnichannels.ai/ar/integrations/cursor/
- https://omnichannels.ai/ar/integrations/vs-code/
- https://omnichannels.ai/ar/integrations/langchain/

Claude Code علامة تجارية مملوكة لأصحابها. لا ترتبط OmniChannels.ai بـ Claude Code ولا تحظى بتأييدها؛ تصف هذه الصفحة ربطاً يتم عبر ميزات MCP أو HTTP أو Webhooks المتوفرة في Claude Code نفسها.

آخر تحديث: 2026-10-10