ربط Claude

يستطيع Claude استخدام بروكداك مباشرة: البحث في المنافسات، وقراءة البنود وسجل الترسيات، وتسعير البنود، وإعداد عروض الأسعار، وتسجيل عروض الموردين (باسمك وداخل مؤسستك) عبر خادم MCP نفسه الذي يشغل مساعد واتساب. تسجيل دخول واحد يكفي للربط، ولا حاجة لتثبيت أي شيء.

ما تحتاجه

• حساب بروكداك معتمد ينتمي إلى مؤسسة.
• الخطة الاحترافية أو خطة المؤسسات. فخطة البداية لا تشمل واجهة API ولا ربط MCP، ويرفض كل طلب منها بالرمز 403 plan_upgrade_required. وفي الاحترافية لكل مستخدم مفتاح API واحد أو ربط MCP واحد (ولا يحتسب ربط المساعد على واتساب)، ولا حد في خطة المؤسسات. ويحتسب كل طلب من الحد اليومي لطلبات API في مؤسستك، وهو مشترك مع زملائك ومع المساعد على واتساب: 1,000 في الاحترافية، وبلا حد في المؤسسات.
• رابط الخادم: https://procduck.com/api/mcp

للبداية: الخادم المختصر

جديد على بروكداك؟ اربط Claude بالخادم المختصر. يعمل بتسجيل الدخول نفسه وبحسابك نفسه، ويعرض على Claude أدوات خطواتك الأولى فقط: إضافة المصنعين والمنتجات إلى كتالوجك، والمشاركة في المنافسات. وقلة الأدوات تبقي Claude على مهمته، ولا يستطيع هذا الربط شيئا لا يستطيعه الربط الكامل، فكل طلب يعمل باسمك وفي حدود دورك. استخدم رابطه في الخطوات أدناه بدلا من رابط الخادم الكامل:

https://procduck.com/api/mcp/lite

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

أما بقية الأدوات (عروض الأسعار، وطلبات التسعير، والاستيراد من جدول بيانات، وحذف ملفات المنتجات، ومستندات المصنعين، والتنبيهات، وأوامر البيع والشراء، والفواتير) فعلى الخادم الكامل https://procduck.com/api/mcp. وللانتقال إليه أضف موصلا بالرابط الكامل. وفي الخطة الاحترافية لكل مستخدم ربط واحد، فألغ الربط المختصر أولا من الإعدادات ← التكاملات.

Claude على الويب وتطبيق سطح المكتب

تتصل تطبيقات Claude على الويب وسطح المكتب والجوال عبر الموصلات المخصصة (Custom connectors). يسجل الموصل الدخول بحسابك في بروكداك من شاشة موافقة، فلا مفتاح تنسخه ولا إعدادا تكتبه. وتتغير قوائم Claude من حين لآخر، فإذا اختلف اسم عما هنا فابحث عن أقرب ما يشبهه.

1. في Claude افتح الإعدادات ← الموصلات (Settings → Connectors) واختر إضافة موصل مخصص (Add custom connector).
2. سمه *ProcDuck* والصق رابط الخادم https://procduck.com/api/mcp. اترك حقلي OAuth المتقدمين (معرف العميل والسر) فارغين، فيسجل الموصل نفسه تلقائيا.
3. اضغط إضافة ثم اتصال (Connect). تفتح صفحة من بروكداك: سجل الدخول إن طلب منك، وتأكد من المؤسسة والدور المعروضين، ثم اضغط السماح بالوصول.
4. بالعودة إلى Claude، فعل ProcDuck في المحادثة من قائمة الأدوات واسأل ما تشاء. مثل «ما منافسات نوبكو المفتوحة التي تطابق كتالوجي؟».

أداة Claude Code

يأخذ Claude Code الرابط نفسه كخادم MCP بعيد. سجل الدخول من المتصفح في المرة الأولى، أو مرر مفتاح API بدلا من ذلك.

claude mcp add --transport http procduck https://procduck.com/api/mcp

ثم نفذ /mcp داخل Claude Code واختر ProcDuck للمصادقة؛ تفتح شاشة الموافقة نفسها في متصفحك.

لتجاوز المتصفح (على خادم أو في التكامل المستمر) أنشئ مفتاح API من الإعدادات ← التكاملات (الخطة الاحترافية وخطة المؤسسات) ومرره في ترويسة. وفي الاحترافية يكون هذا المفتاح هو الربط الواحد المتاح لك، فلا يجتمع مع ربط Claude:

claude mcp add --transport http procduck https://procduck.com/api/mcp \
  --header "Authorization: Bearer sk_live_YOUR_API_KEY"

ولمشاركة الربط مع فريق يعمل على المشروع نفسه، ضعه في ملف .mcp.json في جذر المستودع، مع قراءة المفتاح من متغير بيئة بدل كتابته في الملف:

{
  "mcpServers": {
    "procduck": {
      "type": "http",
      "url": "https://procduck.com/api/mcp",
      "headers": { "Authorization": "Bearer ${PROCDUCK_API_KEY}" }
    }
  }
}

واجهة Claude البرمجية (Messages API)

يستطيع تطبيقك الخاص أن يمنح Claude أدوات بروكداك عبر موصل MCP في Messages API: سم الخادم مع مفتاح API كرمز Bearer له، وأضف مجموعة أدواته إلى الطلب.

