MCP-сервер управления организацией

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

Это предварительная версия MCP-сервера

Используйте ее для ознакомления и тестирования.

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

Перед подключением ознакомьтесь с правилами безопасности.

Агент действует с правами пользователя, чей OAuth-токен используется для подключения. Если у пользователя нет прав администратора или нужных разрешений, агент не сможет выполнить административное действие.

Как подключить

Чтобы подключить MCP-сервер:

Получите OAuth-токен для доступа к управлению организацией:
1. Перейдите по ссылке: получить OAuth-токен.
2. Если потребуется, войдите в аккаунт администратора организации.
3. Проверьте доступы, которые получит ИИ-агент. Все они нужны для правильной работы MCP-сервера.
  
  Как это выглядит
4. Скопируйте значение токена с открывшейся страницы и сохраните его.

Добавьте конфигурацию MCP-сервера в настройки вашего ИИ-инструмента:

{
  "mcpServers": {
    "yandex_admin": {
      "type": "http",
      "url": "https://mcp.360.yandex.net/v1/admin/mcp",
      "headers": {
        "Authorization": "OAuth <OAuth_токен>"
      }
    }
  }
}

Вместо <OAuth_токен> подставьте OAuth-токен администратора, полученный на предыдущем шаге.

Примеры подключения

Способ добавления MCP-конфигурации зависит от конкретного инструмента. Обычно достаточно указать URL MCP-сервера и заголовок с OAuth-токеном.

Codex

Через интерфейс

В файле конфигурации

Чтобы добавить MCP-сервер управления организацией в Codex:

На боковой панели выберите Плагины. В блоке Установленные нажмите кнопку .

Где находятся настройки плагинов
Нажмите кнопку Добавить и выберите Добавить сервер MCP.

Как добавить MCP-сервер
Заполните поля:
- Имя — название MCP-сервера латинскими буквами, например yandex admin.
- Тип — Потоковая передача HTTP.
- URL — https://mcp.360.yandex.net/v1/admin/mcp.
- Заголовки — в поле Ключ укажите Authorization, а в поле Значение — OAuth <OAuth_токен>.
Остальные поля оставьте пустыми.

Пример заполнения полей
Нажмите кнопку Сохранить. MCP-сервер появится в списке на странице Серверы.

В файл .codex/config.toml добавьте:

[mcp_servers.yandex_admin]
url = "https://mcp.360.yandex.net/v1/admin/mcp"
http_headers = {
    "Authorization" = "OAuth <OAuth_токен>",
}

Чтобы проверить подключение, попросите агента в чате показать сведения о вашей организации. Если MCP-сервер подключен, агент запросит данные об организации.

Claude Code

Чтобы добавить MCP-сервер управления организацией в Claude Code, выполните команду:

claude mcp add --transport http yandex_admin https://mcp.360.yandex.net/v1/admin/mcp \
    --header "Authorization: OAuth <OAuth_токен>"

Доступные инструменты

Инструмент	Зачем нужен
admin.list_organizations	Получить список организаций, доступных пользователю
admin.get_organization	Получить сведения об организации
admin.list_users	Получить список сотрудников. Инструмент поддерживает точный фильтр по логину `nickname`
admin.get_user	Получить карточку сотрудника
admin.create_user	Создать доменного сотрудника
admin.update_user	Изменить данные сотрудника
admin.list_groups	Получить список групп организации
admin.get_group	Получить сведения о группе
admin.create_group	Создать группу
admin.update_group	Изменить параметры группы
admin.delete_group	Удалить группу
admin.list_group_members	Получить список участников группы
admin.add_group_members	Добавить участников в группу
admin.remove_group_members	Удалить участников из группы
admin.list_departments	Получить список подразделений организации
admin.get_department	Получить сведения о подразделении
admin.create_department	Создать подразделение
admin.update_department	Изменить параметры подразделения
admin.delete_department	Удалить подразделение

Что можно сделать с помощью MCP-сервера

После подключения MCP-сервера агент самостоятельно выбирает нужные инструменты для решения задачи. Пользователю достаточно сформулировать поручение: например, попросить найти сотрудника, создать группу или создать подразделение.

Найти сотрудника

Промпт:

Найди сотрудника с логином <логин> и покажи его должность, подразделение и группы.

Агент найдет сотрудника по точному логину и получит его карточку. Вы получите сведения о сотруднике без ручного поиска в кабинете организации.