ربط Claude

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

ما تحتاجه

• حساب بروكداك معتمد ينتمي إلى مؤسسة.
• خطة تشمل الوصول إلى واجهة البرمجة (Pro أو Enterprise). على خطة لا تشمله يُرفض الربط بالخطأ 402 عند أول طلب.
• رابط الخادم: https://procduck.com/api/mcp

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

تتصل تطبيقات Claude على الويب وسطح المكتب والجوال عبر الموصّلات المخصصة (Custom connectors). يسجّل الموصّل الدخول بحساب بروكداك الخاص بك من شاشة موافقة؛ لا مفتاح تنسخه ولا إعدادًا تكتبه.

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 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 فعله عبر الربط، في حدود دورك. أمثلة:

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

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

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

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

حل المشكلات

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