ربط Claude بـ digna¶

يربط هذا الدليل Claude بـ digna MCP Server. تحتاج إلى نقطة نهاية MCP الخاصة بتثبيت digna لديك ومفتاح API، كما هو موضح في نظرة عامة على وكلاء الذكاء الاصطناعي.

تستخدم الأمثلة https://digna.example.com/mcp كنقطة نهاية. استبدلها بنقطة النهاية الخاصة بك.

اختيار طريقة الاتصال¶

بالنسبة لتثبيت digna يعمل داخل شبكة شركتك، استخدم Claude Code أو Claude Desktop مع جسر محلي.

Claude Code¶

1. إضافة الخادم¶

ضع مفتاح API في متغير بيئة، ثم أضف الخادم:

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

تملأ الصدفة (shell) قيمة $DIGNA_API_KEY عند تشغيل الأمر، لذلك يخزّن Claude Code المفتاح في تهيئته الخاصة.

يحدد --scope أين يكون الخادم متاحًا:

2. مشاركة الخادم مع فريقك (اختياري)¶

لمنح كل من في المشروع الخادم نفسه، أضف ملف .mcp.json إلى جذر المشروع. لا تكتب المفتاح في الملف. يملأ Claude Code قيمة ${DIGNA_API_KEY} من بيئة كل شخص:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

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

3. التحقق من الاتصال¶

من الصدفة:

claude mcp list

يجب أن يظهر الخادم digna بالحالة ✔ Connected. داخل جلسة Claude Code، شغّل /mcp لرؤية الخادم وأدواته.

Claude Desktop مع جسر محلي¶

يشغّل ملف تهيئة Claude Desktop خوادم MCP محلية على جهازك. يعمل هناك جسر صغير، هو الحزمة مفتوحة المصدر mcp-remote، ويمرر كل طلب إلى نقطة نهاية digna مع مفتاح API الخاص بك. ولأن الجسر يعمل على جهازك، فإن هذه الطريقة تعمل مع digna داخل شبكة شركتك.

1. تثبيت Node.js¶

يحتاج الجسر إلى Node.js 18 أو أحدث. يستخدم Claude Desktop إصدار Node.js المثبت على نظامك. تحقق منه باستخدام:

node --version

2. تعديل ملف التهيئة¶

افتح claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

أضف الخادم digna. إذا كان الملف يحتوي بالفعل على قسم mcpServers، فأضف الإدخال digna إليه:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. إعادة تشغيل Claude Desktop¶

أغلق Claude Desktop بالكامل ثم شغّله مرة أخرى. في محادثة جديدة، انقر على + وافتح Connectors: يجب أن يظهر digna في القائمة وأن يكون مفعّلًا.

الموصل المخصص¶

يجعل الموصل المخصص digna متاحًا في claude.ai وClaude Desktop وتطبيقات Claude للأجهزة المحمولة دون أي إعداد محلي. تتصل سحابة Anthropic بنقطة النهاية، لذا لا يعمل هذا إلا عندما:

• تكون نقطة نهاية digna قابلة للوصول من الإنترنت عبر HTTPS
• يتوفر لدى مؤسستك في Claude الخيار Request headers في مربع الحوار Add custom connector. تقدمه Anthropic كإصدار تجريبي لمجموعة محدودة من المؤسسات

1. فتح إعدادات الموصل¶

• خطط Free وPro وMax وUltra: اذهب إلى Customize > Connectors وانقر على Add custom connector.
• خطط Team وEnterprise: يذهب المالك (Owner) إلى Organization settings > Connectors، وينقر على Add، ثم على Custom، ويختار Web إذا طُلب منه تحديد النوع.

2. إدخال تفاصيل الموصل¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: اختر authorization كاسم للترويسة، وأدخل Bearer <api key> كقيمة، بما في ذلك كلمة Bearer والمسافة، وحدده على أنه Required.
4. انقر على Add.

في خطط Team وEnterprise، يتصل الأعضاء بعد ذلك من Customize > Connectors، حيث يحمل الموصل التسمية Custom.

لا يمكن تغيير ترويسة موصل موجود في Claude. لاستخدام مفتاح جديد، احذف الموصل وأضفه مرة أخرى.

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

يعرض claude mcp list الرسالة Failed to connect¶

شغّل claude mcp get digna لمعرفة السبب. تعني 401 أن المفتاح قد رُفض؛ راجع 401 Unauthorized. ينبّه Claude Code أيضًا إلى وجود مسافات أو فاصل أسطر في بداية المفتاح أو نهايته، وهو ما يحدث غالبًا عند نسخه.

لا يظهر digna في Claude Desktop¶

• تحقق من تثبيت Node.js 18 أو أحدث: node --version.
• تحقق من أن claude_desktop_config.json ملف JSON صالح. فاصلة واحدة مفقودة تمنع تحميل كل الخوادم في الملف.
• أغلق Claude Desktop بالكامل، وليس النافذة فقط، ثم شغّله مرة أخرى.

لا يستطيع الموصل المخصص الوصول إلى الخادم¶

لا تستطيع سحابة Anthropic الوصول إلى نقطة النهاية. تحقق من أنها قابلة للوصول من الإنترنت عبر HTTPS بشهادة صالحة، أو اتصل بدلًا من ذلك عبر Claude Code.

انظر أيضًا¶

• نظرة عامة على وكلاء الذكاء الاصطناعي: نقطة النهاية ومفتاح API والأمان واستكشاف الأخطاء العام
• Gemini: ربط Antigravity أو Gemini CLI
• digna Agentic: ما يمكن لوكلاء الذكاء الاصطناعي فعله مع digna