Собственное приложение · Пошаговая инструкция
Как создать OAuth-приложение Яндекса
Создайте приложение, получите доступ к API Яндекс.Директа и сохраните его данные в MCPKit — чтобы работать со своими рекламными аккаунтами через ИИ-ассистента.
Перед началом
OAuth-приложение позволяет MCPKit запрашивать разрешение на доступ к данным Яндекс.Директа. Само создание приложения не даёт доступа к рекламным аккаунтам: после настройки каждый аккаунт нужно отдельно авторизовать.
Вам понадобятся аккаунт Яндекса с доступом к Директу, действующая почта для связи и учётная запись MCPKit. Создавайте приложение под логином, доступ к которому сможете сохранить.
Нажмите на любой скриншот, чтобы рассмотреть его в полном размере.
Создайте OAuth-приложение
Откройте Яндекс OAuth
Перейдите на Яндекс OAuth. На странице «Ваши приложения» нажмите «Создать».
Выберите «Для доступа к API или отладки» и нажмите «Перейти к созданию».
Укажите данные и разрешения
Заполните название приложения и электронную почту для связи. В разделе «Доступ к данным» найдите и добавьте два разрешения:
- Использование API Яндекс.Директа —
direct:api. - Работа с организациями Яндекс ID —
passport:business.
Для выбранного типа приложения Яндекс показывает Redirect URI https://oauth.yandex.ru/verification_code. MCPKit использует этот адрес для получения кода авторизации; подставлять адрес панели MCPKit не нужно.
Нажмите «Создать приложение». На странице созданного приложения появятся Client ID и Client Secret (Secret Key). Они понадобятся на третьем этапе. Приложение также появится в списке «Ваши приложения».
Подробнее: регистрация приложения для доступа к API в документации Яндекса.
Получите доступ к API Яндекс.Директа
Создайте заявку
Под тем же логином откройте Яндекс.Директ и перейдите в «Инструменты» → «API» → «Мои заявки». При первом обращении к разделу может потребоваться нажать «Получить доступ к API» и принять пользовательское соглашение.
Нажмите «Новая заявка».
Выберите Client ID созданного OAuth-приложения. Укажите актуальные контакты и достоверные сведения о себе или компании.
Опишите назначение приложения
В разделе «Технические данные о приложении» для работы через MCPKit укажите:
- Язык программирования: Python.
- Протокол: JSON.
- Логины Яндекс.Директа: аккаунты, с которыми вы планируете работать.
Отметьте необходимые функции и объясните, какие задачи будете решать: например, получать статистику и отчёты, анализировать кампании или управлять рекламой. Описывайте только те операции, которые действительно планируете использовать.
Если форма просит презентацию или схему, подготовьте краткое описание сценария: вы → ИИ-ассистент → MCPKit → API Яндекс.Директа. Покажите, какие данные нужны и какие действия выполняются с вашего разрешения. ChatGPT может помочь с текстом и схемой; перед отправкой проверьте их точность.
Загрузите материалы, заполните оставшиеся обязательные поля, примите пользовательское соглашение и отправьте заявку.
Дождитесь одобрения
Следите за статусом в разделе «Мои заявки»: после отправки заявка получает статус «Новая», а после успешной проверки — «Одобрена».
Если заявка отклонена, изучите причину, исправьте сведения и отправьте её повторно. Одобрение приложения разрешает использование API, но не заменяет авторизацию рекламных аккаунтов.
Подробнее: регистрация приложения и рассмотрение заявки и подача заявки на доступ к API.
Подключите приложение к MCPKit
Выберите собственное приложение
Войдите в панель управления MCPKit. Откройте блок «OAuth-приложение» и выберите «Собственное OAuth-приложение».
Сохраните Client ID и Client Secret
В открывшемся окне укажите идентификатор Client ID и секретный ключ Client Secret со страницы приложения в Яндекс OAuth. Нажмите «Сохранить».
Подключите рекламные аккаунты
Убедитесь, что в блоке «OAuth-приложение» выбран собственный вариант. Затем откройте «Аккаунты Яндекс.Директа» и пройдите авторизацию нужных аккаунтов. Если они ещё не добавлены, подключите их по подсказкам панели.