concierge MCP — حالات الاستخدام, التثبيت & عرض مباشر

لماذا تستخدمه

الميزات الأساسية

الكشف التدريجي — كشف فقط الأدوات ذات الصلة بخطوة سير العمل الحالية
حالة سير العمل المشتركة عبر الخطوات دون توصيل يدوي
البحث الدلالي عن الأدوات — يستحق الأمر بمجرد تجاوزك ~100 أداة
نقل متعدد: stdio, HTTP, SSE
معزولة الجلسة — مسارات العمل المتزامنة لا تطغى على بعضها البعض

عرض مباشر

كيف يبدو في الممارسة

concierge.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "concierge": {
      "command": "uvx",
      "args": [
        "concierge"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "concierge": {
      "command": "uvx",
      "args": [
        "concierge"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "concierge": {
      "command": "uvx",
      "args": [
        "concierge"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "concierge": {
      "command": "uvx",
      "args": [
        "concierge"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "concierge",
      "command": "uvx",
      "args": [
        "concierge"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "concierge": {
      "command": {
        "path": "uvx",
        "args": [
          "concierge"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add concierge -- uvx concierge

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: concierge

لف واجهة برمجية REST ضخمة (200+ نقطة نهاية) باعتبارها MCP دون إفساد السياق

👤 مهندسو المنصات الذين يكشفون واجهات برمجية داخلية لنماذج اللغة ⏱ ~90 min advanced

متى تستخدمه: عندما تحتوي واجهة برمجية شركتك على 300 نقطة نهاية وتقوم MCP ساذجة بإدراج جميعها في المطالبة النظامية، مما يؤثر على الكمون ومعدل الضربات.

المتطلبات الأساسية

Python 3.9+ — pyenv / uv
مواصفات OpenAPI أو فهرس نقاط النهاية — بوابة واجهة برمجية / Swagger الخاصة بك

الخطوات

إنشاء الهيكل الأساسي باستخدام concierge-sdk

باستخدام concierge-sdk، أنشئ هيكل خادم MCP يلف مواصفات OpenAPI الخاصة بي في ./openapi.yaml. اجعله يستخدم البحث الدلالي بدلاً من إدراج جميع الأدوات مقدماً.✓ تم النسخ

→ رمز نموذجي + معالج البحث
حدّد مراحل سير العمل

جمّع نقاط النهاية في 3 مسارات عمل: 'عمليات القراءة'، 'عمليات الإنشاء'، 'المسؤول'. يكشف كل سير عمل فقط عن أدواته الخاصة.✓ تم النسخ

→ تعاريف سير العمل مع قوائم الأدوات المسموحة
اختبر باستخدام Claude

قم بتوصيل Claude Desktop بهذا الخادم والتحقق من أن إدراج الأدوات يعرض فقط أداة البحث + أدوات سير العمل الحالية — وليس جميع الـ 300.✓ تم النسخ

→ Claude يرى ~10 أدوات، وليس 300

النتيجة: سطح واجهة برمجية كبير قابل للاستخدام من قبل نموذج لغة دون الانهيار على طول المطالبة النظامية.

المزالق

يعيد البحث الدلالي الأداة الخاطئة عندما تكون الأوصاف متشابهة جداً — اكتب أوصاف أداة مميزة من سطر واحد؛ اختبر البحث باستخدام استعلامات محجوزة

بناء سير عمل موجه متعدد الخطوات (على سبيل المثال، تدريب العميل)

👤 المطورون الذين يبنون مسارات وكيل منظمة ⏱ ~60 min advanced

متى تستخدمه: تريد من نموذج اللغة أن يتبع سلسلة محددة: جمع المعلومات → التحقق → إنشاء السجل → الإخطار. لكل خطوة أدواتها الخاصة.

الخطوات

أعلن عن سير العمل

عرّف سير عمل concierge 'customer_onboarding' بخطوات [جمع، تحقق، إنشاء، إخطار]، لكل منها مجموعة أدواته الخاصة.✓ تم النسخ

→ إعدادات سير العمل
شارك الحالة

مرر قاموس customer_data من الخطوة 1 إلى الخطوات 2، 3، 4 عبر الحالة المشتركة. أرني كيف.✓ تم النسخ

→ رمز كائن الحالة
التعامل مع الفشل

إذا فشل التحقق، عد إلى الخطوة 1 مع الإصلاح المحدد المطلوب.✓ تم النسخ

→ منطق إعادة المحاولة/الرجوع

النتيجة: سير عمل موجه قوي يحافظ على توجيه نموذج اللغة نحو الهدف.

المزالق

محاولة نموذج اللغة تخطي الخطوات — تفرض Concierge الترتيب على مستوى رؤية الأداة — التخطي مستحيل فعلياً إذا قمت بإعدادها بشكل صحيح

أطلق خادم MCP الأول لك في 15 دقيقة

👤 المطورون الجدد في MCP ⏱ ~15 min beginner

متى تستخدمه: تريد كشف 3-5 وظائف لـ Claude ولا تريد تعلم مواصفات MCP الخام.

الخطوات

التثبيت وإنشاء الهيكل الأساسي

pip install concierge-sdk. أنشئ خادماً بسيطاً يكشف عن أداتين: add(a, b) و greet(name). نقل Stdio.✓ تم النسخ

→ ملف Python عامل
التشغيل والاتصال

أضفه إلى إعدادات Claude Desktop واختبر أن كلا الأداتين قابلة للاستدعاء.✓ تم النسخ

→ استدعاءات الأداة تنجح في Claude

النتيجة: خادم MCP عامل كتبته من البداية إلى النهاية في فترة ما بعد الظهر.

المزالق

تلميحات النوع المفقودة — يعتمد SDK عليها لمخطط الأداة — اكتب نوع الوسائط والإرجاع دائماً — ينشئ Concierge مخطط MCP منها

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

concierge + gateway

خدمة MCP المُنشأة بواسطة concierge خلف بوابة أمان لتنقية المعلومات الشخصية

ابدأ خادم concierge على :8001، ثم أضفه كمصدر محاكي لـ mcp-gateway مع مكون Presidio.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
concierge.workflow(name)	name, steps, initial_state	حدّد سير عمل متعدد الخطوات مسمى	framework only
concierge.tool(workflow, step)	step allowlist	إرفق دالة كأداة ذات نطاق لواحدة أو أكثر من الخطوات	framework only
concierge.search_tools	query: str	يتم الكشف عنها تلقائياً عندما يكون لديك أدوات كثيرة جداً لإدراجها بلهفة	free
concierge.serve()	transport: 'stdio'\|'http'\|'sse'	نقطة الدخول للبرنامج النصي الخاص بك	free

التكلفة والحدود

تكلفة التشغيل

حصة API: لا توجد — أنت المؤلف
الرموز لكل استدعاء: يعتمد على تصميم الأداة الخاصة بك؛ يقلل الكشف التدريجي المطالبات النظامية بمعامل 5-10x
التكلفة المالية: مجاني ومفتوح المصدر
نصيحة: لا تكشف كل أداة بلهفة. ابدأ بـ 'البحث' + أدوات الخطوة الحالية. أضف أدوات متحمسة فقط إذا أظهر التنميط أن نموذج اللغة يحتاجها دائماً.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: يتعامل خادم MCP الخاص بك مع بيانات الاعتماد الخاصة به — لا تفرض concierge نموذجاً

نقل البيانات الخارجي: كل ما تستدعيه أدواتك

كـ SDK، نموذج التهديد في concierge وراثي من كيفية استخدامك له. تحقق من المدخلات في كل أداة.
عزل الجلسة يحمي الحالة لكل مستخدم لكن الموارد الخارجية المشتركة تحتاج إلى أقفالها الخاصة.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Tools not appearing in the expected step

تحقق من وسيط step على @concierge.tool. أداة بـ step=['create'] غير مرئية أثناء collect.

تحقق:

استدعِ أداة search_tools؛ إذا لم يرجع شيء، فقائمة الأدوات المسموحة لديك خاطئة

Semantic search returns no results

قد تكون أوصاف الأداة فارغة. ينشئ Concierge تضمينات من docstrings — املأها.

Workflow state lost between calls

حالة Concierge ذات نطاق الجلسة. تأكد من أن عميلك لزج (نفس جلسة MCP عبر الاستدعاءات).

البدائل

concierge مقابل البدائل

البديل	متى تستخدمها	المقايضة
fastmcp (Python)	تريد مكتبة Python MCP الأكثر شهرة بدون كشف تدريجي	أخف وزناً، لكن بدون ميزات حجب سير العمل/الأداة المدمجة
Official MCP Python SDK	تريد إطار عمل صفري، الأقرب للمواصفات	رمز نموذجي أكثر؛ تبني البوابة بنفسك
TypeScript MCP SDK	مجموعة التقنيات الخاصة بك هي TS/Node	لغة مختلفة؛ لا توجد نسخة مكافئة من concierge مباشرة

concierge

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

التثبيت

اختر العميل

حالات الاستخدام

استخدامات عملية: concierge

المتطلبات الأساسية

الخطوات

المزالق

الخطوات

المزالق

الخطوات

المزالق

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

الأدوات

ما يوفره هذا الـ MCP

التكلفة والحدود

تكلفة التشغيل

الأمان

الصلاحيات والأسرار ونطاق الأثر

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البدائل

concierge مقابل البدائل

المزيد

الموارد