توصيل أداة ذكاء اصطناعي

توصيل أداة ذكاء اصطناعي

عند تمكين MCP في نشر AppScreenshots هذا، صل أداة متوافقة إلى:

https://appscreenshots.net/api/mcp

اختر HTTP / Streamable HTTP وOAuth. سجّل الدخول بحساب AppScreenshots في المتصفح، وحدد المشاريع والأصول التي يمكن للأداة استخدامها، وقرر ما إذا كان يُسمح لها بإنشاء مشاريع. لا حاجة إلى وصول لقاعدة البيانات ولا مفتاح API.

وصّل عميلك

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

claude mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

codex mcp add appscreenshots --url https://appscreenshots.net/api/mcp
codex mcp login appscreenshots

gemini mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

{
  "mcpServers": {
    "appscreenshots": {
      "url": "https://appscreenshots.net/api/mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "appscreenshots": {
        "type": "http",
        "url": "https://appscreenshots.net/api/mcp",
        "oauth": {
          "type": "authorization_code",
          "scope": "projects:read projects:write assets:read offline_access"
        }
      }
    }
  }
}

حزمة الاتصال

يوفر المستودع العام appscreenshots-mcp ملفات إعدادات جاهزة لكل العملاء أعلاه، وSkill اختياريًا للوكيل يشرح مسار عمل اللقطات، وأمر doctor يفحص الخادم من طرفيتك:

git clone https://github.com/horace68/appscreenshots-mcp.git
node bin/appscreenshots.mjs config claude    # يطبع مقتطف إعدادات للعميل
node bin/appscreenshots.mjs install-skill claude
node bin/appscreenshots.mjs doctor

هذا المساعد يطبع الإعدادات ويثبّت Skill فقط. هو ليس خادم stdio محلي — استخدم ميزة الاتصال البعيد الأصلية في عميلك.

الأدوات

الأدوات التسع التالية متاحة عبر Streamable HTTP. قد يضيف العملاء بادئات للأسماء. الخادم المستضاف هو المرجع لمخططات المدخلات وصلاحيات الحساب.

عمليات التحرير

يقبل update_project قائمة عمليات قابلة للتمييز:

• set_name — إعادة تسمية المشروع
• add_frame / remove_frame / reorder_frames — إدارة الإطارات
• upsert_element — إدراج عنصر أو استبداله؛ يتطلب هندسة كاملة ويحفظ الحقول المحذوفة للنوع نفسه
• patch_element — تعديل جزئي بمعرّف العنصر؛ لا يجوز تغيير نوع العنصر
• remove_element — حذف عنصر
• set_background — ضبط خلفية إطار واحد؛ الخلفيات المشتركة تثبّت لكل إطار
• set_locales — ضبط 1–20 لغة واللغة الافتراضية
• set_canvas — حجم اللوحة (100–5000) والوضع (separate أو continuous)

تحمل العناصر التنسيق، وحقول معاينات الأجهزة، ومراجع assetId للصور، والأشكال، والأيقونات، وrotation وstackOrder. تُشار إلى الصور بـ assetId مصرّح به فقط — لا بأي حالة برابط أو مسار محلي، والمراجع القائمة يحتفظ بها الخادم فلا تعدها.

استخدم مفتاح تكرار آمن جديدًا لكل عملية كتابة منطقية؛ ولا تعده إلا في إعادة محاولة مطابقة تمامًا. بعد تعارض الإصدارات اقرأ أحدث نسخة ثم تابع. لا تستخدم SQL أو HTML أو نصوصًا برمجية كتعليمات تحرير أبدًا.

الأخطاء

تُرجع الأخطاء نص JSON بصيغة {code, message} مع isError: true:

الترخيص والحدود

يستخدم الخادم OAuth 2.1 مع PKCE وتسجيل دخول عبر المتصفح:

• النطاقات: projects:read، وprojects:write (فقط إذا سمحت بالإنشاء أو التحرير)، وassets:read، وoffline_access.
• رموز الوصول صالحة لمدة ساعة واحدة، ورموز التحديث صالحة لمدة 30 يومًا.
• تتطلب رموز الوصول ترخيصًا ساريًا: إذا ألغيت الاتصال تتوقف الرموز القائمة فورًا.
• حدود الاستخدام: 60 استدعاء MCP في الدقيقة على الخطة المجانية و120 في الدقيقة على المدفوعة. التجاوز يعيد HTTP 429 مع Retry-After: 60.
• حجم الطلب حتى 2 ميغابايت؛ المشروع حتى 20 إطارًا و100 عنصر لكل إطار.

صلاحيات خطتك تسري كالمعتاد: قيود المشاريع والقوالب المدفوعة والخطوط المخصصة والتصدير الدفعي كما هي، ولا رسوم ذكاء اصطناعي مستضاف — التصميم والنصوص من الذكاء الاصطناعي المتصل.

ابدأ بلقطاتك

ارفع اللقطات الأصلية في محرر الموقع أولًا، ثم صرّح بذلك المشروع أو حدد أصولًا فردية في صفحة الموافقة. لا يوفر MCP أدوات رفع ثنائية؛ والملف المرفق في محادثة لا يصبح متاحًا للخدمة تلقائيًا.

جرّب هذه المطالبة:

الذكاء الاصطناعي المتصل يقدم التصميم والنصوص؛ وMCP يحفظ مشاريع قابلة للتحرير. يعيد get_project_preview رابط المحرر وإرشادات المراجعة، لا بايتات صورة. يستطيع الوكيل المزود بأدوات متصفح فتح المحرر وفحص اللقطات وتصحيح التصميم عبر MCP ثم إعادة التحميل بأمان لمراجعة أحدث نسخة. تسجيل دخول المتصفح منفصل عن OAuth الخاص بـ MCP، وينبغي حفظ التعديلات غير المحفوظة قبل إعادة التحميل. المعاينة والتصدير يتمان في محرر الموقع.

إدارة الوصول

افتح Settings → Connected AI tools لتغيير المشاريع/الأصول المحددة أو إلغاء اتصال. لا تستطيع الأداة الوصول إلى المشاريع غير المحددة. إذا عدّل الموقع وأداة ذكاء اصطناعي المشروع نفسه في وقت واحد، فأعد قراءة أحدث نسخة قبل حفظ تعديلات متعارضة.

لا تتطلب مراجعة المتصفح Browserless ولا طابور عرض في الخلفية. يوفر MCP أدوات المشاريع وإرشاد المراجعة بالمتصفح، لا عرضًا سحابيًا. وبدون أدوات متصفح/صور، ينبغي للوكيل إرجاع رابط المحرر والإفصاح بأن المراجعة البصرية معلقة، لا ادعاء التحقق.

استكشاف الأخطاء

لملاحظات خاصة بكل عميل ومصفوفة التحقق الحالية، راجع دليل استكشاف الأخطاء لحزمة الاتصال.