الانتقال إلى المحتوى الرئيسي
تتيح Krea خادم Model Context Protocol (MCP) مستضافًا للوكلاء ومساعدي البرمجة. استخدمه عندما تريد أن يستدعي عميل متوافق مع MCP خدمة Krea مباشرةً بدلًا من كتابة طلبات API يدويًا.
لست بحاجة إلى مفتاح API للاتصال. أضف https://api.krea.ai/mcp بوصفه عنوان خادم MCP، ثم سجّل الدخول باستخدام حساب Krea الخاص بك من خلال تدفق OAuth في عميلك.

​
تفاصيل الخادم

الإعدادالقيمة
النقلStreamable HTTP
العنوانhttps://api.krea.ai/mcp
المصادقةOAuth
تعتمد الفوترة على طريقة المصادقة:
طريقة المصادقةمصدر الفوترة
OAuthوحدات الحوسبة الخاصة بحساب Krea الذي سجلت الدخول إليه
رمز APIرصيد API المنفصل الخاص بمساحة عملك

​
المصادقة

تستخدم معظم عملاء MCP بروتوكول OAuth تلقائيًا. عندما يطلب منك العميل الاتصال، اتبع تدفق تسجيل الدخول في المتصفح وامنح الإذن لـ Krea. تُفوتر استخدامات OAuth على حساب Krea الذي سجلت الدخول إليه باستخدام وحدات الحوسبة. إذا كان عميل MCP الخاص بك لا يدعم OAuth، فيمكنك المصادقة باستخدام رمز API بدلًا من ذلك:
مفتاح الترويسةقيمة الترويسة
AuthorizationBearer KREA_API_TOKEN
استبدل KREA_API_TOKEN برمز من krea.ai/app/api/tokens. يستطيع مالكو مساحات العمل والمشرفون فقط إنشاء رموز API. تُفوتر استخدامات رمز API على رصيد API الخاص بمساحة عملك، تمامًا كما هو الحال مع استدعاءات API المباشرة. راجع مفاتيح API والفوترة للاطلاع على تفاصيل رصيد API.
خزّن بيانات اعتماد MCP المعتمدة على رمز API بالطريقة نفسها التي تخزّن بها مفاتيح API. لا تُودع ملفات إعداد MCP التي تحتوي على رموز حقيقية في نظام التحكم بالإصدارات.

​
Claude Code

شغّل هذا الأمر في الطرفية: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
سجّل الدخول بحساب Krea الخاص بك عندما يطلب منك Claude Code الاتصال. أعد تشغيل Claude Code أو أعد تحميل خوادم MCP بعد إضافة الخادم.

​
Codex

  1. افتح Settings > MCP servers في Codex.
  2. أضف خادمًا جديدًا.
  3. اختر Streamable HTTP بوصفه طريقة النقل.
  4. الصق عنوان الخادم:
https://api.krea.ai/mcp
  1. احفظ الخادم وسجّل الدخول بحساب Krea عندما يطلب منك Codex الاتصال.

​
Cursor

افتح لوحة الأوامر، وابحث عن Open MCP settings، ثم أضف هذا الإدخال إلى mcp.json: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
أعد تشغيل Cursor بعد حفظ الملف، ثم سجّل الدخول بحساب Krea عندما يطلب منك Cursor الاتصال.

​
استخدام Krea عبر MCP

بمجرد الاتصال، اطلب من وكيلك سرد نماذج Krea أو فحص مخطط نموذج قبل التوليد. تتطابق معرّفات النماذج مع مسارات API المستخدمة في بقية وثائق المطورين، مثل image/krea/krea-2/medium أو video/google/veo-3.1. على سبيل المثال: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
إذا كان النموذج موقوفًا، فإن Krea تُرجع بيانات وصفية للإيقاف من خلال اكتشاف نماذج MCP. راجع الإيقافات لإرشادات الترحيل.

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

المشكلةالحل
فشل المصادقةأعد الاتصال بخادم MCP وأكمل تدفق Krea OAuth في متصفحك. إذا كنت تستخدم رمز API، فتأكد من أن الترويسة هي بالضبط Authorization: Bearer KREA_API_TOKEN وأن الرمز لم يُلغَ.
العميل لا يستطيع الاتصالتأكد من أن العميل مهيأ لاستخدام Streamable HTTP ويستعمل https://api.krea.ai/mcp.
رُفض التوليد بسبب الفوترةإذا اتصلت عبر OAuth، فتحقق من وحدات الحوسبة في حساب Krea الذي سجلت الدخول إليه. إذا اتصلت برمز API، فأضف رصيدًا إلى API على krea.ai/app/api.
فشل استدعاء النموذجاطلب من وكيلك فحص مخطط النموذج قبل إعادة المحاولة. تستخدم طلبات MCP المدخلات نفسها للنموذج المستخدمة في API.

​
الخطوات التالية

مفاتيح API والفوترة

أنشئ رموز API وأدر رصيد API للطلبات المصادق عليها بالرموز.

بيئة تجريبية تفاعلية

جرّب الطلبات في تطبيق Krea قبل أن تطلب من وكيل تشغيلها.

الإيقافات

اطّلع على كيفية كشف MCP لبيانات ترحيل النماذج الوصفية.

واجهات برمجة النماذج

تصفّح مخططات نقاط النهاية ومعلمات النماذج.