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

Cursor

قم بتهيئة TokenLab لنماذج محادثة Cursor المدعومة، وتحقق من الاتصال، وأضف MCP أو Skills بشكل منفصل

ما الذي يقوم به هذا الاتصال

استخدم TokenLab لطلبات المحادثة المدعومة في محرر سطح المكتب Cursor على أنظمة macOS أو Windows أو Linux. توثق Cursor دعم OpenAI BYOK لنماذج المحادثة القياسية التي لا تعتمد على الاستنتاج (non-reasoning)؛ بينما لا تزال ميزة الإكمال التلقائي (Tab completion) تستخدم نماذج Cursor الخاصة. لا يؤدي تجاوز عنوان URL الأساسي (Base URL) لـ OpenAI إلى تحويل Cursor إلى عميل لكل نموذج أو بروتوكول في TokenLab. راجع حدود مفتاح API الخاص بـ Cursor.

إذا كنت تحتاج فقط إلى أدوات الصور أو الفيديو أو أدوات API الأخرى من TokenLab، فاحتفظ بمزود المحادثة الحالي الخاص بك وأضف MCP بدلاً من ذلك. تقوم Skill بتعليم الوكيل كيفية استخدام واجهات برمجة التطبيقات (APIs)؛ وهي لا تغير مزود المحادثة.

امنح هذه المهمة لوكيلك

Read https://tokenlab.sh/docs/ar/integrations/cursor and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.

افتح الإعدادات الصحيحة

  1. قم بتثبيت أو تحديث محرر سطح المكتب من تنزيلات Cursor. لا يقوم هذا الدليل بتهيئة Cursor CLI أو وكلاء السحابة (Cloud Agents).
  2. افتح إعدادات Cursor من لوحة الأوامر، أو اضغط على Cmd/Ctrl + Shift + J. بينما يفتح Cmd/Ctrl + , إعدادات المحرر العامة بدلاً من ذلك.
  3. افتح Models ودوّن مفتاح OpenAI الحالي وتكوين Base URL الخاص بك حتى تتمكن من استعادته. حافظ على إعدادات المزودين الآخرين كما هي.
  4. في OpenAI API Key، أدخل مفتاح TokenLab الخاص بك محلياً واحفظه. لا تقم بلصق المفتاح في محادثة الوكيل أو إضافته (commit) إلى مشروع.
  5. قم بتفعيل Override OpenAI Base URL وأدخل:
https://api.tokenlab.sh/v1

ترسل Cursor طلبات BYOK من خلال نظامها الخلفي لتجميع المطالبات (prompt assembly)؛ هذا ليس اتصالاً مباشراً من المحرر الخاص بك إلى TokenLab.

اختر نموذجاً مدعوماً

انسخ معرف النموذج الدقيق من كتالوج TokenLab الحالي، وتحقق من أن Cursor تقبله من خلال مسار OpenAI BYOK الخاص بها. إن إدراج نموذج كنموذج محادثة على TokenLab لا يعني بالضرورة توافقه مع Cursor.

للتحقق الأولي من النص، اختر نموذجاً لا يعتمد على الاستنتاج (non-reasoning): تفاصيله لا تدرج قدرة reasoning، ويقبل openai_chat_completions. grok-4.20-non-reasoning هو أحد الأمثلة؛ تأكد من أنه لا يزال مدرجاً قبل استخدامه. قم بتفعيل الإدخال الموجود في Models، أو استخدم Add model إذا كان غائباً، ثم اختر ذلك النموذج بدقة في أداة اختيار المحادثة. لا تقم بتكرار نموذج مدمج تحت تهجئة مختلفة، ولا تفترض أن إدخالات Claude أو Gemini تستخدم تجاوز OpenAI. يشرح دليل النماذج المخصصة في Cursor حدود التوجيه هذه.

تحقق من طلب صغير واحد

ابدأ محادثة جديدة مع النموذج المختار وأرسل:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

هذا طلب نموذج قابل للفوترة. تحقق من الرد والنموذج المطابق والوقت والحالة في طلبات TokenLab. المفتاح المحفوظ، أو النموذج المرئي، أو الرد بدون طلب TokenLab مطابق لا يؤكد هذا المسار.

إذا فشل الاتصال

  • النموذج مفقود أو مرفوض: تحقق من المعرف الدقيق ودعم Cursor الحالي لـ BYOK. استخدم إدخالاً مدمجاً موجوداً عند توفره؛ إعادة التشغيل وحدها لا يمكنها جعل نموذج غير مدعوم متوافقاً.
  • فشل المصادقة: أعد إدخال مفتاح TokenLab في حقل OpenAI وتحقق من Base URL. خطأ الرصيد أو الحصة منفصل عن المفتاح غير الصالح؛ اتبع الخطأ المرتجع وطلب TokenLab المقابل.
  • لا يظهر طلب TokenLab: تأكد من النموذج المختار والتجاوز، ثم افحص خطأ Cursor. الإكمال التلقائي والميزات الأخرى التي تديرها Cursor ليست اختباراً للاتصال.
  • توقف مزود آخر عن العمل: استعد إعدادات OpenAI السابقة أو قم بتعطيل التجاوز، ثم ابدأ محادثة جديدة. تجنب تغيير مفاتيح المزودين غير ذات الصلة لإصلاح هذا المسار.

إنشاء الصور والفيديو في نفس الوكيل

يمكن لـ Cursor أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. لا يحل MCP محل نموذج المحادثة الرئيسي. احفظ هذا كـ ~/.cursor/mcp.json، أو ادمج إدخال tokenlab في ملفك الحالي:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
      }
    }
  }
}

استبدل <TOKENLAB_API_KEY> بمفتاحك على جهاز الكمبيوتر الخاص بك، ولا تقم بإضافة هذا الملف (commit). تأكد من تفعيل tokenlab في إعدادات MCP الخاصة بـ Cursor. ثم جرب:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

يعيد create_video معرف مهمة. يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً.

إضافة تعليمات API بشكل منفصل

توفر TokenLab Skills تعليمات API. بالنسبة للتثبيت المحلي للمشروع، احتفظ بدليل المهارة الكامل في .cursor/skills/tokenlab-api-integration/، بما في ذلك SKILL.md والملفات المشار إليها. تحقق من Customize → Skills للاكتشاف. لا توفر المهارات مفتاحاً أو تثبت خادم MCP. راجع أدلة MCP و Skills الرسمية لإصدار Cursor الخاص بك.

في هذه الصفحة