Petunjuk: Mengintegrasikan Spy.House melalui MCP

Panduan ini membahas pengaturan dan penggunaan integrasi layanan analitik kreatif iklan Spy.House dengan klien AI dan lingkungan pengembangan (IDE) melalui Model Context Protocol (MCP).

Materi ini mengulas secara terperinci persyaratan awal untuk koneksi (memiliki langganan berbayar dan otorisasi OAuth tanpa kunci API), algoritma dasar 3 langkah untuk menjalankan integrasi, serta petunjuk langkah demi langkah untuk mengonfigurasi aplikasi tertentu: Claude (Desktop, Web, Code), Codex, Cursor, VS Code, dan ChatGPT.

Informasi Penting Sebelum Menghubungkan

• URL Konektor (Connector URL): [https://spy.house/mcp]. URL ini harus dimasukkan ke dalam klien MCP Anda.

• Persyaratan: Diperlukan langganan berbayar yang aktif. Versi uji coba (trial) tidak dapat dihubungkan.

• Otorisasi: Dilakukan melalui OAuth - klien Anda akan membuka peramban (browser), lalu Anda masuk dengan akun Spy.House. Kunci API tidak diperlukan.

3 Langkah untuk Menghubungkan

1. Tambahkan server (Add the server): Arahkan klien MCP Anda ke URL konektor - ini berupa satu baris konfigurasi atau perintah (lihat di bawah).

2. Masuk dengan Spy.House (Sign in with Spy.House): Klien Anda akan membuka peramban untuk otorisasi OAuth.

3. Tanyakan kepada agen Anda (Ask your agent): Tuliskan permintaan (prompt), misalnya: "Find up to 12 Black Friday FB creatives for the USA". Agen akan memanggil alat yang sesuai dan memberikan jawaban.

Pengaturan untuk Klien Tertentu

Catatan untuk klien CLI (Claude Code, Codex): Setelah menambahkan server, Anda perlu memulai ulang (restart) klien karena sesi yang sedang berjalan tidak akan memuatnya. Kemudian lakukan proses masuk (login): untuk Claude Code gunakan perintah /mcp, untuk Codex gunakan perintah codex mcp login spy-house (dari blok di bawah).

1. ClaudeVersi Desktop dan Web menggunakan Client ID yang tertera di bawah. Claude Code menggunakan perintah CLI dengan Client ID miliknya sendiri.

Desktop / Web:

1. Buka Settings (Pengaturan) → Connectors (Konektor) → Add custom connector (Tambah konektor kustom).

2. Tempelkan URL endpoint.

3. Klik Connect & authorize (Hubungkan & otorisasi).

Claude Code (CLI): Jalankan perintah:

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

Client ID untuk Desktop/Web: spy-mcp-claude-desktop

2. CodexTambahkan server jarak jauh (remote server) menggunakan satu perintah, lalu masuk ke sistem:

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. CursorJalankan perintah di bawah ini atau tambahkan server ke file ~/.cursor/mcp.json atau .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 CodeJalankan perintah di bawah ini atau tambahkan server ke file mcp.json pengguna atau mcp.json ruang kerja (workspace):

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. Buka Claude → Customize → Connectors → Add custom connector.

2. Isikan: Name — Spy.House, URL — [https://spy.house/mcp].

3. Pada Advanced OAuth settings, masukkan Client ID spy-mcp-claude-desktop; biarkan Client Secret kosong.

4. Klik Add / Connect.

6. ChatGPT

1. Di ChatGPT web, aktifkan Settings → Security and login → Developer mode.

2. Tambahkan aplikasi jarak jauh (remote MCP app) di Plugins: URL [https://spy.house/mcp], Client ID spy-mcp-chatgpt, Streamable HTTP, tanpa Client Secret (no Client Secret).

3. Klik Connect / Authenticate, masuk ke Spy.House, lalu konfirmasikan akses. Kunci API dan Client Secret tidak diperlukan.

4. Jalankan permintaan ini: > Find up to 12 Black Friday FB creatives for the US.

Verifikasi Melalui Permintaan (Verification by request)

Setelah terhubung, jalankan permintaan (prompt) berikut di klien Anda. Hasil yang diharapkan adalah daftar periksa (checklist), bukan hasil pencarian langsung.

• search_creatives

  • Permintaan verifikasi: Find up to 12 Black Friday Facebook ad creatives for the US.

  • Hasil yang diharapkan: Hingga 12 kreatif iklan, termasuk data dan sisa kuota pencarian. Satu jaringan per pemanggilan: push, inpage, facebook, tiktok, atau native. Setiap pencarian yang tidak kosong akan mengonsumsi satu unit kuota.

• get_filter_options

  • Permintaan verifikasi: List the available Facebook search filters.

  • Hasil yang diharapkan: Katalog filter Facebook non-dewasa (non-adult) dan nilai persis untuk search_creatives. Filter dewasa disembunyikan.

• get_creative_media

  • Permintaan verifikasi: Show me the images of the creatives you just found.

  • Hasil yang diharapkan: Media hingga tiga creative_ref dari pencarian tersebut. Kuota pencarian tidak berkurang. Video lengkap tidak dikembalikan, dan obrolan mungkin tidak menampilkan pratinjau tertanam (embedded preview).

• render_creatives_gallery

  • Permintaan verifikasi: Show these creatives as a gallery.

  • Hasil yang diharapkan: Galeri tertanam yang berisi 1–12 creative_ref dari pencarian yang sama pada klien yang mendukung MCP Apps. Klien lainnya akan melewati alat ini dan menggunakan teks atau get_creative_media.

Pertanyaan yang Sering Diajukan (FAQ)

• Bagaimana cara memutuskan hubungan Spy.House dari klien AI?

• Hapus atau nonaktifkan server Spy.House pada klien AI Anda. Akses juga akan terhenti secara otomatis setelah masa berlangganan berbayar berakhir. Akun uji coba (trial) tidak dapat terhubung.

• Bagaimana cara menghubungi layanan dukungan (support)?

  • Email: [email protected]

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

  • Jam kerja dukungan: Senin–Jumat, 10:00–18:00 (UTC+3)

  • Jika terjadi kesalahan (error), harap kirimkan: nama klien AI, waktu kejadian, teks kesalahan, dan tangkapan layar (screenshot).

Integrasi Spy.House melalui protokol MCP mengubah asisten AI dan lingkungan pengembangan populer menjadi alat intelijen kompetitif yang efektif. Berkat otorisasi OAuth yang lancar dan konektor tunggal, pengguna dapat mencari kreatif iklan, menganalisis filter yang tersedia, serta melihat file media langsung dari antarmuka klien favorit mereka, sehingga menyederhanakan proses pencarian menjadi permintaan bahasa alami yang sederhana.