নির্দেশনা: MCP-এর মাধ্যমে Spy.House ইন্টিগ্রেট করা

এই নির্দেশিকাটি Model Context Protocol (MCP)-এর মাধ্যমে AI ক্লায়েন্ট এবং ডেভেলপমেন্ট এনভায়রনমেন্টের সাথে Spy.House বিজ্ঞাপন ক্রিয়েটিভ বিশ্লেষণ সেবার সেটআপ ও ব্যবহারের ওপর আলোকপাত করে।

উপাদানটিতে সংযোগের পূর্বশর্ত (সক্রিয় পেইড সাবস্ক্রিপশন এবং API কী ছাড়াই OAuth প্রমাণীকরণ), সংযোগ চালুর ৩-ধাপের মৌলিক প্রক্রিয়া, এবং নির্দিষ্ট কিছু অ্যাপ্লিকেশন—Claude (Desktop, Web, Code), Codex, Cursor, VS Code ও ChatGPT—এর জন্য ধাপে ধাপে সেটআপ নির্দেশিকা বিস্তারিতভাবে আলোচনা করা হয়েছে।

সংযোগ করার আগে গুরুত্বপূর্ণ তথ্য

• কানেক্টর URL (Connector URL): [https://spy.house/mcp]। এই URL-টি আপনার MCP ক্লায়েন্টে যুক্ত করতে হবে।

• শর্তাবলী: একটি সক্রিয় পেইড সাবস্ক্রিপশন প্রয়োজন। ট্রায়াল সংস্করণ (trial) যুক্ত করা যাবে না।

• অথরাইজেশন (প্রমাণীকরণ): OAuth-এর মাধ্যমে সম্পন্ন হয় — আপনার ক্লায়েন্ট একটি ব্রাউজার ওপেন করবে এবং আপনি আপনার Spy.House অ্যাকাউন্ট দিয়ে লগ ইন করবেন। কোনো API কী-এর প্রয়োজন নেই।

সংযোগ করার ৩টি ধাপ

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): সার্ভার যোগ করার পর ক্লায়েন্ট রিস্টার্ট করতে হবে, কারণ চলমান সেশন এটি লোড করবে না। তারপর লগইন করুন: 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 বা ওয়ার্কস্পেসের (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 চালু করুন।

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.

• প্রত্যাশিত ফলাফল: ডাটা এবং অবশিষ্ট অনুসন্ধান কোটাসহ ১২টি পর্যন্ত ক্রিয়েটিভ। প্রতি কলে একটি মাত্র নেটওয়ার্ক: push, inpage, facebook, tiktok অথবা native। প্রতিটি সফল (অ-শূন্য) অনুসন্ধান ১ ইউনিট কোটা ব্যবহার করবে।

get_filter_options

• যাচাইকরণের অনুরোধ: List the available Facebook search filters.

• প্রত্যাশিত ফলাফল: অ্যাডাল্ট কনটেন্ট বাদে (non-adult) ফেসবুক সার্চ ফিল্টারের তালিকা এবং search_creatives-এর জন্য সঠিক মানসমূহ। অ্যাডাল্ট ফিল্টারগুলো লুকানো থাকে।

get_creative_media

• যাচাইকরণের অনুরোধ: Show me the images of the creatives you just found.

• প্রত্যাশিত ফলাফল: উক্ত অনুসন্ধান থেকে সর্বোচ্চ ৩টি creative_ref-এর মিডিয়া ফাইল। কোনো অনুসন্ধান কোটা কাটা যাবে না। পূর্ণাঙ্গ ভিডিও রিটার্ন হবে না এবং চ্যাট ইন্টারফেসে ইনলাইন প্রিভিউ নাও দেখাতে পারে।

render_creatives_gallery

• যাচাইকরণের অনুরোধ: Show these creatives as a gallery.

• প্রত্যাশিত ফলাফল: MCP Apps সমর্থন করে এমন ক্লায়েন্টগুলোতে একই অনুসন্ধান থেকে ১–১২টি creative_ref-এর একটি ইনলাইন গ্যালারি। অন্যান্য ক্লায়েন্ট এই টুলটি এড়িয়ে যাবে এবং টেক্সট বা get_creative_media ব্যবহার করবে।

সাধারণ জিজ্ঞাসা (FAQ)

কীভাবে AI ক্লায়েন্ট থেকে Spy.House সংযোগ বিচ্ছিন্ন করবেন?

AI ক্লায়েন্টে Spy.House সার্ভারটি মুছে ফেলুন (delete) বা নিষ্ক্রিয় (disable) করুন। পেইড সাবস্ক্রিপশনের মেয়াদ শেষ হলেও অ্যাক্সেস বন্ধ হয়ে যাবে। ট্রায়াল অ্যাকাউন্টগুলো যুক্ত করা সম্ভব নয়।

সহযোগিতা (Support) টিমের সাথে কীভাবে যোগাযোগ করবেন?

• Email: [email protected]

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

• সাপোর্টের সময়সীমা: সোম–শুক্র, ১০:০০–১৮:০০ (UTC+3)

ত্রুটির ক্ষেত্রে দয়া করে পাঠান: AI ক্লায়েন্টের নাম, সময়, এরর বার্তা/টেক্সট এবং একটি স্ক্রিনশট।

MCP প্রোটোকলের মাধ্যমে Spy.House-এর ইন্টিগ্রেশন জনপ্রিয় AI অ্যাসিস্ট্যান্ট এবং ডেভেলপমেন্ট এনভায়রনমেন্টগুলোকে প্রতিযোগী বিশ্লেষণের (competitive intelligence) একটি কার্যকর হাতিয়ারে পরিণত করে। নিরবচ্ছিন্ন OAuth প্রমাণীকরণ এবং একক কানেক্টরের সাহায্যে ব্যবহারকারীরা তাদের পরিচিত ক্লায়েন্ট ইন্টারফেস থেকেই সরাসরি বিজ্ঞাপন ক্রিয়েটিভ অনুসন্ধান, উপলব্ধ ফিল্টার বিশ্লেষণ এবং মিডিয়া ফাইল দেখার সুবিধা পান—যা অনুসন্ধানের দীর্ঘ প্রক্রিয়াকে সাধারণ ভাষার অনুরোধে রূপান্তর করে।