خادم TokenLab MCP

اختر ما يحتاجه وكيلكCopy Anchor Link

• يضيف MCP أدوات TokenLab API إلى عميل متوافق. ابدأ بالإعداد الخالي من المفاتيح لـ catalog أدناه.
• تقوم مهارة TokenLab بتثبيت تعليمات التكامل باستخدام npx skills add؛ ولا تبدأ خادم MCP.

كلاهما يوسعان وكيلاً حالياً. وتغيير مزود نموذجه الرئيسي يستخدم دليل الإعداد الخاص بذلك العميل.

دع وكيلي يقوم بإعداد هذاCopy Anchor Link

انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/ar/integrations/tokenlab-mcp-server
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

يتيح خادم TokenLab MCP لعميل MCP استعراض النماذج والأسعار الحالية، وإرسال طلبات النماذج، وإنشاء الوسائط، والعمل مع الملفات، والتحقق من المهام غير المتزامنة.

استخدم ملف تعريف catalog لتصفح النماذج والأسعار دون مفتاح API. أضف TOKENLAB_API_KEY عندما يتعين على العميل إجراء طلبات نماذج أو وسائط مدفوعة.

المتطلباتCopy Anchor Link

قم بتثبيت Node.js 18.17 أو إصدار أحدث وتأكد من توفر npx:

node --version
npx --version

تعمل حزمة npm محلياً عبر stdio. لا تحتاج إلى تثبيت عام أو استنساخ التعليمات البرمجية المصدرية.

اختر ما يمكن للعميل استخدامهCopy Anchor Link

ابدأ بـ catalog إذا كنت تريد فقط تحديداً أفضل للنماذج. استخدم core عندما يتعين على العميل إنشاء محتوى أو استدعاء نموذج. أما full فهو مخصص للعملاء الذين يحتاجون بالفعل إلى مجموعة أدوات أكبر.

إضافة الخادمCopy Anchor Link

قم بعمل نسخة احتياطية من التكوين النشط. أضف مدخل TokenLab فقط واحتفظ بالمزودين والحسابات واختيار النموذج الافتراضي والأذونات الحالية. إذا كان الاسم مستخدماً بالفعل، فاختر اسماً آخر وقم بتحديث الأوامر. للتراجع عن الإعداد، قم بإزالة الإدخال الذي تمت إضافته فقط أو استعد نسخته الاحتياطية السابقة.

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.24

تمكين الأدوات المدفوعةCopy Anchor Link

قم بإنشاء مفتاح API في Console ← API keys، ثم عيّن كلا المتغيرين في بيئة خادم MCP:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

استخدم إدخال الأسرار الخاص بعميلك إذا كان متاحاً. وإذا ظهر مفتاح حقيقي في ملف مشترك، أو لقطة شاشة، أو سجل، أو سجل الأوامر، فقم بإلغائه وإنشاء مفتاح جديد.

التحقق من الاتصالCopy Anchor Link

أعد تشغيل عميل MCP أو أعد تحميله، ووافق على الخادم المحلي إذا طُلب منك ذلك، وتأكد من اتصال tokenlab.

# Claude Code
claude mcp list

# Codex
codex mcp list

اطلب من العميل استدعاء list_models. تؤكد القائمة غير الفارغة بدء تشغيل الحزمة ووصولها إلى TokenLab. لا يحتاج ملف تعريف catalog إلى مفتاح API.

أدوات مفيدةCopy Anchor Link

يعتمد توفر الأدوات على ملف التعريف المحدد. تشمل المهام الشائعة ما يلي:

• إدراج النماذج وقراءة إمكانيات نموذج معين
• قراءة أسعار TokenLab الحالية أو مقارنة عدة نماذج
• إرسال طلبات Chat Completions أو Responses أو Anthropic Messages أو Gemini
• تقييم القرارات المحددة بالنوع باستخدام evaluate_decisions
• إنشاء الصور أو تعديلها
• إنشاء الفيديو أو الموسيقى أو النماذج ثلاثية الأبعاد (3D) أو الكلام أو التفريغ الصوتي أو الترجمة
• تحميل الملفات واسترجاعها
• إنشاء تضمينات (embeddings) أو إعادة ترتيب المستندات (rerank)
• التحقق من المهام غير المتزامنة المدعومة وإلغاؤها

