Два получателя у одной команды

MCP, Model Context Protocol, позволяет приложению подключать инструменты через сервер. Представим, что приложение агента вызывает инструмент «получить дневной расход». Запрос идёт на сервер MCP, а сервер обращается к API рекламного кабинета. Название операции у пользователя одно, но сетевых переходов два. Первый запрос принимает сервер инструментов, второй принимает рекламный кабинет.

Токен доступа в OAuth подтверждает разрешение на обращение к защищённому ресурсу. Параметр `resource` из RFC 8707 помогает клиенту указать ресурс, для которого запрашивает токен. Сервер авторизации может ограничить токен соответствующей аудиторией. Здесь «аудитория» означает получателя токена. Она ничего не говорит о сегменте покупателей в медиаплане.

В документации MCP по безопасности MCP-сервер обязан проверить, что входящий токен выпущен для него. К API кабинета он обращается с отдельным разрешением. Версия документа явно указана в ссылке. Конкретная интеграция кабинета может использовать другой механизм, например отдельный сервисный доступ. Важно проверить, как он выдаётся и какие операции допускает, прежде чем считать схему эквивалентной.

Где должна сработать проверка

Для входящего запроса сервер инструментов проверяет токен по правилам доверенного издателя. В учебной модели сервер видит получателя, срок действия и право на чтение. В работающей системе ему также нужно проверить подлинность. Если токен непрозрачный, способ проверки задаёт издатель, например через предусмотренный протоколом сервис проверки. Прочитать открытое содержимое токена и поверить напечатанным полям недостаточно.

Для второго перехода сервис получает или использует отдельное разрешение на доступ к кабинету по его поддерживаемой схеме. Договоритесь, кому принадлежит это разрешение, как проверяется клиентский аккаунт и что именно записывается в журнале. Если один сервисный аккаунт обслуживает нескольких рекламодателей, проверка принадлежности запрошенного кабинета нужна при каждом действии. Совпадение получателя и разрешённого действия само по себе не разделяет клиентов.

Ограничение получателя и объём полномочий решают разные задачи. Разрешение для кабинета A не становится допустимым для MCP-сервера только потому, что в нём есть право чтения. Разрешение на просмотр отчёта для правильного получателя не разрешает менять бюджет. RFC 9700 рассматривает ограничение аудитории токена как способ уменьшить последствия утечки. Это одна из проверок на границе, наряду с подлинностью, сроком, операцией и выбранным аккаунтом.

Как выглядит отрицательный тест

В учебном демо вместо ключей используются простые надписи. Выберите получателя `reports-mcp`, разрешение «Читать» и действующий срок. Первый переход допустим. Затем выберите `ads-api` с тем же правом. Первый переход должен завершиться отказом, даже если у второго сервиса такой токен был бы допустим. В третьем тесте выберите правильного получателя без права на нужное действие.

На отдельном шаге демо проверяет адресата условного разрешения сервиса для кабинета. Оно не выдаёт ключи, не подключается к API и не проверяет криптографию. CSV с пятью сценариями можно передать разработчику как перечень приёмочных испытаний. В стенде замените учебные надписи тестовыми учётными данными. В отчёте фиксируйте результат и идентификатор теста без самого ключа.

В рабочем журнале полезна ещё одна отрицательная проверка. Запрос на первом переходе отклонён, а в журнале кабинета по тому же идентификатору нет обращения. Если обращение всё равно произошло, входной отказ сработал слишком поздно или запросы невозможно связать. Повторите прогон на одном тестовом аккаунте и проверьте обе записи по общей метке операции.

Что принять у интегратора

Для команды агентства подойдёт пилот на выгрузке расхода из одного российского рекламного кабинета. Запросите схему из трёх участников и двух переходов. На каждом ребре укажите выдающего разрешение, получателя, допустимую операцию, срок и владельца отзыва. Согласуйте тестовую учётную запись и вид отказа, чтобы не проверять это на чужом бюджете.

Примите интеграцию, если она проходит положительный сценарий и отвергает все четыре отрицательных из таблицы с объяснимой причиной. Отдельно посмотрите, не попадают ли в диагностические логи секреты и заголовки с токенами. Правила хранения и ротации ключей остаются частью эксплуатации. Объём доступных действий можно сверить по матрице полномочий агента. Состав передаваемых данных проверьте по разбору полей отчёта. Термины рекламной интеграции собраны в глоссарии.