Инструкция: Интеграция Spy.House через MCP

Данное руководство посвящено настройке и использованию интеграции сервиса аналитики рекламных креативов Spy.House с ИИ-клиентами и средами разработки через протокол Model Context Protocol (MCP). 

В материале подробно разбираются предварительные требования для подключения (наличие платной подписки и OAuth-авторизация без применения API-ключей), базовый алгоритм из трех шагов для запуска связки, а также пошаговые инструкции по настройке конкретных приложений: Claude (Desktop, Web, Code), Codex, Cursor, VS Code и ChatGPT. 

Важная информация перед подключением

• URL коннектора (Connector URL): [https://spy.house/mcp]. Этот URL необходимо вставить в ваш MCP-клиент.

• Требования: Требуется активная платная подписка. Пробная версия (trial) не может быть подключена.

• Авторизация: Выполняется через OAuth - ваш клиент открывает браузер, и вы входите с учетной записью Spy.House. API-ключ не требуется.

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): После добавления сервера необходимо перезапустить клиент, так как запущенная сессия его не загрузит. Затем выполните вход: для Claude Code с помощью команды /mcp, для Codex - командой codex mcp login spy-house (из блока ниже).

1. Claude

Десктопная и веб-версия используют Client ID, указанный ниже. Claude Code использует CLI-команду со своим собственным Client ID.

Desktop / Web:

• Перейдите в Settings (Настройки) → Connectors (Коннекторы) → Add custom connector (Добавить пользовательский коннектор).

• Вставьте endpoint URL. 

• Нажмите 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

Client ID для Desktop/Web: 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 рабочей области (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

• Откройте Claude → Customize → Connectors → Add custom connector.

• Укажите: Name — Spy.House, URL — [https://spy.house/mcp].

• В Advanced OAuth settings укажите Client ID spy-mcp-claude-desktop; оставьте Client Secret пустым.

• Нажмите Add / Connect.

6. ChatGPT

• В ChatGPT web включите Settings → Security and login → Developer mode.

• Добавьте удаленное приложение (remote MCP app) в Plugins: URL [https://spy.house/mcp], Client ID spy-mcp-chatgpt, Streamable HTTP, без Client Secret (no Client Secret).

• Нажмите Connect / Authenticate, войдите в Spy.House и подтвердите доступ. API-ключ и Client Secret не требуются.

• Выполните этот запрос: > 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.

• Ожидаемый результат: Каталог фильтров Facebook без контента для взрослых (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.

• Ожидаемый результат: Встроенная галерея из 1–12 creative_ref из того же поиска в клиентах, которые поддерживают MCP Apps. Остальные клиенты пропускают этот инструмент и используют текст или get_creative_media.

Часто задаваемые вопросы (FAQ)

• Как отключить Spy.House от AI-клиента? Удалите или отключите сервер Spy.House в AI-клиенте. Доступ также прекращается по истечении платной подписки. Пробные учетные записи не могут подключаться.

• 
  

• Как связаться со службой поддержки?

• Email: [email protected]

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

• Часы работы поддержки: Пн–Пт, 10:00–18:00 (UTC+3)

В случае ошибки, пожалуйста, отправьте: название клиента ИИ, время, текст ошибки и скриншот.

Интеграция Spy.House через протокол MCP превращает популярные ИИ-ассистенты и среды разработки в эффективный инструмент конкурентной разведки. Благодаря бесшовной OAuth-авторизации и единому коннектору пользователи получают возможность искать рекламные креативы, анализировать доступные фильтры и просматривать медиафайлы прямо из интерфейса своего привычного клиента, сокращая процесс поиска до простых запросов на естественном языке.