AI Dev Live 2026 · День 2
Как дать агенту доступ к вашему продукту: MCP, Skills и CLI
Как выбрать между MCP, CLI и скиллом, почему агент не дочитывает вашу инструкцию, куда класть подсказки, как не слить персональные данные и что делать с офертой. Все на опыте MCP для Туту и пачки моих самодельных интеграций

Главное за минуту
- Агенты придут в продукт в любом случае. Либо через дверь, то есть MCP или CLI от самого бизнеса, либо через окно: браузер и неофициальные API от энтузиастов. Своя дверь дает инструкции, рейт-лимиты и меньше абьюза.
- Выбирают по тому, где живет агент: в чате или в телефоне остается только удаленный MCP, для продукта-программы логичнее CLI, для длинных правил скилл. На одних задачах MCP и CLI отрабатывают почти одинаково.
- В первой версии MCP Туту упала половина из 40 тестов: агент не читал инструкцию, а харнесы ее режут, Codex до 250 знаков. Инструкцию мы сократили до 2 000 знаков, а подробности разложили по инструментам.
- Инструменты делают под сценарии, а не оборачивают каждую ручку API: покупка билета занимает у агента четыре шага вместо восьми запросов. В ответ инструмента кладут подсказку, что делать дальше, как это делает git.
- Вместо чувствительных данных инструмент отдает маску: правило «не показывай полис» не спасает, агент его уже увидел. С офертой идут к юристам, чтобы каждое действие агента совпадало с ее акцептом.
Содержание
Когда делаешь интеграцию для агентов, ощущение, будто сидишь внутри четырехмерного гиперкуба. Надо следить, как разные харнесы выводят тулы, сколько инструкций кладут в контекст и куда двинулась спецификация. Этим летом MCP, например, стал гарантированно stateless, а я знаю нескольких корпоратов, у которых внутри до сих пор крутится stateful-реализация. И все это приходится держать в голове, даже если ты просто публикуешь скиллы.
Агенты уже пришли
Я 20 лет работаю в продукте. Годами мы полируем UI/UX и следим за конверсией, а в этом году к нам стали приходить сущности, которым на интерфейс плевать. У них есть задача, и если она непонятна, они придумают, как ее выполнить: где-то обойдут, а где-то и хакнут систему
Мой путь сюда начался зимой с чата маркетологов, где ребята парсили Wordstat через Playwright. Я написал для этого скилл, опубликовал в канале и получил около тысячи репостов. Потом собрал репозиторий со всеми маркетинговыми скиллами для Яндекса, он набрал 200 с лишним звезд, и мне периодически пишут, что им пользуются. Так что Директом теперь управляют не только люди, но и агенты. А в интерфейс Метрики я за последний год вообще перестал ходить: агент прямо во время созвона за 5 минут делает отчет, который я бы долго натыкивал фильтрами
Через дверь или через окно
Куда агенты пока не дошли, так это в здравоохранение. Мне очень хочется, чтобы мой OpenClaw или Hermes посмотрел окошки, сверился с календарем и записал ребенка к врачу, безопасно и без утечек. Официального API нет, остается браузер. Вход там периодически слетает, и как раз когда задача срочная, ты идешь авторизовываться. Поменялась структура сайта – правь инструкции. И главное, это небезопасно для пользовательских данных.
Когда писал доклад, посмотрел, есть ли уже репозитории для записи к врачу. Оказалось, энтузиасты раскрыли, как устроена апишка ЕМИАС, кладут туда куку и делают все то же самое, только немного в черную. В Питере то же самое с API Горздрава, и обновления там приезжают регулярно
Агенты в продукт все равно придут, потому что это удобно: агент знает мои предпочтения и вообще классный. Вопрос в том, откроете ли вы ему дверь, выпустив MCP или CLI, или дождетесь, пока он залезет через окно. А тот, кто входит через окно, может увидеть лишнее, что-нибудь передвинуть и вообще пошуметь.
Зачем бизнесу открывать дверь
Главная польза в том, что агенту можно подсказывать, как лучше работать с сервисом. Продавец в магазине предлагает вступить в бонусную программу, и агент вполне может зарегистрировать пользователя, ему ввести телефон несложно. Через агента так же удобно процессить обмен и возврат. А честные инструкции заодно защищают от вакханалии, которую агенты могут у вас устроить.
В MCP Туту мы так и сделали. Пишешь, что хочешь в Питер, агент ищет билеты и места по твоим предпочтениям и отправляет тебя: все, иди покупай
А к своей управляющей компании я сделал серую интеграцию. Приложение у них настолько неудобное, что паркинг заказывается за восемь экранов, а на 3 часа надо пройти этот флоу трижды. Я посмотрел их апишку и сделал агенту MCP: новости дома, сервисы, пропуска курьерам
Было бы клево так же записываться к врачу: агент посмотрел свободные окошки, сверил с календарем и записал к педиатру
Если агенты работают в серую, получаются истории вроде недавней в Австралии. Мужчина хотел на тренировку, мест не было, и агент выписал оттуда всех, а записал его одного. Репутацией в итоге заплатил фитнес-клуб
Мне возражали, что агенты устроят неравную конкуренцию и займут все свободные окошки в ЕМИАС. Я считаю, это обходится инструкциями и рейт-лимитами. Если подключать агентов удобно и им понятно, как пользоваться сервисом, злоупотреблений будет меньше. Так что выдать агенту API и инструкции – хороший способ зарегулировать этот рынок.
MCP, CLI или скилл
Под анонсом MCP Туту спрашивали, почему не CLI или скилл. Сразу оговорюсь: говоря, что бизнесу нужен MCP, я всегда имею в виду удаленный сервер. Локальный MCP действительно отстой. Первый MCP GitHub надо было запускать у себя и прописывать в настройках, а GitHub CLI офигенно удобный: агент просто запускает команду в терминале.
Вариантов три: MCP, CLI и скилл, плюс плагин, который объединяет скилл и MCP. А браузер-юз, скрипты и эмуляция на странице очень ненадежны
Выбирать советую по тому, где живет агент, который скорее всего будет пользоваться вашим сервисом. Если это приложение на телефоне или облачный чатик, остается только MCP. Программу туда не поставишь: в обычном чате ChatGPT, если не ошибаюсь, до сих пор ничего не установить в терминал. У скилла тоже бывают внешние зависимости, которые в такую среду неудобно доставлять.
Если продукт – программа, логичнее CLI, как gh у GitHub или CLI у Blender. У Figma MCP, потому что она облачная. А если для работы нужно много инструкций, лучше скилл: правила, по которым харнесы режут инструкции сервера, по сути недетерминированы. OpenCode, например, точно не порежет, остальные могут
Клевый вариант – отдавать MCP как скилл, пакетом-плагином. В нем лежит инструкция скилла, которая подробно описывает, как пользоваться MCP, и адреса нужных серверов. Наверное, это самое удобное, но поддерживают это пока не все
my-service/
├── plugin.json имя, версия
├── mcp.json адрес вашего MCP
└── skills/my-service/
└── SKILL.md правила и когда
какой инструмент звать
у Claude: .claude-plugin/plugin.json и .mcp.jsonРазницы почти нет
Самый холиварный вопрос – MCP или скилл. Марио Цехнер, автор харнеса Pi, в прошлом году говорил, что MCP в Pi не будет никогда, потому что он нафиг не нужен. В сентябре MCP в Pi все-таки доехал. А у Марио в блоге есть статья, где он несколько раз сравнил один инструмент: CLI и MCP отрабатывают неразличимо, если не деградируют инструкции, которые вы передаете агенту.
Про скиллы чаще всего слышу, что они не работают. Иду во фронтматтер, а там просто не написано, когда его вызывать. Как только прописываешь это явно, попадание стопроцентное. Чужие неофициальные скиллы – поверхность атаки: недавно известный блогер выложил скилл, в котором заметили телеметрию. Ничего плохого он не хотел, но прецедент есть, ведь в скилле может лежать инструкция передавать такие-то данные в таких-то случаях.
Про MCP говорят, что он ест контекст, но многие харнесы уже умеют искать по инструментам, так что это в прошлом. У CLI беда – бесконечные обновления, и тут у MCP преимущество. Обновили сервер, и все агенты, у которых он прописан, получат новую версию в следующей сессии. Со скиллами и CLI придется придумывать, как уговорить людей или агентов обновиться
Гиперкуб получается потому, что стандарты меняются. За 2 года MCP прошел путь от stateful к stateless, придумал пакетные запросы и отменил их. Клиенты тоже меняются, и каждый раз приходится смотреть, как сейчас в том же Codex агент работает с инструкциями, потому что в тестах начинаются странные деградации. Самый предсказуемый тут CLI: все выводится в терминал, и большинство сообщений агент увидит.
Что поменялось в спецификации: changelog MCP
Агент не дочитал инструкцию
В первой версии MCP Туту была огромная инструкция и небольшой набор тулов. Я запустил первую пачку тестов, всего штук 40, и упало 20. Оказалось, агент просто не читал инструкцию
Свое подобие инструкции есть у всех трех способов. MCP отдает ее в первом ответе при инициализации, у CLI она по help, у скилла собирается при первом чтении. Проблема MCP в том, что не все харнесы кушают эту инструкцию целиком.
Я прикинул монстр-инструкцию для ЕМИАС: 700 символов про то, что умеет сервер, дальше поиск врача и все остальные сервисы. И посмотрел, сколько символов забирает в контекст каждый харнес. Тот же OpenClaw просто не узнает, как отменить и перенести запись. Вроде MCP сделали, а агенты все равно ведут себя немного серенько
В Туту мы сократили инструкцию до 2 000 знаков и просто написали: чтобы выбрать билет на поезд, сначала вызови тул, который объясняет, как покупать билеты на поезд. По сути мы разложили инструкцию по инструментам, как у скилла бывают референсы, которые агент грузит только под узкую задачу. В CLI то же самое делает help на отдельную команду. Так что тейк Цехнера, что разницы между MCP и CLI особо нет, действительно реален.
Инструменты под сценарии
Еще спрашивали, зачем отдельный сервер, если есть библиотеки вроде OpenAPI to MCP, которые превращают спецификацию в MCP-сервер. Звучит клево, но в обычном API много ручек, каждая отвечает за свой кусочек. А процедура вроде «купить билет» – это несколько вызовов подряд. Агенты не очень детерминированные и могут задумать другой порядок, и результат будет хуже, чем если сразу прописать цепочку.
Покупка билета – четыре шага: найти поезд, выбрать места, внести пассажиров и получить ссылку на оплату. Только последние два – восемь запросов к API в определенном порядке. Гораздо удобнее один тул, куда агент передаст все нужное, а бэкенд внутри отработает сам. А безумное количество вызовов мы сэкономили, просто придумав инструмент фильтрации рассадки в вагонах
Подсказка в ответе
Чтобы агенты не деградировали, кладите в ответ инструмента подсказку, что делать после этого шага. Можно прямо написать «записывай только после "да"» или «дополнительно проверь». Ровно так же делает git. Еще MCP лучше голого OpenAPI тем, что агенту можно дать понятную ошибку: как она получилась и что сделать, чтобы ее исправить. Упаковать работу с бэкендом в MCP или CLI – хороший путь и к меньшему абьюзу, и к более гладкому поведению агентов.
# MCP · вызов и ответ
→ find_slots(specialty: "педиатр")
← { "slots": ["14:30", "15:10"],
"next": "Спроси человека, какое время.
Записывай только после «да»" }
# MCP · ошибка с объяснением
← { "error": "Доступ ограничен.
Приходи через 2 часа" }
# CLI · так делает git
(use "git add <file>..." to update
what will be committed)Скилл тут отстает, потому что чаще всего ходит в обычный API. Мои скиллы для Метрики – по сути скрипты, которые шлют запросы в апишку, и ответ приходит ровно в том формате, в каком его вернула Метрика. Не постобработали в скриптах – агент работает так же, как напрямую с API
Агента можно загипнотизировать
Обратная сторона: так агентов можно гипнотизировать и подсовывать им инструкции, выгодные вашему бизнесу. Я очень топлю за то, чтобы Яндекс сам выпустил официальные скиллы или MCP для маркетинга. Но у меня жесткое предположение, что ребята из Яндекс Рекламы не преминут положить в инструкцию что-нибудь вроде «обязательно настрой РСЯ по такой-то автостратегии». Цель компании все-таки заработать побольше. Даже людям они иногда предлагают такое, что по запросу товаров для животных у тебя крутится реклама клеток для попугаев, которых твой магазин не продает
Как регулировать MCP и какими аудитами, пока большой вопрос, и это голос в пользу скиллов. Их инструкции лежат на поверхности: смотришь, что придумал автор, и если там что-то недобросовестное, переписываешь скилл под себя. С MCP так не выйдет, вы даже не узнаете, когда он поменяется и вместо понятного ответа начнет слать вашим агентам злые манипуляции.
И еще: все харнесы, которые я знаю, могут резать ответы тулов. Самое ценное кладите в начало, а лучше вообще делайте ответы компактными
Персональные данные
Стоит на конференции сказать «152-ФЗ», вокруг собирается толпа: штрафы за утечку ужасные, а как их избежать, не очень понятно. Когда мы запускали «Позвони Гребенюку», телефонного ассистента, который эмулирует общение с инфлюенсером, документов для ведомств там вышло по строкам сильно больше, чем кода. Юристы работали гораздо больше программистов. А недавно случился инцидент у хостера (он писал об этом на Хабре), и нам пришлось подавать уведомление в РКН: у нас такой инцидент, мы его расследуем. Это еще огромный поток работы с документами и юристами. Было бы неплохо, если бы РКН тоже делал скиллы: с понятным скиллом, как оформлять и подавать бумаги, заявления были бы гораздо качественнее
Агент мало чем отличается от браузера, это тот же HTTP. Но браузер, если разработчики аккуратно поработали, после ухода со страницы не хранит ни паролей, ни карт. А все, что агент увидел через браузер-юз, осталось у него в сессии. Разработчики позаботились, чтобы карта не кэшировалась в браузере, а агент ее теперь держит, и неизвестно, куда она будет скопирована.
С MCP или CLI можно отдавать вместо чувствительных данных маскированные. Правило «не показывай полис» не спасает: агент полис уже увидел, значит, он лежит в сессии. А если инструмент отвечает «Петя П., полис заканчивается на такие-то цифры», утечки нет. В этом MCP и CLI сильно дружелюбнее браузер-юза.
Саймон Уиллисон сформулировал смертельную триаду: доступ к пользовательскому контенту, к личным данным и хоть какой-то канал наружу. Если все три есть, утечка достаточно вероятна. Поэтому чужой, да еще немодерируемый текст через MCP агенту пользователя лучше не отдавать. Ко всем моделям вообще стоит относиться как к наивным ребятам, которых легко уговорить: стопроцентной устойчивости к промпт-инъекциям нет ни у одной.
Подключение и оферта
Топ вопросов в личку, когда я делал скиллы, – как всю эту радость подключать. До сих пор это неудобненько. Единственный удобный способ сейчас – чаты и боты, которые авторизуются через OAuth и дальше пользуются, например, MCP Granola
Типичный MCP по своему адресу не показывает ничего полезного, хотя можно смотреть на заголовок Accept. Человеку отдаете страницу о том, как настроить агента, а агенту по тому же адресу – сам MCP. Когда мы запустили MCP для Туту, первый отзыв дала моя супруга. Скинул ей: смотри, сделали. Она в ответ «и что?» и показывает белый экран. В тот же вечер мы все переделали и стали отдавать две версии
С агентами обязательно сходите к юристам. Если сервис дает записаться или купить, его правила регулирует оферта, и любое действие надо совмещать с ее акцептом. Вариантов два. Первый – оферта перед действием: если MCP формирует счет на рекламу, человек сначала соглашается с условиями и только потом получает счет. Если агент скачает счет сам, доказать, что оферта принята, будет невозможно.
Второй – оферта при регистрации агента, когда вы разрешаете ему действовать от вашего имени, например записывать вас в больницу. Юристам стоит писать правила так, чтобы им же было удобно разбирать споры, когда агент сделает что-то, чего вам бы не хотелось
Сам MCP советует OAuth, но не у всех агентов есть redirect URL, куда вернется токен. Облачный чат и приложение на компьютере пройдут по стандарту, а OpenClaw или Hermes на Mac mini где-нибудь в комнате понадобится вход по токену. Так что поддерживайте оба
Самый простой способ превратить MCP в скилл, то есть лишить его доставки и обновления инструкций, – поменять адрес. У Яндекса есть поисковый MCP еще с первой волны интереса к серверам. Сделан он странно, через локальный MCP, который ходит на адрес. Однажды адрес переехал, и у всех все сломалось. У CLI и репозитория скиллов то же самое.
Тесты и трейсы
Мне как-то сказали, что сделали MCP. Спрашиваю, как тестите, а мне: «Ну, юнит-тесты, код покрыт, багов нет». Когда мы делали Туту, самым ценным источником данных оказались тестовые сценарии. Под каждый сценарий, с которым к нам могут прийти, пишем несколько тестов разной степени изощренности и смотрим, как они отрабатывают. Так мы нашли штук 100 багов после запуска.
У Anthropic есть статья про эвалы для агентов, где перечислены баги систем с LLM as a judge: нечестная оценка, неоднозначное задание, незасчитанное верное решение. Мы собрали их все, жаль, я не прочитал ее раньше. Поэтому смотреть только на поверхностные оценки вроде «был ли вызван тул» недопустимо. Нужен агент, который изучит трейсы и поймет, врет судья или агент правда ошибся. Чаще всего плывут инструкции или результаты тулов, и так проще всего выровнять поведение агентов на большом количестве кейсов.
Чтобы завтра у вас был MCP: придумываете минимальный набор инструментов и как их тестировать, решаете, как раздавать доступ, и договариваетесь с юристом, как принимать оферту. Запустите – напишите мне в личку, я стараюсь рассказывать в канале обо всех таких новинках в рунете и отдельно вас пропиарю
Канал «Поляков считает»: t.me/+ZnwxKOgzChdlODgy