AI टूल कनेक्ट करें

AI टूल कनेक्ट करें

इस AppScreenshots डिप्लॉयमेंट पर MCP सक्रिय होने पर, कोई संगत AI टूल इससे कनेक्ट करें:

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 — एलिमेंट id से आंशिक संपादन; प्रकार बदलने की अनुमति नहीं
• remove_element — एलिमेंट हटाएँ
• set_background — एक फ्रेम की पृष्ठभूमि सेट करें; साझा पृष्ठभूमियाँ प्रति-फ्रेम स्थिर हो जाती हैं
• set_locales — 1–20 भाषाएँ और डिफ़ॉल्ट भाषा सेट करें
• set_canvas — कैनवास आकार (100–5000) और मोड (separate या continuous)

एलिमेंट में टाइपोग्राफी, डिवाइस मॉकअप फ़ील्ड, इमेज assetId संदर्भ, आकृतियाँ, आइकन, rotation और stackOrder होते हैं। इमेज केवल अधिकृत assetId से संदर्भित होती हैं — URL या लोकल पाथ से कभी नहीं; मौजूदा इमेज संदर्भ सर्वर पर सुरक्षित रहते हैं, इसलिए उन्हें वापस न भेजें।

हर लॉजिकल राइट के लिए नया आइडेम्पोटेंसी की इस्तेमाल करें; केवल हूबहू दोहराए रिट्राई में ही दोबारा इस्तेमाल करें। रिवीज़न संघर्ष के बाद नई रिवीज़न पढ़कर आगे बढ़ें। SQL, HTML या स्क्रिप्ट को संपादन निर्देश के रूप में कभी न दें।

त्रुटियाँ

त्रुटियाँ {code, message} JSON बॉडी और isError: true के साथ लौटती हैं:

अनुमति और सीमाएँ

सर्वर OAuth 2.1 + PKCE ब्राउज़र साइन-इन इस्तेमाल करता है:

• स्कोप: projects:read, projects:write (केवल तब जब आप बनाना/संपादित करना अनुमत करें), assets:read और offline_access।
• एक्सेस टोकन एक घंटे और रिफ्रेश टोकन 30 दिन तक वैध रहते हैं।
• एक्सेस टोकन को सक्रिय ग्रांट चाहिए: कनेक्शन रद्द करते ही मौजूदा टोकन तुरंत बंद हो जाते हैं।
• रेट लिमिट: फ्री प्लान पर प्रति मिनट 60, पेड प्लान पर प्रति मिनट 120 MCP कॉल। सीमा पार होने पर HTTP 429 और Retry-After: 60।
• रिक्वेस्ट बॉडी 2 MB तक; प्रोजेक्ट 20 फ्रेम और प्रति फ्रेम 100 एलिमेंट तक।

प्लान के एंटाइटलमेंट हमेशा की तरह लागू रहते हैं: प्रोजेक्ट, पेड टेम्पलेट, कस्टम फ़ॉन्ट और बैच-एक्सपोर्ट प्रतिबंध वही रहते हैं, और होस्टेड AI शुल्क नहीं है — डिज़ाइन और कॉपी जुड़े AI से आते हैं।

अपने स्क्रीनशॉट से शुरू करें

मूल स्क्रीनशॉट पहले वेबसाइट एडिटर में अपलोड करें। फिर वह प्रोजेक्ट ऑथराइज़ करें या सहमति पेज पर अलग-अलग एसेट चुनें। MCP बाइनरी अपलोड टूल नहीं देता; चैट में संलग्न फ़ाइल सेव के लिए अपने आप उपलब्ध नहीं होती।

यह प्रॉम्प्ट आज़माएँ:

जुड़ा AI डिज़ाइन और कॉपी देता है; MCP संपादन योग्य प्रोजेक्ट सहेजता है। get_project_preview इमेज बाइट्स नहीं, एडिटर लिंक और समीक्षा निर्देश लौटाता है। ब्राउज़र टूल वाला एजेंट एडिटर खोल सकता है, स्क्रीनशॉट जाँच सकता है, MCP से सुधार कर सकता है और नवीनतम संस्करण देखने के लिए सुरक्षित रूप से रीलोड कर सकता है। ब्राउज़र लॉगिन MCP OAuth से अलग है, और रीलोड से पहले बिना सेव किए बदलाव सुरक्षित रखने चाहिए। प्रीव्यू और एक्सपोर्ट उपयोगकर्ता वेबसाइट एडिटर में करता है।

एक्सेस प्रबंधन

Settings → Connected AI tools खोलकर चुने हुए प्रोजेक्ट/एसेट बदलें या कनेक्शन रद्द करें। टूल न चुने गए प्रोजेक्ट नहीं देख सकता। वेबसाइट और AI टूल एक ही प्रोजेक्ट एक साथ संपादित करें तो परस्पर विरोधी बदलाव सेव करने से पहले नवीनतम संस्करण दोबारा पढ़ें।

ब्राउज़र समीक्षा के लिए Browserless या बैकग्राउंड रेंडरिंग क्यू ज़रूरी नहीं। यह MCP प्रोजेक्ट टूल और ब्राउज़र समीक्षा मार्गदर्शन देता है, क्लाउड रेंडरिंग नहीं। ब्राउज़र/इमेज टूल न हों तो एजेंट को सत्यापन का दावा करने की बजाय एडिटर लिंक लौटाकर बताना चाहिए कि विज़ुअल समीक्षा लंबित है।

समस्या निवारण

क्लाइंट-विशिष्ट नोट्स और वर्तमान सत्यापन मैट्रिक्स के लिए कनेक्शन किट की समस्या निवारण गाइड देखें।