أدوات البرمجة
خادم TokenLab MCP
امنح Claude Code و Cursor و VS Code و Codex وعملاء MCP الآخرين إمكانية الوصول إلى نماذج وواجهات برمجة تطبيقات TokenLab
اختر ما يحتاجه الوكيل (Agent) الخاص بك
- يضيف MCP أدوات واجهة برمجة تطبيقات TokenLab إلى عميل متوافق. ابدأ بإعداد
catalogالخالي من المفاتيح أدناه. - تُعلم TokenLab Agent Skills الوكيل بالطريقة الصحيحة للحصول على النتيجة، مثل النموذج الذي يجب اختياره وكيفية التحقق من المخرجات. لا تقوم هذه المهارات بتشغيل خادم MCP، ولكن يمكنها استخدام أدوات MCP هذه عند تثبيت كليهما.
تثبيت مهارة اختيار النموذج (model picker skill): npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker
كلاهما يوسع قدرات الوكيل الحالي. تغيير مزود النموذج الرئيسي الخاص به يستخدم دليل الإعداد الخاص بذلك العميل.
دع الوكيل الخاص بي يقوم بهذا الإعداد
انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:
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 بتصفح النماذج والأسعار الحالية، وإرسال طلبات النماذج، وإنشاء الوسائط، والعمل مع الملفات، والتحقق من المهام غير المتزامنة (async tasks).
استخدم ملف تعريف catalog لتصفح النماذج والأسعار بدون مفتاح API. أضف TOKENLAB_API_KEY عندما يحتاج العميل إلى إجراء طلبات نماذج مدفوعة أو طلبات وسائط.
احتفظ بمفتاح API الخاص بـ TokenLab في بيئة خادم MCP. لا تقم أبداً بلصقه في مطالبة (prompt) أو وسيط أداة (tool argument).
المتطلبات
قم بتثبيت Node.js 18.17 أو أحدث وتأكد من توفر npx:
node --version
npx --versionتعمل حزمة npm محلياً عبر stdio. لا تحتاج إلى تثبيت عالمي أو تنزيل للمصدر.
اختر ما يمكن للعميل استخدامه
| ملف التعريف | مفتاح API | يتضمن |
|---|---|---|
catalog | غير مطلوب | قائمة النماذج، تفاصيل النماذج، الأسعار، المقارنات، ونظرة عامة على API |
core | مطلوب للطلبات المدفوعة | أدوات الدردشة الشائعة، واتخاذ القرار، والوسائط، والصوت، والملفات، والمهام، والتضمين (embedding)، وإعادة الترتيب (rerank)، والترجمة |
full | مطلوب للطلبات المدفوعة | core بالإضافة إلى واجهات برمجة تطبيقات إضافية للمطورين |
ابدأ بـ catalog إذا كنت تريد فقط اختياراً أفضل للنماذج. استخدم core عندما يحتاج العميل إلى إنشاء محتوى أو استدعاء نموذج. full مخصص للعملاء الذين يحتاجون حقاً إلى مجموعة أدوات أكبر.
إضافة الخادم
قم بعمل نسخة احتياطية من التكوين النشط. أضف إدخال TokenLab فقط وحافظ على المزودين والحسابات واختيار النموذج الافتراضي والأذونات الموجودة. إذا كان الاسم مستخدماً بالفعل، فاختر اسماً آخر وقم بتحديث الأوامر. للتراجع عن الإعداد، قم بإزالة الإدخال الذي أضفته فقط أو استعد النسخة الاحتياطية السابقة.
أضف الكتالوج العام لحساب المستخدم الخاص بك:
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=catalog \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48لاستخدام الأدوات المدفوعة، استبدل متغير بيئة ملف التعريف بـ TOKENLAB_API_KEY وقم بتخزين المفتاح من خلال طريقة إدارة الأسرار المعتادة لديك. استخدم --scope local لمشروع واحد. لا تقم أبداً برفع مفتاح حقيقي في ملف .mcp.json مشترك.
تفعيل الأدوات المدفوعة
أنشئ مفتاح API في Console → API keys، ثم قم بتعيين كلا المتغيرين في بيئة خادم MCP:
{
"env": {
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
"TOKENLAB_MCP_TOOL_PROFILE": "core"
}
}استخدم مدخلات الأسرار الخاصة بعميلك إذا كانت متوفرة. إذا ظهر مفتاح حقيقي في ملف مشترك، أو لقطة شاشة، أو سجل، أو سجل أوامر (shell history)، فقم بإلغائه وإنشاء مفتاح جديد.
التحقق من الاتصال
أعد تشغيل عميل MCP، ووافق على الخادم المحلي إذا طُلب منك ذلك، وتأكد من اتصال tokenlab.
# Claude Code
claude mcp list
# Codex
codex mcp listاطلب من العميل استدعاء list_models. تؤكد القائمة غير الفارغة أن الحزمة بدأت ووصلت إلى TokenLab. لا يحتاج ملف تعريف catalog إلى مفتاح API.
أدوات مفيدة
يعتمد توفر الأدوات على ملف التعريف المحدد. تشمل المهام الشائعة ما يلي:
- سرد النماذج وقراءة قدرات نموذج واحد
- قراءة أسعار TokenLab الحالية أو مقارنة عدة نماذج
- إرسال طلبات إكمال الدردشة (Chat Completions)، أو الردود، أو رسائل Anthropic، أو طلبات Gemini
- تقييم القرارات المكتوبة باستخدام
evaluate_decisions - إنشاء أو تعديل الصور
- إنشاء الفيديو، أو الموسيقى، أو ثلاثي الأبعاد (3D)، أو الكلام، أو النسخ، أو الترجمة
- تحميل واسترجاع الملفات
- إنشاء التضمينات (embeddings) أو إعادة ترتيب المستندات
- التحقق من المهام غير المتزامنة المدعومة وإلغاؤها
يجب أن يطلب العميل الموافقة قبل إجراء طلب مدفوع إذا لم يتم تأكيد السعر أو اختيار النموذج مسبقاً.
تستخدم أدوات ملفات MCP واجهة برمجة تطبيقات /v1/files المتوافقة مع OpenAI. تتطلب ملفات Gemini، وعمليات التحميل القابلة للاستئناف، و cachedContents حالياً طلبات HTTP وهي غير مضمنة في ملفات تعريف MCP. راجع Gemini Files and cache.
نماذج القرار
استخدم 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، فاجعل مهلة العميل أطول. المهلة تجعل النتيجة غير مؤكدة؛ افحص الطلب قبل إعادة إرسال طلب مدفوع. تحقق من صحة القرارات مقابل حالاتك المصنفة قبل استخدامها لتوجيه الإجراءات.
الوسائط غير المتزامنة
تُرجع أدوات الفيديو والموسيقى والثلاثي الأبعاد مهمة بدلاً من ملف نهائي. يمكن لأدوات الصور إرجاع نتيجة مكتملة أو مهمة، اعتماداً على النموذج.
عندما تتضمن النتيجة delivery غير متزامن، استدعِ get_task_status مع معرف المهمة الخاص بها حتى تكتمل الحالة أو تفشل. لا تنشئ مهمة ثانية لأن فحص حالة واحدة قد انتهت مهلته.
إعدادات اختيارية
| المتغير | الافتراضي | الاستخدام |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | مضيف API مخصص لـ TokenLab؛ احذف الشرطة المائلة في النهاية |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog أو core أو full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | مهلة الطلب بالمللي ثانية |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | الحد الأقصى لحجم التحميل المحلي لكل ملف |
TOKENLAB_ARTIFACT_DIR | دليل النظام المؤقت | المكان الذي يتم فيه حفظ الملفات الكبيرة التي تم تنزيلها |
استخدم القيم الافتراضية ما لم يكن لدى عميلك أو بيئة النشر الخاصة بك متطلبات محددة.
استكشاف الأخطاء وإصلاحها
مستكشف النماذج المستضاف
يمكن للعملاء الذين يدعمون Streamable HTTP استخدام مستكشف النماذج العام على:
https://mcp.tokenlab.sh/mcpاستخدم خادم npm المحلي لطلبات API المدفوعة، أو تحميلات الملفات المحلية، أو ملفات تعريف core و full.
روابط
- صفحة TokenLab MCP
- إنشاء صور وفيديو من Claude Code أو OpenClaw
- مستودع GitHub
- TokenLab Agent Skills
- كتالوج النماذج
- البدء السريع لـ API
قم بتكوين إشعارات المهام باستخدام واجهة برمجة تطبيقات إدارة Webhook، والمصادقة باستخدام رمز إدارة mt-…. يستخدم MCP full متغير TOKENLAB_MANAGEMENT_TOKEN. توقف عن استطلاع مهام الجهاز عند حدوث أخطاء 401/403/404 أو أخطاء لا يمكن إعادة المحاولة فيها.