أدوات البرمجة

خادم 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

tokenlab-skills على GitHub.

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

دع الوكيل الخاص بي يقوم بهذا الإعداد

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

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_BASEhttps://api.tokenlab.shمضيف API مخصص لـ TokenLab؛ احذف الشرطة المائلة في النهاية
TOKENLAB_MCP_TOOL_PROFILEcorecatalog أو core أو full
TOKENLAB_REQUEST_TIMEOUT_MS120000مهلة الطلب بالمللي ثانية
TOKENLAB_MCP_MAX_FILE_BYTES104857600الحد الأقصى لحجم التحميل المحلي لكل ملف
TOKENLAB_ARTIFACT_DIRدليل النظام المؤقتالمكان الذي يتم فيه حفظ الملفات الكبيرة التي تم تنزيلها

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

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

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

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

https://mcp.tokenlab.sh/mcp

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

روابط

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

في هذه الصفحة