Как связать LLM-агента с Яндекс Метрикой: MCP-сервер, OAuth без секрета и грабли Reporting API

Веб-аналитика завязана на дашборды и HTTP-API: чтобы получить отчёт о трафике, человек лезет в интерфейс Яндекс Метрики, а программа формирует запрос к Reporting API, помня namespace полей, лимиты и форматы ответа. LLM-агент (Claude, модель в Cursor или другой) не умеет ни того, ни другого по умолчанию. Мостом выступает MCP — Model Context Protocol.

В статье разбирается устройство MCP-сервера для Яндекс.Метрики: как упаковать отчёты в компактный набор инструментов, как авторизоваться в Yandex ID без клиентского секрета (это оказалось самым нетривиальным) и на какие грабли Reporting API автор наступил по ходу дела.

Практическое руководство будет полезно разработчикам, которые хотят научить ИИ-агентов работать с реальными бизнес-данными через веб-аналитику без ручного кодирования каждого запроса.