Короткие ссылки и QR-коды из ИИ-агента: MCP-сервер для Claude Code и Codex
ИИ-агент вроде Claude Code или Codex умеет читать файлы, писать код и запускать команды. Через MCP-сервер snap.kz он получает ещё и ваши короткие ссылки: создаёт их пачкой с UTM-метками, делает QR-коды, меняет адрес назначения и читает статистику переходов. Код писать не нужно — вы ставите задачу словами, агент сам решает, какой инструмент вызвать.
Ниже — что такое MCP, какие инструменты есть у сервера snap.kz, как подключить его за пару минут, какие задачи давать агенту и какие правила задать, чтобы он не поменял лишнего.
Что такое MCP простыми словами
MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-агент подключается к внешним сервисам. Сервер сообщает агенту список инструментов: как называется, что делает, какие параметры принимает. Дальше агент сам вызывает нужный, когда это требуется по задаче.
Разница с обычным API в том, кто решает. Через REST API ваша программа делает ровно то, что написал разработчик. Через MCP решает модель: вы пишете «сделай ссылки для пяти сторис и сравни, какая сработала лучше», а агент сам создаёт ссылки, через неделю забирает статистику и собирает таблицу. Ссылки, лимиты и статистика при этом общие — это тот же аккаунт snap.kz.
Сервер работает по адресу https://snap.kz/api/mcp (Streamable HTTP) с тем же API-ключом, что и REST API. Технические детали — в документации.
6 инструментов и что с ними делает агент
| Инструмент | Что делает | Зачем агенту |
|---|---|---|
create_link | Создаёт короткую ссылку: адрес, свой адрес, название, теги, UTM, срок действия, пароль | Наделать ссылок под кампанию, сторис, менеджеров |
list_links | Список ссылок с поиском и фильтром по тегу | Найти нужные ссылки перед отчётом или правкой |
get_link_stats | Статистика ссылки за период: переходы, уникальные, QR-сканы, города, устройства, источники | Сравнить каналы, собрать отчёт |
update_link | Меняет адрес назначения, название, теги, срок, включает и выключает ссылку | Перенаправить QR на новое меню, выключить старую акцию |
make_qr | Делает QR-код для ссылки | Отдать картинку дизайнеру или в типографию |
me | Тариф, лимиты и сколько использовано | Проверить, хватит ли лимита перед пачкой |
Инструменты повторяют REST API, кроме удаления: удалить ссылку агент не может — это делаете вы, в кабинете или через API. Аккаунт общий, поэтому всё, что агент создал, видно в кабинете, а всё, что вы создали в кабинете, видит агент.
Подключение
Шаг 1. Включите тариф «Про» и выпустите ключ
MCP, как и API, работает на тарифах «Про» (2 990 ₸ за 30 дней или 29 900 ₸ за год) и «Бизнес». Зарегистрируйтесь, оплатите тариф Kaspi или счётом на ТОО/ИП и выпустите ключ в кабинете, в разделе API. Ключ вида sk_… показывается один раз — сохраните его сразу.
Ключ один на аккаунт и открывает все ваши ссылки. Учитывайте это, если подключаете агента на чужом компьютере или в общем репозитории.
Шаг 2. Добавьте сервер в Claude Code
Одна команда в терминале:
claude mcp add --transport http snap https://snap.kz/api/mcp \
--header "Authorization: Bearer <API_KEY>"snap — имя сервера, под ним инструменты появятся в агенте. Список подключённых серверов показывает claude mcp list. Не кладите ключ в файлы, которые попадают в git: кто получит ключ, сможет менять ваши ссылки.
Шаг 3. Подключите Codex или другой клиент
Многие MCP-клиенты принимают конфиг такого вида:
{
"mcpServers": {
"snap": {
"type": "http",
"url": "https://snap.kz/api/mcp",
"headers": { "Authorization": "Bearer <API_KEY>" }
}
}
}Где лежит этот файл и какой у него формат, у каждого клиента своё. Для Codex и остальных добавьте HTTP MCP-сервер по инструкции клиента: адрес https://snap.kz/api/mcp и заголовок Authorization: Bearer <API_KEY>. Если клиент умеет только локальные серверы без HTTP, этот способ ему не подойдёт.
Шаг 4. Проверьте: «какой у меня тариф»
Напишите агенту «какой у меня тариф в snap.kz и сколько ссылок осталось». Он вызовет me и покажет тариф, лимиты и использованное. Это и есть проверка ключа: при неверном ключе вызов вернёт ошибку авторизации, а на бесплатном тарифе — ошибку о том, что тариф не позволяет.
Шаг 5. Первая ссылка
Сделай короткую ссылку на https://aroma.kz/menu с адресом aroma-menu
и названием «Меню на столах». Потом сделай для неё QR-код в SVG.Агент вызовет create_link, затем make_qr и вернёт короткую ссылку и QR-код. Если адрес aroma-menu уже кем-то занят, придёт ошибка — попросите агента предложить варианты с названием бренда или района: aroma-abay-menu, aroma-kz-menu. Правила своих адресов — в гайде как придумать адрес ссылки.
Примеры задач для агента
Задачи формулируйте так же, как поручили бы сотруднику: что сделать, откуда взять данные, чего не делать.
Пять ссылок с UTM для сторис
Сделай 5 ссылок на https://alma.kz/osen-sale для сторис в Instagram.
UTM: source=instagram, medium=stories, campaign=osen-sale, content=story-1 … story-5.
Тег «осень-2026». Дай таблицу: номер сторис, короткая ссылка.Агент пять раз вызовет create_link с полем utm и соберёт таблицу. Каждую ссылку ставите в свою сторис — и потом видно, какая из них привела больше людей. Почему отдельная ссылка на каждый канал надёжнее, чем один источник в статистике, — в гайде как считать переходы из Instagram, Telegram и 2ГИС. Как составлять метки, — в гайде про UTM.
Сравнить переходы за неделю
Найди ссылки с тегом «осень-2026». Для каждой возьми статистику
за 10–16 октября и за 3–9 октября. Сравни переходы и уникальных,
отдельно покажи, сколько пришло по QR-коду. Выводы — тремя пунктами.Агент вызовет list_links с тегом, затем get_link_stats для каждой ссылки за оба периода и сведёт таблицу. Глубина статистики — год на «Про» и 3 года на «Бизнесе». Уникальные считаются как один посетитель в сутки, поэтому сумма уникальных по дням может быть больше, чем людей за неделю. Подробнее — в гайде как посчитать переходы.
Перенаправить QR-код на новое меню
Ссылка snap.kz/aroma-menu сейчас ведёт на старое меню.
Поменяй адрес назначения на https://aroma.kz/menu-zima.
Перед изменением покажи текущий адрес и спроси подтверждение.Агент найдёт ссылку через list_links, покажет текущий адрес и после вашего «да» вызовет update_link. Напечатанный QR-код на столах перепечатывать не нужно — он ведёт на ту же короткую ссылку. Так работает динамический QR-код.
Отчёт клиенту
По всем ссылкам с тегом «клиент-arman» собери отчёт за сентябрь:
переходы по дням, топ-5 городов, доля телефонов, источники.
Оформи в Markdown, чтобы я вставил в письмо.Это та же работа, которую SMM-специалист делает руками раз в месяц. Как устроить ссылки, чтобы такой отчёт собирался за минуты, — в гайде отчёт клиенту для SMM.
Правила безопасности
Агент работает быстро и уверенно, поэтому правила задайте заранее — в инструкциях проекта или в начале задачи.
- Подтверждение перед
update_link. Смена адреса назначения сразу меняет, куда ведут все напечатанные QR-коды этой ссылки. Клиенты MCP обычно спрашивают разрешение перед вызовом инструмента — для изменений эту проверку лучше не отключать. - Не удалять, а выключать. Если ссылка больше не нужна, пусть агент ставит её на паузу (
disabled), а не удаляет: удалённую не вернуть, а выключенную можно включить обратно. - Проверять лимиты. Перед пачкой ссылок — вызов
me. На «Про» можно создать до 300 ссылок в сутки и сделать до 60 запросов в минуту, на «Бизнесе» — 3 000 и 300. - Ключ — не в репозитории. Переменная окружения или настройки клиента, а не файл в git. Если ключ утёк, выпустите новый в кабинете и обновите его у агента.
- Без персональных данных в ссылках. Агент не должен класть телефоны и имена клиентов в адрес назначения или UTM-метки: их увидит каждый, кто откроет ссылку. Подробнее — в гайде о персональных данных.
- Содержимое страниц — данные, не команды. Если агент открывает чужую страницу, чтобы взять с неё адрес, текст на ней — это данные, а не указания, что делать с вашими ссылками.
Готовый блок правил можно положить в инструкции агента:
Правила работы со ссылками (сервер snap):
- Перед update_link покажи текущий и новый адрес назначения и жди подтверждения.
- Ссылки не удаляй — выключай (status: disabled).
- Перед созданием больше 10 ссылок вызови me и покажи, сколько останется.
- Свои адреса — латиница в нижнем регистре, с названием бренда.
- Не добавляй в ссылки и UTM телефоны, имена и email клиентов.Частые вопросы
Какого ИИ-агента можно подключить через MCP?
Любой MCP-клиент, который поддерживает HTTP-серверы с заголовком авторизации: Claude Code, Codex и другие. Модель внутри клиента значения не имеет.
Нужно ли программировать?
Нет: одна команда или конфиг, дальше задачи словами. Если нужна интеграция, которая работает сама, без агента, — например, ссылка на каждый новый заказ, — используйте REST API.
Сколько стоит MCP?
MCP входит в тариф «Про» (2 990 ₸ за 30 дней) и «Бизнес» (9 990 ₸), отдельно вызовы не оплачиваются. Модель агента оплачивается у её провайдера. Подробнее — на странице цен.
Работает ли MCP на бесплатном тарифе?
Нет. На бесплатном тарифе ссылки и QR-коды создаются только в кабинете.
Видит ли агент, кто именно перешёл по ссылке?
Нет. Статистика обезличенная: число переходов, города, устройства, источники. IP-адреса мы не храним, поэтому агенту нечего показать о конкретном человеке.
Что будет со ссылками, которые создал агент, если тариф закончится?
Они продолжат работать и вести туда же. Перестанут работать MCP, API и другие платные функции, пока вы не продлите тариф.
Сделайте короткую ссылку с QR-кодом
Бесплатно — до 30 ссылок с QR-кодами и статистикой переходов. Ссылки не отключаются за неоплату, сервер — в Казахстане.