Talimatlar: Spy.House'u MCP aracılığıyla entegre etme

Bu kılavuz, reklam kreatifleri analitik servisi Spy.House'un Model Context Protocol (MCP) aracılığıyla yapay zeka (AI) istemcileri ve geliştirme ortamlarıyla (IDE) entegrasyonunun kurulması ve kullanılmasına ayrılmıştır.

Bu materyalde, bağlantı için ön koşullar (aktif ücretli abonelik ve API anahtarı kullanılmadan OAuth yetkilendirmesi), bağlantıyı başlatmak için 3 adımlı temel algoritma ve belirli uygulamaların ayarlanmasına yönelik adım adım talimatlar ayrıntılı olarak ele alınmaktadır: Claude (Desktop, Web, Code), Codex, Cursor, VS Code ve ChatGPT.

Bağlantı Öncesi Önemli Bilgiler

• Konnektör URL'si (Connector URL): [https://spy.house/mcp]. Bu URL'yi MCP istemcinize yapıştırmanız gerekir.

• Gereksinimler: Aktif bir ücretli abonelik gereklidir. Deneme sürümü (trial) bağlanamaz.

• Yetkilendirme: OAuth üzerinden gerçekleştirilir — istemciniz tarayıcıyı açar ve Spy.House hesabınızla giriş yaparsınız. API anahtarı gerekmez.

Bağlantı İçin 3 Adım

1. Sunucuyu ekleyin (Add the server): MCP istemcinizi konnektör URL'sine yönlendirin - bu tek bir konfigürasyon satırı veya komuttur (aşağıya bakın).

2. Spy.House ile giriş yapın (Sign in with Spy.House): İstemciniz OAuth yetkilendirmesi için tarayıcıyı açacaktır.

3. Ajanınıza sorun (Ask your agent): Örneğin şöyle bir istem (prompt) yazın: "Find up to 12 Black Friday FB creatives for the USA". Ajan ilgili aracı çağıracak ve yanıt verecektir.

Belirli İstemciler İçin Kurulum

CLI istemcileri için not (Claude Code, Codex): Sunucuyu ekledikten sonra istemciyi yeniden başlatmanız gerekir, çünkü çalışan oturum sunucuyu yüklemeyecektir. Ardından oturum açın: Claude Code için /mcp komutuyla, Codex için ise codex mcp login spy-house komutuyla (aşağıdaki bloktan).

1. Claude

Masaüstü (Desktop) ve web sürümleri aşağıda belirtilen Client ID'yi kullanır. Claude Code ise kendi Client ID'sine sahip bir CLI komutu kullanır.

• Desktop / Web:

  1. Settings (Ayarlar) → Connectors (Konnektörler) → Add custom connector (Özel konnektör ekle) bölümüne gidin.

  2. Endpoint URL'sini yapıştırın.

  3. Connect & authorize (Bağlan ve yetkilendir) butonuna tıklayın.

• Claude Code (CLI): Şu komutu çalıştırın:

  
  

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

  
  
  
  

• Client ID (Desktop/Web): spy-mcp-claude-desktop

2. Codex

Tek bir komutla uzak sunucuyu ekleyin, ardından sisteme giriş yapın.

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

Aşağıdaki komutu çalıştırın veya sunucuyu ~/.cursor/mcp.json veya .cursor/mcp.json dosyasına ekleyin.

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

Aşağıdaki komutu çalıştırın veya sunucuyu kullanıcı mcp.json dosyasına ya da çalışma alanı (workspace) mcp.json dosyasına ekleyin.

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'u açın → Customize → Connectors → Add custom connector.

2. Şunları belirtin: Name — Spy.House, URL — [https://spy.house/mcp].

3. Advanced OAuth settings kısmında Client ID olarak spy-mcp-claude-desktop girin; Client Secret alanını boş bırakın.

4. Add / Connect butonuna tıklayın.

6. ChatGPT

1. ChatGPT web'de Settings → Security and login → Developer mode seçeneğini etkinleştirin.

2. Plugins bölümüne uzak bir uygulama (remote MCP app) ekleyin: URL [https://spy.house/mcp], Client ID spy-mcp-chatgpt, Streamable HTTP, Client Secret yok (no Client Secret).

3. Connect / Authenticate butonuna tıklayın, Spy.House'a giriş yapın ve erişimi onaylayın. API anahtarı ve Client Secret gerekmez.

4. Şu isteği çalıştırın: > Find up to 12 Black Friday FB creatives for the US.

İstek ile Doğrulama (Verification by request)

Bağlantı kurulduktan sonra istemcinizde bu istekleri çalıştırın. Beklenen sonuçlar canlı bir arama değil, bir kontrol listesidir.

• search_creatives

  • Doğrulama isteği: "Find up to 12 Black Friday Facebook ad creatives for the US."

  • Beklenen sonuç: Veriler ve kalan arama kotası dahil olmak üzere 12 adede kadar kreatif. Çağrı başına tek ağ: push, inpage, facebook, tiktok veya native. Boş olmayan her arama bir kota birimi tüketir.

• get_filter_options

  • Doğrulama isteği: "List the available Facebook search filters."

  • Beklenen sonuç: Yetişkin içeriği (non-adult) içermeyen Facebook filtre kataloğu ve search_creatives için kesin değerler. Yetişkin filtreleri gizlenmiştir.

• get_creative_media

  • Doğrulama isteği: "Show me the images of the creatives you just found."

  • Beklenen sonuç: Bu aramadan en fazla üç creative_ref görseli/medyası. Arama kotasından düşülmez. Tam video döndürülmez ve sohbet yerleşik önizlemeyi görüntülemeyebilir.

• render_creatives_gallery

  • Doğrulama isteği: "Show these creatives as a gallery."

  • Beklenen sonuç: MCP Apps destekleyen istemcilerde aynı aramadan 1–12 creative_ref içeren yerleşik bir galeri. Diğer istemciler bu aracı atlar ve metin ya da get_creative_media kullanır.

Sıkça Sorulan Sorular (FAQ)

Spy.House yapay zeka istemcisinden nasıl kaldırılır?

Yapay zeka istemcinizdeki Spy.House sunucusunu silin veya devre dışı bırakın. Ayrıca ücretli aboneliğin süresi dolduğunda da erişim sona erer. Deneme hesapları bağlanamaz.

Destek ekibiyle nasıl iletişime geçilir?

• E-posta: [email protected]

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

• Destek çalışma saatleri: Pazartesi–Cuma, 10:00–18:00 (UTC+3)

Bir hata durumunda lütfen şunları gönderin: AI istemcisinin adı, zamanı, hata metni ve ekran görüntüsü.

Spy.House'un MCP protokolü üzerinden entegrasyonu, popüler yapay zeka asistanlarını ve geliştirme ortamlarını etkili bir rakip analizi aracına dönüştürür. Sorunsuz OAuth yetkilendirmesi ve tek bir konnektör sayesinde kullanıcılar; arama sürecini doğal dildeki basit istemlere indirgeyerek, alışık oldukları istemci arayüzünden doğrudan reklam kreatiflerini arama, mevcut filtreleri analiz etme ve medya dosyalarını görüntüleme olanağı elde ederler.