ربط أدوات الذكاء الاصطناعي بـ MCP

لدى Ody خادم MCP (بروتوكول سياق النموذج) مدمج على https://api.ody.co/v1/mcp — أضفه إلى ChatGPT، Claude، Cursor، أو أي عميل MCP باستخدام مفتاح API، ويمكن للمساعد إدارة جهات الاتصال، والتعامل مع محادثاتك، والبحث في الرسائل، وإرسال الرسائل النصية، وشراء أرقام الهواتف، وتسجيل 10DLC للرسائل النصية، وإجراء مكالمات الذكاء الاصطناعي الصادرة، وتكوين وكيل الذكاء الاصطناعي الخاص بك في مساحة عملك.

قبل أن تبدأ

• تحتاج إلى مفتاح API — انظر الحصول على مفتاح API الخاص بك من Ody. بالنسبة للمساعد الذي يجب أن يكون للقراءة فقط، أنشئ المفتاح بنطاقات القراءة فقط. للاختبار دون إرسال رسائل نصية حقيقية، استخدم مفتاح ody_test_… — انظر الإنشاء بأمان باستخدام وضع الاختبار.
• يتضمن MCP في كل خطة، بدءًا من Starter.

خطوة بخطوة

1. انقر على الإعدادات في الشريط الجانبي، ثم واجهة برمجة تطبيقات المطور.

2. انتقل إلى بطاقة الاتصال بـ ChatGPT و Claude. تعرض نقطة نهاية MCP — https://api.ody.co/v1/mcp — مع زر نسخ، وتكوين عميل جاهز للصق.

3. في إعدادات MCP/الموصل الخاصة بأداة الذكاء الاصطناعي لديك، أضف خادمًا باستخدام هذا التكوين (مع مفتاحك الحقيقي):

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. اطلب من المساعد شيئًا مثل "أعطني ملخصًا لمساحة عمل Ody الخاصة بي" لتأكيد الاتصال.

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

يعرض خادم MCP عشرين أداة، كل منها محكوم بنفس النطاق الذي تستخدمه نقطة نهاية REST الخاصة به:

الأداة	ما تفعله	النطاق المطلوب
list_contacts	سرد أو البحث في جهات الاتصال الخاصة بك	contacts:read
create_contact	إضافة جهة اتصال	contacts:write
update_contact	تحديث اسم جهة الاتصال أو شركتها أو هاتفها أو بريدها الإلكتروني	contacts:write
delete_contact	حذف جهة اتصال بشكل دائم	contacts:write
list_conversations	سرد المحادثات المفتوحة/المنتهية	conversations:read
get_conversation	قراءة سلسلة محادثات كاملة	conversations:read
set_conversation_status	وضع علامة على محادثة كمفتوحة أو منتهية	conversations:write
search_messages	البحث في نصوص الرسائل، ونصوص البريد الصوتي، وملاحظات المكالمات	conversations:read
workspace_summary	لقطة: عدد جهات الاتصال، عدد المحادثات المفتوحة/المنتهية، إجمالي غير المقروء، حجم 7 أيام	conversations:read
wait_for_message	الانتظار (حتى 25 ثانية) لرسالة واردة جديدة في محادثة	conversations:read
send_message	إرسال SMS (إلى محادثة أو رقم هاتف)	messages:send
list_numbers	سرد أرقام مساحة عملك	numbers:read
search_numbers	البحث عن أرقام الهواتف التي يمكنك شراؤها	numbers:manage
buy_number	شراء رقم — يتم فوترته كشراء داخل التطبيق	numbers:manage
get_messaging_status	التحقق من حالة تسجيل الرسائل النصية 10DLC	numbers:manage
submit_10dlc_registration	تقديم عملك وحملتك 10DLC (مدفوع)	numbers:manage
place_call	اجعل وكيل الذكاء الاصطناعي المنشور الخاص بك يجري مكالمة صادرة	calls:place
get_agent	قراءة تكوين وكيل الذكاء الاصطناعي الخاص بك واستخدام الرصيد	agent:manage
configure_agent	تحديث تكوين الوكيل؛ مرر publish: true للبدء المباشر	agent:manage
connect_agent_to_number	توجيه أحد أرقامك إلى وكيل الذكاء الاصطناعي	agent:manage

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

أمران يستحقان المعرفة:

• تتيح wait_for_message للمساعد إجراء محادثة SMS مباشرة: حيث يرسل رسالة نصية باستخدام send_message، وينتظر ما يصل إلى 25 ثانية للرد، ثم يستجيب — مستدعيًا الأداة مرة أخرى إذا انتهت مهلة الانتظار.
• أدوات الأرقام، و10DLC، والمكالمات، والوكيل هي نفس واجهة "هاتف الوكيل" (Agent Phone) مثل REST API — نفس الفوترة، ونفس القواعد، ويمكنك التحكم في التطبيق في أي لحظة. انظر شراء الأرقام وتسجيل الرسائل النصية عبر API و إجراء مكالمات الذكاء الاصطناعي وإدارة Astra عبر API.

باستخدام مفتاح اختبار، تسجل send_message رسالة محاكاة، وتحاكي buy_number و place_call (لا يتم شراء أو طلب أي شيء)، ويتم محاكاة نشر الوكيل، وتقدم submit_10dlc_registration الملفات في وضع المحاكاة — بدون رسوم، بدون تقديم للسجل.

مقالات ذات صلة

• الحصول على مفتاح API الخاص بك من Ody
• الإنشاء بأمان باستخدام وضع الاختبار
• نظرة عامة على API والمصادقة