localize.dev

الوثائق / الوكلاء / Lovable

توطين تطبيق Lovable

قم بتوصيل Lovable بخادم localize.dev MCP المستضاف، وسيجد الوكيل الخاص به النص المكتوب بشكل ثابت في تطبيقك، ويعطيه مفاتيح، ويقوم بإعداد react-i18next وترجمته. تظل الترجمات في الكود الخاص بك كملفات محلية، بدون أي نص برمجي أو وكيل أمام الموقع.

كيف يعمل

يعمل Lovable في المتصفح، لذلك لا يمكنه بدء npx. يتصل بالخادم المستضاف على https://uselocalize.dev/api/mcp بدلاً من ذلك: يرسل الوكيل الملفات التي تحتاجها الأداة ويكتب الملفات التي تعيدها.

ينتمي الموصل إلى حساب Lovable الخاص بك، وليس التطبيق، لذلك لا يكون مفتاح API الخاص بك جزءًا من الموقع المنشور أبدًا. لا يستخدم check و config بدلًا خاصًا بك؛ يستخدم localize و translate و add_language ذلك.

إعدادها

قم أولاً بإنشاء مفتاح API في لوحة التحكم. إنشاء مفتاح

  1. في الموصلات، اختر إضافة مخصص، ثم خادم MCP، وأدخل عنوان URL.
  2. اختر رمز Bearer أو مفتاح API، الصق مفتاح localize.dev API الخاص بك وانقر فوق إضافة خادم.
  3. افتح مشروعك واطلب شيئًا مثل الموجه أدناه. يرسل الوكيل الملفات التي يحتاجها الأداة ويكتب الملفات التي يعيدها.
Connectors → Add custom → MCP server
Name            localize
URL             https://uselocalize.dev/api/mcp
Authentication  Bearer token or API key
Key             ldv_live_… (your localize.dev API key)

ما تحصل عليه

أين يذهب الخادم
Connectors → Add custom → MCP server
خادم
الخادم المستضاف على https://uselocalize.dev/api/mcp
مفتاح
مفتاح واجهة برمجة تطبيقات localize.dev الخاص بك، كرمز حامل
ما يضيفه init --agent
لا شيء: لا يمكن لبرنامج إنشاء المتصفح تشغيل npx، لذا فهو يتصل بالخادم المستضاف.

من الجيد معرفته

  • اطلب فحصًا أولاً. يسرد النص المضمن والترجمات المفقودة ملفًا تلو الآخر، حتى تتمكن من اختيار الصفحات لترجمتها.
  • إذا تمت مزامنة المشروع مع GitHub، يمكن لـ localize.dev GitHub Action أيضًا ترجمة كل دفعة وفتح طلب سحب واحد بالمفاتيح والترجمات.

جربه

اسأل شيئًا كهذا. يجب على الوكيل استدعاء أداة check.

“تحقق من هذا التطبيق بحثًا عن النص المضمن في الكود وأخبرني بما لم تتم ترجمته.”

احتفظ بها مترجمة

لا يزال النص الذي يتركه الوكيل ثابتًا يتم اكتشافه: يفشل npx localize-dev check في CI في طلب سحب يضيف نسخة غير مترجمة، ولا يحتاج إلى مفتاح.

npx localize-dev check

جميع الوكلاء ومرجع الأداة موجودون في صفحة خادم MCP.

أدلة الإطار