निर्देश: MCP के ज़रिए Spy.House को इंटीग्रेट करना

यह गाइड मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) के माध्यम से AI क्लाइंट्स और डेवलपमेंट एनवायरनमेंट (IDEs) के साथ विज्ञापन क्रिएटिव एनालिटिक्स सर्विस Spy.House के इंटीग्रेशन को सेट अप और उपयोग करने के लिए समर्पित है।

इस सामग्री में कनेक्शन के लिए पूर्व-आवश्यकताओं (एक सक्रिय सशुल्क सदस्यता की उपस्थिति और API कुंजियों का उपयोग किए बिना OAuth-ऑथराइजेशन), सेटअप शुरू करने के 3-चरणीय मूल एल्गोरिदम, और विशिष्ट अनुप्रयोगों को कॉन्फ़िगर करने के लिए चरण-दर-चरण निर्देशों का विस्तार से वर्णन किया गया है: Claude (Desktop, Web, Code), Codex, Cursor, VS Code और ChatGPT।

कनेक्ट करने से पहले महत्वपूर्ण जानकारी

• कनेक्टर URL (Connector URL): [https://spy.house/mcp]। इस URL को आपके MCP क्लाइंट में दर्ज करना आवश्यक है।

• आवश्यकताएं: एक सक्रिय सशुल्क सदस्यता (paid subscription) की आवश्यकता है। ट्रायल (trial) संस्करण को कनेक्ट नहीं किया जा सकता है।

• ऑथराइजेशन: OAuth के माध्यम से किया जाता है - आपका क्लाइंट एक ब्राउज़र खोलता है, और आप अपने Spy.House खाते से साइन इन करते हैं। किसी API कुंजी (API key) की आवश्यकता नहीं है।

कनेक्ट करने के 3 चरण

1. सर्वर जोड़ें (Add the server): अपने MCP क्लाइंट को कनेक्टर URL की ओर निर्देशित करें - यह कॉन्फ़िगरेशन की एक पंक्ति या एक कमांड है (नीचे देखें)।

2. Spy.House के साथ साइन इन करें (Sign in with Spy.House): आपका क्लाइंट OAuth ऑथराइजेशन के लिए एक ब्राउज़र खोलेगा।

3. अपने एजेंट से पूछें (Ask your agent): एक अनुरोध लिखें, उदाहरण के लिए: "Find up to 12 Black Friday FB creatives for the USA"। एजेंट आवश्यक टूल को कॉल करेगा और उत्तर देगा।

विशिष्ट क्लाइंट्स के लिए सेटअप

CLI क्लाइंट्स (Claude Code, Codex) के लिए टिप्पणी: सर्वर जोड़ने के बाद, क्लाइंट को पुनरारंभ (restart) करना आवश्यक है, क्योंकि चालू सत्र इसे लोड नहीं करेगा। इसके बाद साइन इन करें: Claude Code के लिए /mcp कमांड का उपयोग करें, और Codex के लिए codex mcp login spy-house कमांड का उपयोग करें (नीचे दिए गए ब्लॉक से)।

1. Claude

डेस्कटॉप और वेब संस्करण नीचे दिए गए Client ID का उपयोग करते हैं। Claude Code अपने स्वयं के Client ID के साथ CLI कमांड का उपयोग करता है।

Desktop / Web:

1. Settings (सेटिंग्स) → Connectors (कनेक्टर्स) → Add custom connector (कस्टम कनेक्टर जोड़ें) पर जाएं।

2. Endpoint URL दर्ज करें।

3. Connect & authorize (कनेक्ट और ऑथराइज़ करें) पर क्लिक करें।

Claude Code (CLI): निम्नलिखित कमांड चलाएं:

claude mcp add --transport http --client-id spy-mcp-claude-code \
--callback-port 8787 spy-house https://spy.house/mcp

Desktop/Web के लिए Client ID: spy-mcp-claude-desktop

2. Codex

एक ही कमांड का उपयोग करके रिमोट सर्वर जोड़ें, फिर सिस्टम में लॉगिन करें:

codex mcp add spy-house --url https://spy.house/mcp \
--oauth-client-id spy-mcp-codex

codex mcp login spy-house

Client ID: spy-mcp-codex

3. Cursor

नीचे दी गई कमांड चलाएं या सर्वर को ~/.cursor/mcp.json या .cursor/mcp.json फ़ाइल में जोड़ें:

cursor --add-mcp '{"name":"spy-house","url":"https://spy.house/mcp","auth":{"CLIENT_ID":"spy-mcp-cursor","scopes":["mcp:search"]}}'

Client ID: spy-mcp-cursor

4. VS Code

नीचे दी गई कमांड चलाएं या सर्वर को उपयोगकर्ता के mcp.json या वर्कस्पेस के mcp.json में जोड़ें:

code --add-mcp '{"name":"spy-house","type":"http","url":"https://spy.house/mcp","oauth":{"clientId":"spy-mcp-vscode"}}'

Client ID: spy-mcp-vscode

5. Claude Web

1. Claude → Customize → Connectors → Add custom connector खोलें।

2. विवरण दर्ज करें: Name — Spy.House, URL - [https://spy.house/mcp]

3. Advanced OAuth settings में Client ID spy-mcp-claude-desktop दर्ज करें; Client Secret को खाली छोड़ दें।

4. Add / Connect पर क्लिक करें।

6. ChatGPT

1. ChatGPT web में Settings → Security and login → Developer mode चालू करें।

2. Plugins में रिमोट ऐप (remote MCP app) जोड़ें: URL [https://spy.house/mcp], Client ID spy-mcp-chatgpt, Streamable HTTP, बिना Client Secret (no Client Secret)।

3. Connect / Authenticate पर क्लिक करें, Spy.House में लॉगिन करें और एक्सेस की पुष्टि करें। API-कुंजी और Client Secret की आवश्यकता नहीं है।

4. यह अनुरोध चलाएं: Find up to 12 Black Friday FB creatives for the US.

अनुरोध द्वारा सत्यापन (Verification by request)

कनेक्शन के बाद, अपने क्लाइंट में निम्नलिखित अनुरोध चलाएं। अपेक्षित परिणाम एक चेकलिस्ट हैं, न कि लाइव खोज।

• search_creatives

  • सत्यापन के लिए अनुरोध: Find up to 12 Black Friday Facebook ad creatives for the US.

  • अपेक्षित परिणाम: डेटा और शेष खोज कोटा सहित 12 क्रिएटिव तक। प्रति कॉल एक नेटवर्क: push, inpage, facebook, tiktok या native। प्रत्येक गैर-रिक्त खोज कोटा की एक इकाई का उपभोग करती है।

• get_filter_options

  • सत्यापन के लिए अनुरोध: List the available Facebook search filters.

  • अपेक्षित परिणाम: बिना वयस्क सामग्री (non-adult) के Facebook फ़िल्टर की कैटलॉग और search_creatives के लिए सटीक मान। वयस्क फ़िल्टर छिपे हुए हैं।

• get_creative_media

  • सत्यापन के लिए अनुरोध: Show me the images of the creatives you just found.

  • अपेक्षित परिणाम: इस खोज के अधिकतम 3 creative_ref का मीडिया। खोज कोटा से कोई कटौती नहीं की जाती है। पूरा वीडियो वापस नहीं आता है, और चैट एम्बेडेड पूर्वावलोकन (embedded preview) प्रदर्शित नहीं कर सकता है।

• render_creatives_gallery

  • सत्यापन के लिए अनुरोध: Show these creatives as a gallery.

  • अपेक्षित परिणाम: MCP ऐप्स का समर्थन करने वाले क्लाइंट्स में उसी खोज के 1–12 creative_ref की एक एम्बेडेड गैलरी। अन्य क्लाइंट इस टूल को छोड़ देते हैं और टेक्स्ट या get_creative_media का उपयोग करते हैं।

अक्सर पूछे जाने वाले प्रश्न (FAQ)

AI क्लाइंट से Spy.House को कैसे डिस्कनेक्ट करें?

AI क्लाइंट में Spy.House सर्वर को हटाएं या अक्षम (disable) करें। सशुल्क सदस्यता समाप्त होने पर भी पहुंच समाप्त हो जाती है। ट्रायल खाते कनेक्ट नहीं हो सकते।

सहायता टीम (Support) से कैसे संपर्क करें?

• Email: [email protected]

• Telegram: https://telegram.me/Spy_House

• सहायता का समय: सोमवार–शुक्रवार, 10:00–18:00 (UTC+3)

त्रुटि के मामले में, कृपया निम्नलिखित विवरण भेजें: AI क्लाइंट का नाम, समय, त्रुटि का टेक्स्ट और स्क्रीनशॉट।

MCP प्रोटोकॉल के माध्यम से Spy.House का इंटीग्रेशन लोकप्रिय AI सहायकों और डेवलपमेंट एनवायरनमेंट को प्रतिस्पर्धी खुफिया (competitive intelligence) के एक प्रभावी टूल में बदल देता है। सीमलेस OAuth-ऑथराइजेशन और एकल कनेक्टर के कारण, उपयोगकर्ता सीधे अपने परिचित क्लाइंट इंटरफ़ेस से विज्ञापन क्रिएटिव खोजने, उपलब्ध फ़िल्टर का विश्लेषण करने और मीडिया फ़ाइलों को देखने की क्षमता प्राप्त करते हैं, जिससे खोज प्रक्रिया सरल प्राकृतिक भाषा के अनुरोधों तक सीमित हो जाती है।