Saltar al contenido
Menú de documentación

Usuarios, permisos y organizaciones de la aplicación

En esta página

Elija entre vista previa y producción de manera consciente. Una entidad de organización representa a la organización del cliente; el slug identifica ese ámbito en los argumentos de las herramientas que lo admiten.

Usar estas herramientas

  1. Llame primero a la herramienta de lectura o de consulta de estado correspondiente.
  2. Revise el destino y los argumentos obligatorios.
  3. Ejecute una sola acción prevista, con confirmación humana explícita cuando sea necesaria.
  4. Después, consulte el estado o vuelva a leer el recurso afectado.

Los parámetros que se indican a continuación describen el contrato público. La lista actual de herramientas del servidor conectado es la referencia definitiva. Algunas herramientas requieren un host, un destino, un modo de inferencia o un plan concretos. Los identificadores son valores que devuelven las herramientas llamadas antes; no los invente.

app_users

Los usuarios de la aplicación generada.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
all No booleano

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

manage_app_user

Invitar, actualizar o eliminar a un usuario de la aplicación.

Eliminar o deshabilitar a un usuario puede impedirle el acceso. Revise el ámbito y el perfil seleccionado antes de confirmar cambios destructivos.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
action Sí invite, update, remove
email No cadena; longitud mínima 3; longitud máxima 254
name No cadena; longitud mínima 1; longitud máxima 128
role No cadena; longitud mínima 1; longitud máxima 32
disabled No booleano
profileId No cadena; longitud mínima 1; longitud máxima 256
confirm No booleano

Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

app_permissions

Los permisos de la aplicación generada.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

set_app_permission_default

Establecer quién recibe un permiso de forma predeterminada.

Cambia quién recibe un permiso de forma predeterminada. Después, haga una prueba con un usuario que tenga acceso permitido y otro que tenga acceso denegado.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
permission Sí cadena; longitud mínima 1; longitud máxima 128
defaultClass No none, user, member, owner
entityScoped No booleano

Operación: puede cambiar el estado o iniciar trabajo.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

app_grants

Quién tiene cada permiso en la aplicación generada.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
profileId No cadena; longitud mínima 1; longitud máxima 256
group No cadena; longitud mínima 1; longitud máxima 128
entitySlug No cadena; longitud mínima 1; longitud máxima 63

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

manage_app_grant

Conceder o revocar un permiso en la aplicación generada.

Conceda o revoque únicamente el permiso previsto y solo para los destinatarios previstos. Utilice entitySlug para delimitar el ámbito de una organización del cliente.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
action Sí assign, revoke
permission Sí cadena; longitud mínima 1; longitud máxima 128
profileId No cadena; longitud mínima 1; longitud máxima 256
group No cadena; longitud mínima 1; longitud máxima 128
entitySlug No cadena; longitud mínima 1; longitud máxima 63
resources No lista de cadenas
mode No blanket, resources, all

Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

app_organizations

Las organizaciones de la aplicación generada.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
entitySlug No cadena; longitud mínima 1; longitud máxima 63

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

manage_app_organization

Cambiar el nombre de una organización o gestionar sus miembros.

Gestiona los títulos y los miembros de las organizaciones del cliente. Confirme que la entidad de organización y el usuario sean los previstos.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
action Sí rename, add-member, update-member, remove-member
entitySlug Sí cadena; longitud mínima 1; longitud máxima 63
title No cadena; longitud mínima 1; longitud máxima 256
email No cadena; longitud mínima 3; longitud máxima 254
name No cadena; longitud mínima 1; longitud máxima 128
owner No booleano
profileId No cadena; longitud mínima 1; longitud máxima 256
groups No lista de cadenas

Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

app_groups

Los grupos de una organización en la aplicación generada.

Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
entitySlug Sí cadena; longitud mínima 1; longitud máxima 63
group No cadena; longitud mínima 1; longitud máxima 128

Operación: solo lectura.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

manage_app_group

Crear, modificar o eliminar un grupo, o gestionar sus miembros.

La pertenencia a grupos y los conjuntos de permisos afectan al acceso de los usuarios. Compruebe el grupo y el ámbito antes de modificarlo o eliminarlo.

Argumento Obligatorio Tipo o valores aceptados
projectId No cadena
scope No ephemeral, production
action Sí create, update, delete, add-members, remove-members
entitySlug Sí cadena; longitud mínima 1; longitud máxima 63
group Sí cadena; longitud mínima 1; longitud máxima 128
title No cadena; longitud mínima 1; longitud máxima 256
bundles No lista de objetos
profileIds No lista de cadenas
confirm No booleano

Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.

Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.

Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.

Referencias relacionadas

Inicio de MCP · Flujo de recuperación · Costos