MCP-сервер
Как подключить MTWSPY к Claude, Claude Code и Cursor по MCP — адрес сервера, ключ, список инструментов и сколько они стоят.
MCP (Model Context Protocol) — протокол, через который AI-ассистенты вызывают внешние инструменты. Через MCP-сервер MTWSPY ассистент ищет креативы, открывает карточки, получает ссылки на лендинги и проверяет остаток просмотров.
Адрес сервера
https://mcp.mtwspy.com/mcp, транспорт Streamable HTTP. Ключ — тот же mtw_live_…, что
для REST (Аутентификация), но передаётся в заголовке X-API-Key.
Подключение
- Откройте Settings → Connectors и добавьте свой коннектор (Add custom connector).
- Название —
MTWSPY, URL —https://mcp.mtwspy.com/mcp. - В Advanced settings → Request headers добавьте заголовок
X-API-Keyсо значением вашего ключа. - Включите коннектор в чате через меню инструментов.
С ключом можно тратить просмотры вашего аккаунта. Не кладите конфиг с ключом в репозиторий.
Инструменты
| Инструмент | Что делает | Просмотры |
|---|---|---|
search_creatives | Поиск с теми же фильтрами, что у /creatives. По умолчанию 20 карточек | 1 за карточку |
get_creative | Карточка по id, как /creatives/{id} | Не тратит |
get_landing_download_url | Временная ссылка на архив лендинга, как /creatives/{id}/landing | Не тратит; 30 в час |
get_usage | Тариф, лимит запросов и остаток просмотров, как /usage | Не тратит |
get_referral_balance | Реферальный баланс, как /balance | Не тратит |
Тот же запрос search_creatives в течение 2 часов повторно не списывается. Перед
большой выборкой попросите ассистента вызвать get_usage.
Примеры запросов к ассистенту
- «Найди 10 видео-креативов по нутре на Польшу за последнюю неделю, отсортируй по охвату».
- «Открой карточку 2255582 и покажи, куда ведёт кнопка объявления».
- «Скачай лендинг этого креатива».
- «Сколько просмотров у меня осталось?»
Ошибки
Коды ошибок те же, что у REST (список — в обзоре). Если закончились просмотры,
придёт quota_exhausted. При rate_limited нужно подождать retry_after секунд.
missing_api_key значит, что в подключении нет заголовка X-API-Key.