Перейти к содержанию
Меню документации

Пользователи приложения, разрешения и организации

На этой странице

Осознанно выбирайте среду: предпросмотр или продакшен. Сущность организации — это организация-клиент. В аргументах инструментов, которые это поддерживают, её slug обозначает границу этой организации.

Как пользоваться инструментами

  1. Сначала вызовите подходящий инструмент чтения или проверки статуса.
  2. Проверьте расположение проекта и обязательные аргументы.
  3. Запустите одно запланированное действие. Если нужно явное подтверждение человека, сначала получите его.
  4. Затем проверьте статус или заново прочитайте затронутый ресурс.

Ниже описаны входные параметры публичного контракта. Ориентируйтесь на текущий список инструментов подключённого сервера. Некоторым инструментам нужен определённый хост, расположение проекта, режим инференса или план. Идентификаторы — это значения, которые вернули предыдущие инструменты; не придумывайте их.

app_users

Пользователи сгенерированного приложения.

Прочитайте возвращённый ресурс. Следующее действие планируйте по его текущим значениям.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
all Нет логическое значение

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

manage_app_user

Пригласить пользователя приложения, изменить его данные или удалить его.

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

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
action Да invite, update, remove
email Нет строка; минимальная длина 3; максимальная длина 254
name Нет строка; минимальная длина 1; максимальная длина 128
role Нет строка; минимальная длина 1; максимальная длина 32
disabled Нет логическое значение
profileId Нет строка; минимальная длина 1; максимальная длина 256
confirm Нет логическое значение

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

app_permissions

Разрешения в сгенерированном приложении.

Прочитайте возвращённый ресурс. Следующее действие планируйте по его текущим значениям.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

set_app_permission_default

Задать, кому разрешение предоставляется по умолчанию.

Меняет получателя разрешения по умолчанию. Затем проверьте доступ у двух пользователей: у одного он должен быть разрешён, у другого — запрещён.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
permission Да строка; минимальная длина 1; максимальная длина 128
defaultClass Нет none, user, member, owner
entityScoped Нет логическое значение

Операция: может изменить состояние или запустить работу.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

app_grants

Кому и какие разрешения предоставлены в сгенерированном приложении.

Прочитайте возвращённый ресурс. Следующее действие планируйте по его текущим значениям.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
profileId Нет строка; минимальная длина 1; максимальная длина 256
group Нет строка; минимальная длина 1; максимальная длина 128
entitySlug Нет строка; минимальная длина 1; максимальная длина 63

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

manage_app_grant

Предоставить или отозвать разрешение в сгенерированном приложении.

Выдавайте и отзывайте только нужное разрешение и только для нужной аудитории. Чтобы ограничить действие организацией-клиентом, укажите entitySlug.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
action Да assign, revoke
permission Да строка; минимальная длина 1; максимальная длина 128
profileId Нет строка; минимальная длина 1; максимальная длина 256
group Нет строка; минимальная длина 1; максимальная длина 128
entitySlug Нет строка; минимальная длина 1; максимальная длина 63
resources Нет массив строк
mode Нет blanket, resources, all

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

app_organizations

Организации в сгенерированном приложении.

Прочитайте возвращённый ресурс. Следующее действие планируйте по его текущим значениям.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
entitySlug Нет строка; минимальная длина 1; максимальная длина 63

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

manage_app_organization

Переименовать организацию или управлять её участниками.

Меняет названия организаций-клиентов и состав участников. Убедитесь, что выбраны нужная сущность организации и нужный пользователь.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
action Да rename, add-member, update-member, remove-member
entitySlug Да строка; минимальная длина 1; максимальная длина 63
title Нет строка; минимальная длина 1; максимальная длина 256
email Нет строка; минимальная длина 3; максимальная длина 254
name Нет строка; минимальная длина 1; максимальная длина 128
owner Нет логическое значение
profileId Нет строка; минимальная длина 1; максимальная длина 256
groups Нет массив строк

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

app_groups

Группы организации в сгенерированном приложении.

Прочитайте возвращённый ресурс. Следующее действие планируйте по его текущим значениям.

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
entitySlug Да строка; минимальная длина 1; максимальная длина 63
group Нет строка; минимальная длина 1; максимальная длина 128

Операция: только чтение.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

manage_app_group

Создать, изменить или удалить группу либо управлять её участниками.

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

Аргумент Обязательный Тип или допустимые значения
projectId Нет строка
scope Нет ephemeral, production
action Да create, update, delete, add-members, remove-members
entitySlug Да строка; минимальная длина 1; максимальная длина 63
group Да строка; минимальная длина 1; максимальная длина 128
title Нет строка; минимальная длина 1; максимальная длина 256
bundles Нет массив объектов
profileIds Нет массив строк
confirm Нет логическое значение

Операция: может изменить состояние или запустить работу; возможны деструктивные изменения.

Доступные конфигурации: stdio, облачный проект, облачный инференс; stdio, облачный проект, делегированный инференс; stdio, локальный проект, облачный инференс; stdio, локальный проект, делегированный инференс; облачное подключение по HTTP.

В машиночитаемых контрактах инструментов приведены вложенные схемы аргументов.

Связанные справочные материалы

Главная страница MCP · Процесс восстановления работы · Стоимость