يجب أن يطلب العميل الموافقة قبل إجراء مكالمة مدفوعة عندما لا يتم تأكيد السعر أو اختيار النموذج مسبقاً.

نماذج اتخاذ القرارCopy Anchor Link

استخدم core أو full لاستدعاء نموذج اتخاذ القرار System One. استدعِ أولاً list_models مع {"category":"decision"} و get_model مع معرف النموذج المحدد. احتفظ بنموذج الدردشة الرئيسي للوكيل مهيأً بشكل منفصل.

بالنسبة لـ Jev 1.13، استدعِ الأداة باستخدام state و questions الأصليين:

{
  "name": "evaluate_decisions",
  "arguments": {
    "model": "jev-1.13",
    "state": { "ticket": "Please refund the duplicate payment." },
    "questions": {
      "refund_requested": {
        "type": "noul",
        "instructions": "Does the customer explicitly request a refund?"
      }
    }
  }
}

تحقق من isError، ثم اقرأ structuredContent.answers و structuredContent.usage. إجابة Noul هي رقم احتمالي وليست قيمة منطقية (Boolean). احتفظ بمعرف الطلب من _meta عندما يكون متاحاً. تُرجع الأداة نتيجة متزامنة؛ ولا تستخدم تدفق الاستقصاء للمهام غير المتزامنة.

مع مهلة طلب الخادم الافتراضية البالغة 120,000 مللي ثانية، اسمح بما لا يقل عن 150,000 مللي ثانية لاستدعاء أداة العميل. إذا قمت بتغيير TOKENLAB_REQUEST_TIMEOUT_MS، فاحتفظ بمهلة العميل أطول. تجعل المهلة المنتهية النتيجة غير مؤكدة؛ افحص الطلب قبل إعادة إرسال مكالمة مدفوعة. تحقق من صحة القرارات مقارنة بحالاتك المصنفة الخاصة قبل استخدامها لتوجيه الإجراءات.

الوسائط غير المتزامنةCopy Anchor Link

تُرجع أدوات الفيديو والموسيقى والـ 3D مهمة بدلاً من ملف مكتمل. يمكن لأدوات الصور إرجاع نتيجة مكتملة أو مهمة، اعتماداً على النموذج.

عندما تتضمن النتيجة delivery غير متزامن، استدعِ get_task_status مع معرف المهمة الخاص به حتى تصبح الحالة مكتملة أو فاشلة. لا تقم بإنشاء مهمة ثانية لمجرد انتهاء مهلة فحص حالة واحدة.

إعدادات اختياريةCopy Anchor Link

استخدم الإعدادات الافتراضية ما لم يكن لدى عميلك أو عملية النشر متطلب محدد.

استكشاف الأخطاء وإصلاحهاCopy Anchor Link

مستكشف النماذج المستضافCopy Anchor Link

يمكن للعملاء الذين يدعمون Streamable HTTP استخدام مستكشف النماذج العام على:

https://tokenlab-model-explorer.vercel.app/mcp

استخدم خادم npm المحلي لمكالمات API المدفوعة، أو تحميل الملفات المحلية، أو ملفات التعريف core و full.

الروابطCopy Anchor Link

• صفحة TokenLab MCP
• مستودع GitHub
• مهارة TokenLab API
• دليل النماذج
• دليل البدء السريع لـ API

قم بتهيئة إشعارات المهام باستخدام Webhook management API، مع المصادقة باستخدام Management Token يبدأ بـ mt-…. يستخدم MCP full المتغير TOKENLAB_MANAGEMENT_TOKEN. أوقف استقصاء المهام المنتهية وعند حدوث أخطاء 401/403/404 أو أخطاء غير قابلة لإعادة المحاولة.