ہدایات: MCP کے ذریعے Spy.House کو مربوط کرنا

یہ رہنما ہدایت نامہ Model Context Protocol (MCP) کے ذریعے AI کلائنٹس اور ڈویلپمنٹ انوائرمنٹس (IDEs) کے ساتھ اشتہاری تخلیقات (ad creatives) کی تجزیاتی سروس Spy.House کے انضمام (integration) کی ترتیب اور استعمال سے متعلق ہے۔

اس مواد میں کنکشن کے بنیادی تقاضوں (فعال پیڈ سبسکرپشن اور API کیز کے بغیر OAuth کی توثیق)، کنکشن شروع کرنے کے ۳ بنیادی مراحل، نیز مخصوص ایپلی کیشنز: Claude (Desktop, Web, Code)، Codex، Cursor، VS Code اور ChatGPT کو کنفیگر کرنے کے لیے مرحلہ وار ہدایات کی تفصیلی وضاحت کی گئی ہے۔

کنکشن سے پہلے اہم معلومات

• کنیکٹر URL (Connector URL): [https://spy.house/mcp]۔ یہ URL آپ کو اپنے MCP کلائنٹ میں درج کرنا ہوگا۔

• تقاضے: ایک فعال پیڈ (Paid) سبسکرپشن درکار ہے۔ آزمائشی ورژن (Trial) کنیکٹ نہیں کیا جا سکتا۔

• توثیق (Authorization): یہ OAuth کے ذریعے ہوتی ہے — آپ کا کلائنٹ براؤزر کھولے گا اور آپ اپنے Spy.House اکاؤنٹ سے سائن ان کریں گے۔ کسی API کی (API Key) کی ضرورت نہیں ہے۔

کنکشن کے ۳ مراحل

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

نیچے دی گئی کمانڈ چلائیں یا سرور کو صارف کی (user) mcp.json یا ورک اسپیس کی (workspace) 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 فعال (enable) کریں۔

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 key اور Client Secret درکار نہیں ہیں۔

4. یہ درخواست (prompt) درج کریں: > Find up to 12 Black Friday FB creatives for the US.

درخواست کے ذریعے تصدیق (Verification by request)

کنکشن کے بعد، اپنے کلائنٹ میں یہ درخواستیں (prompts) چلائیں۔ متوقع نتائج ایک چیک لسٹ ہیں، براہِ راست (live) تلاش نہیں۔

search_creatives

• تصدیق کے لیے پرامپٹ: Find up to 12 Black Friday Facebook ad creatives for the US.

• متوقع نتیجہ: ۱۲ تک تخلیقات (creatives)، بشمول ڈیٹا اور تلاش کے لیے باقی ماندہ کوٹہ (quota)۔ فی کال ایک نیٹ ورک: push, inpage, facebook, tiktok یا native۔ ہر غیر خالی (non-empty) تلاش پر کوٹہ کا ایک یونٹ استعمال ہوتا ہے۔

get_filter_options

• تصدیق کے لیے پرامپٹ: List the available Facebook search filters.

• متوقع نتیجہ: فیس بک کے فلٹرز کا کیٹلاگ (بغیر بالغوں والے مواد / non-adult کے) اور search_creatives کے لیے درست اقدار۔ بالغوں کے لیے فلٹرز مخفی (hidden) ہیں۔

get_creative_media

• تصدیق کے لیے پرامپٹ: Show me the images of the creatives you just found.

• متوقع نتیجہ: اسی سرچ سے تین creative_ref تک کی میڈیا فائلز۔ سرچ کا کوٹہ نہیں کاٹا جاتا۔ مکمل ویڈیو نہیں بھیجی جاتی، اور ہو سکتا ہے چاٹ ایمبیڈڈ پریویو (embedded preview) نہ دکھائے۔

render_creatives_gallery

• تصدیق کے لیے پرامپٹ: Show these creatives as a gallery.

• متوقع نتیجہ: MCP Apps کو سپورٹ کرنے والے کلائنٹس میں اسی تلاش سے ۱ تا ۱۲ creative_ref کی ایمبیڈڈ گیلری۔ باقی کلائنٹس اس ٹول کو نظر انداز کر دیتے ہیں اور ٹیکسٹ یا get_creative_media کا استعمال کرتے ہیں۔

اکثر پوچھے گئے سوالات (FAQ)

AI کلائنٹ سے Spy.House 

کو کیسے منقطع کریں؟AI کلائنٹ میں Spy.House سرور کو منقطع یا حذف (delete) کر دیں۔ پیڈ سبسکرپشن ختم ہونے پر بھی رسائی بند ہو جاتی ہے۔ آزمائشی (trial) اکاؤنٹس کنیکٹ نہیں ہو سکتے۔

سپورٹ ٹیم سے کیسے رابطہ کریں؟

• Email: [email protected]

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

• سپورٹ کے اوقاتِ کار: پیر تا جمعہ، 10:00 تا 18:00 (UTC+3)

کسی خرابی (error) کی صورت میں، برائے مہربانی ارسال کریں: AI کلائنٹ کا نام، وقت، خرابی کا متن (error text) اور اسکرین شاٹ۔

MCP پروٹوکول کے ذریعے Spy.House کا انضمام مقبول AI اسسٹنٹس اور ڈویلپمنٹ انوائرمنٹس کو مسابقتی انٹیلی جنس (competitive intelligence) کا ایک موثر ٹول بنا دیتا ہے۔ ہموار (seamless) OAuth توثیق اور ایک واحد کنیکٹر کی بدولت، صارفین کو تلاش کے عمل کو سادہ اور قدرتی زبان کے پرامپٹس تک محدود کرتے ہوئے، اپنے واقف کلائنٹ کے انٹرفیس سے ہی اشتہاری تخلیقات (creatives) تلاش کرنے، دستیاب فلٹرز کا تجزیہ کرنے اور میڈیا فائلز کا معائنہ کرنے کی سہولت ملتی ہے۔