{
  "model": "claude-opus-5",
  "max_tokens": 16000,
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://procduck.com/api/mcp",
      "name": "procduck",
      "authorization_token": "sk_live_YOUR_API_KEY"
    }
  ],
  "tools": [{ "type": "mcp_toolset", "mcp_server_name": "procduck" }],
  "messages": [
    { "role": "user", "content": "List the open NUPCO tenders about syringes" }
  ]
}

موصل MCP ميزة تجريبية (beta) في Messages API: أرسل ترويسة الإصدار التجريبي الخاصة به (anthropic-beta: mcp-client-2025-11-20 وقت كتابة هذا الدليل) وراجع وثائق Anthropic للقيمة الحالية.

عملاء MCP آخرون

أي عميل يتحدث MCP عبر Streamable HTTP يعمل بالطريقة نفسها: وجهه إلى الرابط، ثم إما أكمل تسجيل الدخول (للعملاء الداعمين لـ OAuth) أو أرسل مفتاح API في الترويسة Authorization: Bearer sk_live_…. الخادم عديم الحالة (يجيب عن كل طلب كاملا ولا يفتح بثا من الخادم إلى العميل) وهو ما يتعامل معه كل عميل حديث. ويبقى خادم stdio المحلي متاحا لتشغيل الأدوات إلى جانب نسخة من الشيفرة؛ انظر مرجع واجهة البرمجة.

ما الذي يستطيع Claude فعله

كل ما تفعله في المنصة يستطيع Claude فعله عبر الربط، في حدود دورك. أمثلة:

• البحث في المنافسات وقراءتها (بكلمة مفتاحية أو نص بند أو رقم منافسة أو جهة) والحصول على الملخص الذكي لأي منها.
• إدارة العطاءات: إضافة منافسات إلى العطاءات، وتحديد البنود المشاركة، وإدخال أسعار الوحدات، وإعداد ملف مرفقات نوبكو وخطاب التغطية، وتعبئة ملف الرد حيثما يتيح لك تطبيق Claude تمرير ملف البوابة إليه.
• إدارة الكتالوج: المنتجات والمصنعون والصور والمستندات، واستيراد قائمة أسعار من جدول بيانات.
• عروض الأسعار وطلبات عروض الأسعار: إعداد عرض سعر وتوليد ملف PDF له، وإرسال طلب عرض أسعار، وتسجيل عرض مورد من ملف PDF أو بريد إلكتروني.
• الطلبات والتسليم: أوامر البيع الواردة، وأوامر الشراء الصادرة وتسجيل الاستلام عليها، والتسليمات التي تنفذها.
• الفريق والتنبيهات: تنبيهات الكلمات المفتاحية، والإشعارات، ونشاط الفريق.

وتجد طلبات جاهزة وعادات للاستخدام الآمن في العمل مع Claude، وشرحا لكل أداة بمعاملاتها وصلاحياتها في مرجع أدوات MCP. وتجد خطوات الربط مصورة في مقال إعداد Claude مع بروكداك. ولملء الكتالوج بمساعدة Claude استخدم مهارات Claude لبناء الكتالوج.

إدارة الوصول وإلغاؤه

يظهر كل ربط في الإعدادات ← التكاملات (الخطة الاحترافية وخطة المؤسسات، وللمالك والمدير) كمفتاح API باسم التطبيق الذي اتصل (مثل *Claude · MCP*) مملوك لمن ربطه. أوقفه لتعليق الربط، أو ألغه لإنهائه؛ وسيطلب Claude تسجيل الدخول مجددا في المرة التالية التي يحتاج فيها إلى الخادم. وإعادة ربط التطبيق نفسه تستبدل مفتاحه السابق، ولا تحتسب ربطا ثانيا في الخطة الاحترافية.

ولأن المفتاح يحمل دورك، ينطبق أي تغيير في دورك على الربط فورا، وإزالة مسؤول لك من المؤسسة تنهي كل ربط أنشأته.

حل المشكلات

• يقول Claude إنه لا يستطيع الاتصال أو إن الخادم لا يدعم تسجيل الدخول: تأكد أن الرابط هو …/api/mcp تماما، أو …/api/mcp/lite للخادم المختصر (بلا شرطة مائلة في النهاية وبلا بادئة لغة)، وأنك على نشر بروكداك نفسه الذي تسجل الدخول إليه.
• تقول شاشة الموافقة إن الطلب غير صالح أو انتهت صلاحيته: رابط تسجيل الدخول يستخدم مرة واحدة ولوقت قصير؛ ابدأ من جديد من Claude.
• `402 plan_limit_reached`: نفد حد اليوم من طلبات API في مؤسستك.
• `403 insufficient_role`: دورك لا يسمح بهذا الإجراء.
• `403 plan_upgrade_required`: خطتك لا تشمل هذه الميزة. وفي خطة البداية يرد كل طلب بهذا الرمز مع الميزة api_access، لأنها لا تشمل واجهة API ولا ربط MCP.
• `403 plan_limit_reached` مع `api_keys_per_user`: لديك في الخطة الاحترافية مفتاح API أو ربط MCP بالفعل، والخطة تسمح بواحد لكل مستخدم. ألغ القديم من الإعدادات ← التكاملات (يستطيع ذلك المالك أو المدير) ثم اتصل من جديد. أما المفاتيح النشطة التي أنشئت قبل هذه القاعدة فتبقى تعمل.
• ما زال Claude يعرض الربط بعد إلغاء المفتاح: قد يظل يعرضه حتى يرفض الخادم الطلب التالي، ويفترض أن يعرض عليك بعدها تسجيل الدخول مجددا. فإذا لم يفعل فاحذف الموصل من إعدادات Claude وأضفه مرة أخرى.