خادم MCP من ToRun
آخر تحديث: 11 نوفمبر 2026
ما هو
يتيح خادم MCP من ToRun لوكيل البرمجة استخدام ToRun أثناء عمله على مشروعك. يستطيع وكيل يدعم خوادم MCP البعيدة، مثل Claude Code أو Cursor أو opencode، إنشاء الصور والكلام والموسيقى والفيديو، وتعديل الصور، وتفريغ الصوت إلى نص، وتشغيل البحث المعمّق وقوالب سير العمل في ToRun، ونشر صفحة HTML أو لعبة متصفح كرابط، دون أن تغادر محرّرك. ما يصنعه الوكيل يُدفع من حسابك في ToRun بالأسعار نفسها في التطبيق، ويُحفظ في حسابك على ToRun مثل أي شيء تصنعه في التطبيق.
العنوان وتسجيل الدخول
| عنوان الخادم | https://mcp.torun.ai/mcp |
| النقل | HTTP (خادم MCP بعيد) |
| تسجيل الدخول | Authorization: Bearer <your developer key> |
يبدأ مفتاح المطوّر بـ trn_live_. تنشئه من صفحة المطورين في حسابك على ToRun: راجع مفاتيح المطوّر. إعداد كل أداة:
الأدوات
| الأداة | ماذا تفعل | مدفوعة |
|---|---|---|
image_generate |
تنشئ صورًا من موجّه نصي: شخصيات ألعاب وأيقونات وخلفيات ورسومًا توضيحية. تعيد الصور، أو معرّف مهمة عندما تستغرق وقتًا أطول مما اختار الوكيل انتظاره. | نعم |
image_edit |
تغيّر صورة وفق تعليمات مكتوبة: خلفية جديدة، أو لون آخر، أو إضافة عنصر أو إزالته، أو نمط آخر. الصورة إما صورة صنعها الوكيل باستخدام ToRun، وإما رابط إلى ملف PNG أو JPEG أو WebP بحجم يصل إلى 20 ميغابايت؛ والصورة المقدَّمة برابط تُحفظ أولًا في مكتبتك على ToRun. تعيد الصور أو معرّف مهمة، مثل image_generate. |
نعم |
tts_generate |
تحوّل النص إلى كلام وتعيد الملف الصوتي ومدة تشغيله، مقيسة من الملف. | نعم |
stt_transcribe |
تحوّل الكلام في ملف صوتي أو ملف فيديو إلى نص، مع مقاطع موقّتة للترجمات المرئية عندما يطلبها الوكيل. تقبل ملفات mp3 وm4a وwav وwebm وogg وopus وflac وaac وmp4 بحجم يصل إلى 25 ميغابايت. | نعم |
music_generate |
تؤلّف مقطعًا موسيقيًا، بغناء أو بدونه، وتعيد معرّف مهمة. | نعم |
video_generate |
تنشئ مقطع فيديو قصيرًا من موجّه نصي وتعيد معرّف مهمة. | نعم |
job_status |
تُبلغ عن تقدّم مهمة صورة أو موسيقى أو فيديو وتعيد الملف عندما يجهز. | مجانية |
deep_research_start |
تبدأ بحثًا معمّقًا عن سؤال: تبحث في الويب عبر مصادر كثيرة وتكتب تقريرًا مع ذكر مصادره. تعيد معرّف مهمة. | نعم |
deep_research_status |
تُبلغ عن تقدّم البحث المعمّق وتعيد التقرير عندما يجهز. | مجانية |
workflow_template_search |
تعثر على قوالب سير العمل في ToRun، وهي مسارات جاهزة متعددة الخطوات، وتعرض ما يُخرجه كل قالب، وتكلفته المعتادة، والمدخلات التي يقبلها. | مجانية |
workflow_run |
تشغّل قالب سير عمل بالمدخلات التي يقدّمها الوكيل وتعيد معرّف مهمة. | نعم |
workflow_run_status |
تُبلغ عن تقدّم تشغيل سير العمل وعن عدد Runs التي كلّفها حتى الآن، وتعيد نتائجه عندما تجهز. | مجانية |
canvas_publish |
تنشر صفحة HTML من ملف واحد أو لعبة متصفح كرابط. | مجانية |
account_balance |
تعرض ما تبقّى من حصة الخطة ومن المحفظة، والحد الشهري لهذا المفتاح وما أنفقه. | مجانية |
رابط الملف الذي تعيده أداة يُنزَّل دون تسجيل الدخول، لذا يستطيع الوكيل حفظ الملف في مشروعك. احتفظ بالرابط كاملًا، بما في ذلك الجزء الذي يلي علامة الاستفهام.
الصفحة المنشورة غير مُدرجة: يستطيع أي شخص لديه الرابط فتحها، لكنها لا تظهر في قسم الاستكشاف في ToRun، ولا تفهرسها محركات البحث.
المهام الطويلة
تستغرق الموسيقى والفيديو والبحث المعمّق وتشغيلات سير العمل وقتًا أطول من استدعاء واحد. تعيد الأداة معرّف مهمة، ويسأل الوكيل مجددًا حتى تجهز النتيجة: job_status للصور والموسيقى والفيديو، وdeep_research_status لتقرير البحث، وworkflow_run_status لتشغيل سير العمل. والصورة التي لا تجهز خلال مدة الانتظار التي اختارها الوكيل تعود أيضًا كمعرّف مهمة.
يستغرق البحث من 1 إلى 10 دقائق ويستمر حتى لو انتهت المحادثة مع وكيلك؛ ويظهر التقرير أيضًا كمحادثة مستقلة في قائمة محادثاتك على ToRun. يستغرق تشغيل سير العمل من دقيقة إلى عشرات الدقائق، ويظهر التشغيل وملفاته في حسابك على ToRun. يصل التقرير الطويل أو مجموعة النتائج الطويلة على أجزاء، ويطلب الوكيل الباقي.
كيف تُدفع الاستدعاءات
- يُحتسب كل استدعاء مدفوع بوحدات Runs بالأسعار نفسها في التطبيق.
- يُدفع أولًا من حصة خطتك، ثم من محفظتك إذا سمحت بذلك في المفتاح.
- الحصة المجانية لا تدفع أبدًا ثمن استدعاءات API.
- يُحتسب تشغيل سير العمل خطوةً بخطوة أثناء تنفيذه.
- يظهر كل خصم في صفحة الفوترة تحت المفتاح الذي أجراه.
الاستدعاء الذي يتجاوز حدّ المفتاح يسأل أولًا
لكل مفتاح حدّ. عندما تكون تكلفة استدعاء واحد أعلى من ذلك، لا تنفّذه الأداة بعد. وفي تشغيل سير العمل، تُقارَن التكلفة التقديرية للتشغيل.
- إذا كانت أداتك قادرة على عرض نموذج عندما يطرح خادم MCP سؤالًا (MCP elicitation)، يسألك ToRun هناك: يعرض النموذج السعر ويسأل هل تريد المتابعة. يُنفَّذ الاستدعاء إذا وافقت؛ وإذا رفضت، لا يُشغَّل شيء.
- وإلا فتجيب الأداة بالسعر، ويعرضه عليك وكيلك، ولا يُنفَّذ الاستدعاء إلا عندما يكرّره الوكيل بعد موافقتك.
لا يُحتسب أي شيء مقابل السؤال.
الحدود
لكل مفتاح حد إنفاق شهري وآخر يومي، وحدّ لعدد الاستدعاءات في الدقيقة. ولكل حساب أيضًا حدّ يومي للصفحات المنشورة. تضبط الحد الشهري للمفتاح وحدّه عند إنشائه؛ والقيم الافتراضية مذكورة على torun.ai/developers. لتغييرها، أنشئ مفتاحًا جديدًا بالإعدادات التي تريدها وألغِ المفتاح القديم.
عندما يُرفض استدعاء
| ما يُقال للوكيل | ما الذي تفعله |
|---|---|
| يحتاج الاستدعاء إلى مفتاح مطوّر | تحقّق من أن TORUN_API_KEY يحتوي على المفتاح كاملًا، وأن المفتاح لم يُلغَ. |
| نفدت حصة الخطة ولا يُسمح للمفتاح بالإنفاق من المحفظة | انتظر تجدّد الحصة، أو أنشئ مفتاحًا يُسمح له بالإنفاق من المحفظة. |
| مفاتيح المطوّر تنفق فقط من حصة خطة مدفوعة أو من المحفظة | اشحن رصيدك أو اشترك. |
| بلغ المفتاح حد الإنفاق الشهري أو اليومي | انتظر اليوم أو الشهر التالي، أو أنشئ مفتاحًا بحدّ أعلى. |
| أجرى المفتاح استدعاءات كثيرة جدًا في دقيقة | انتظر قليلًا ثم حاول مرة أخرى. |
| لا يملك المفتاح النطاق الذي تحتاجه الأداة | لا يمكن تغيير نطاقات المفتاح. أنشئ مفتاحًا جديدًا: المفتاح الجديد يحمل كل النطاقات. |
| يجب تحديد الملف بمعرّف من مكتبة ToRun أو برابط https، وليس بكليهما | حدّد واحدًا منهما فقط. |
| لا يوجد ملف كهذا في مكتبة ToRun الخاصة بالحساب | استخدم ملفًا من هذا الحساب. ويُرفض بالطريقة نفسها رابط ToRun إلى ملف يخص حسابًا آخر. |
| الملف كبير جدًا، أو ليس بتنسيق تقبله الأداة، أو تعذّر تنزيله | الصور لـ image_edit: PNG أو JPEG أو WebP، حتى 20 ميغابايت. الملفات لـ stt_transcribe: mp3 أو m4a أو wav أو webm أو ogg أو opus أو flac أو aac أو mp4، حتى 25 ميغابايت. يجب أن يُنزَّل الرابط دون تسجيل الدخول. |