Пользователи приложения, разрешения и организации
На этой странице
Осознанно выбирайте среду: предпросмотр или продакшен. Сущность организации — это организация-клиент. В аргументах инструментов, которые это поддерживают, её slug обозначает границу этой организации.
Как пользоваться инструментами
- Сначала вызовите подходящий инструмент чтения или проверки статуса.
- Проверьте расположение проекта и обязательные аргументы.
- Запустите одно запланированное действие. Если нужно явное подтверждение человека, сначала получите его.
- Затем проверьте статус или заново прочитайте затронутый ресурс.
Ниже описаны входные параметры публичного контракта. Ориентируйтесь на текущий список инструментов подключённого сервера. Некоторым инструментам нужен определённый хост, расположение проекта, режим инференса или план. Идентификаторы — это значения, которые вернули предыдущие инструменты; не придумывайте их.
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 · Процесс восстановления работы · Стоимость