Usa Open Cloud con el servidor MCP de Studio

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

El servidor MCP de Studio puede llamar a las API de Open Cloud en tu nombre. Tu cliente MCP puede subir activos, gestionar productos de desarrollador y pases de juego, cambiar configuraciones del juego y más sin crear o pegar una clave API.

Tú decides lo que tu cliente puede hacer. Los permisos se guardan en tu cuenta de Roblox para cada juego, y Studio los aplica en cada solicitud.

Requisitos previos

Antes de usar Open Cloud con el servidor MCP de Studio:

  • Habilita el servidor MCP de Studio y conecta tu cliente. Para más información, consulta Conectar al servidor MCP de Roblox Studio.
  • Abre un lugar que pertenezca a un juego publicado. Los permisos se guardan por juego, por lo que los lugares locales no publicados no pueden usarlos.
  • Tener permiso para gestionar el juego. Si un grupo posee el juego, tu rol en el grupo debe permitir las acciones que otorgues al cliente.

Cómo funciona

El servidor MCP de Studio añade la herramienta open_cloud_invoke. Studio gestiona el acceso por ti. Tu cliente solo puede usar los alcances que has habilitado para el juego actual, y nunca ve ni maneja credenciales. Solo tú puedes cambiar tus permisos. Tu cliente no puede habilitarlos por sí mismo.

Para cada juego, controlas qué alcances de Open Cloud puede llamar tu cliente, qué carpetas puede usar para subir, si las llamadas a la tienda de datos y a la tienda de memoria funcionan desde execute_luau, y si los scripts pueden hacer solicitudes HTTP y a qué dominios.

ParámetroDescripción
methodGET, POST, PUT, PATCH o DELETE.
endpointLa ruta bajo https://apis.roblox.com,incluyendo cualquier cadena de consulta. Por ejemplo,/cloud/v2/universes/123`.
bodyUn cuerpo de solicitud codificado en JSON. Omitir para GET y DELETE.
scopesLos alcances que requiere el endpoint, como ["universe:read"]. Opcional, pero devuelve un error claro si un alcance requerido no está habilitado.
filesArchivos locales para endpoints multipart/form-data, como subidas de activos. Los archivos deben estar en una carpeta de subida aprobada.

Gestionar permisos

Para gestionar los permisos del juego que tienes abierto, haz clic en MCP en la esquina inferior derecha de Studio, luego selecciona la pestaña Permisos MCP. O, desde Assistant:

  1. Abre Assistant.
  2. Haz clic en … ⟩ Configuraciones.
  3. Selecciona la pestaña Permisos MCP.
  4. Habilita o deshabilita permisos. Los cambios se aplican a la próxima solicitud de tu cliente.

Niveles de acceso

Elige un nivel de acceso como punto de partida, luego habilita o deshabilita permisos individuales. Cada juego comienza en Equilibrado.

Nivel de accesoLo que activa
SeguroSolo alcances de bajo riesgo. La mayoría de los permisos están desactivados.
EquilibradoAlcances de bajo y moderado riesgo.
Acceso completoTodos los alcances, incluidos los de alto riesgo que pueden costar Robux, afectar a tus jugadores o publicar en tu juego en vivo.
PersonalizadoSe muestra cuando cambias cualquier permiso después de elegir un nivel.

Roblox establece el nivel de riesgo para cada alcance.

Secciones de permisos

Los permisos se agrupan según lo que permiten que tu cliente haga. Cada sección se mapea a uno o más alcances de Open Cloud o capacidades de script. Para detalles sobre cada alcance, consulta la referencia de alcances de Open Cloud.

SecciónLo que permiteAlcances
Ver tu juegoLeer configuraciones del juego y del lugar, historial de versiones, análisis e instancias.universe:read, universe.place:read, universe.analytics:read, universe.place.instance:read
Editar tu juegoCambiar configuraciones del juego y del lugar, publicar, reiniciar servidores y editar instancias de forma remota.universe:write, universe.place:write, universe.place.instance:write
Jugadores y socialLeer perfiles e inventarios, enviar notificaciones, gestionar grupos y foros, gestionar eventos y leer elementos guardados de la Tienda de Creadores.user.*, group:*, group-forum:read, universe.event:*, creator-store-save:*
Guardar y cargar datosUsar DataStoreService y MemoryStoreService desde execute_luau.universe-datastores.*, universe.ordered-data-store.*, memory-store.*
Conectar a InternetHacer solicitudes HTTP desde Luau a dominios que permitas y publicar mensajes entre servidores.Capacidad Network, universe-messaging-service:publish
Publicar y gestionar activosSubir activos y verificar su estado, compartir activos, gestionar listados de la Tienda de Creadores, publicar versiones de lugares y gestionar miniaturas.asset:*, asset-permissions:write, creator-store-product:*, universe-places:write, universe.thumbnail:*
Dinero y monetizaciónCrear y editar productos de desarrollador, pases de juego y campañas publicitarias, y leer suscripciones.developer-product:*, game-pass:*, ad.campaign:*, ad.billing:read, universe.subscription-product.subscription:read
Consecuencias para los jugadoresLeer, crear y eliminar prohibiciones.universe.user-restriction:*
Seguridad y credencialesLeer nombres secretos y crear secretos, y ejecutar Luau en la nube.universe.secret:*, universe.place.luau-execution-session:*

Carpetas de subida

Tu cliente solo puede subir archivos desde carpetas que apruebes. Agrega una carpeta antes de pedirle a tu cliente que suba activos y mantén las exportaciones allí.

El cliente no puede copiar o mover archivos a una carpeta aprobada para eludir esta restricción. Si un archivo está en otro lugar, muévelo tú mismo o aprueba su carpeta.

Tiendas de datos y tiendas de memoria

Tu cliente accede a las tiendas de datos y a las tiendas de memoria a través de DataStoreService y MemoryStoreService en execute_luau, no a través de Open Cloud. Para usarlas:

  1. Habilita los alcances que necesitas bajo Guardar y cargar datos. Las lecturas requieren universe-datastores.objects:read. Las escrituras requieren universe-datastores.objects:update.
  2. En Configuraciones del juego ⟩ Seguridad, habilita Habilitar acceso de Studio a servicios API. Esta configuración del juego es independiente de tus permisos MCP.

Solicitudes HTTP

Para permitir que los scripts que ejecuta tu cliente hagan solicitudes HTTP con HttpService:

  1. Habilita Conectar a Internet. Esto otorga la capacidad Network de script.
  2. Agrega cada dominio que tu cliente necesite a la lista de permitidos de dominios HTTP.

Studio niega solicitudes a cualquier dominio que no esté en la lista.

Permisos no disponibles

Algunos alcances no pueden ser otorgados a un cliente MCP. Estos incluyen alcances de insignias, universe-datastores.control:*, universe-datastores.objects:create, alertas de análisis y todos los alcances legacy-*. Usa el Tablero de Creadores o una clave API para estas tareas.

Algunos endpoints también rechazan el token que usa Studio, incluso cuando el alcance correspondiente está habilitado. Si eso sucede, tu cliente informa el error y sugiere otra forma de completar la tarea.

Importar un modelo 3D

Importar activos desde Blender, Maya u otra herramienta 3D es un flujo de trabajo común. Tu cliente exporta el modelo, lo sube, lo inserta y luego compara el resultado con la fuente y corrige lo que cambió la importación.

Para importar un modelo:

  1. Habilita Publicar y gestionar activos ⟩ asset:read y asset:write.

  2. Aprueba la carpeta en la que van tus exportaciones.

  3. Abre el modelo en tu herramienta 3D, o expórtalo como .glb o .fbx en la carpeta aprobada.

  4. Indica a tu cliente. Por ejemplo:

    Importa el castillo de mi archivo de Blender abierto en Studio, junto al punto de aparición.

La habilidad de importación le dice a tu cliente que confirme antes de subir. Luego:

  • Verifica cada malla contra el límite de triángulos y pregunta si debe dividir o simplificar cualquier malla que lo exceda.
  • Sube el modelo y espera la moderación.
  • Inserta el modelo y corrige la escala, rotación, texturas faltantes, colores y anclaje.
  • Coloca el modelo en el suelo, alejado de otros objetos y puntos de aparición.

Para tipos de activos, formatos y límites de tamaño admitidos, consulta la Guía de uso para activos.

Habilidades

Las siguientes habilidades enseñan a tu cliente cómo usar estos permisos. Los clientes conectados a través de MCP las obtienen automáticamente y las cargan con la herramienta skill. Para verlas, abre Assistant, haz clic en … ⟩ Configuraciones de Assistant, luego selecciona Habilidades. Para adaptar una a tu flujo de trabajo, selecciónala y haz clic en Duplicar, luego edita tu copia. Tu copia reemplaza la original, pero no recibe actualizaciones futuras.

HabilidadDescripción
rbx-open-cloud-usageLlama a Open Cloud con open_cloud_invoke, selecciona el endpoint correcto y maneja errores.
rbx-permissionsDetermina qué permisos necesita una tarea, verifica cuáles están habilitados y te pregunta solo por los que faltan.
rbx-import-assetImporta un modelo desde una herramienta 3D externa, luego lo verifica y corrige en Studio.

Solución de problemas

Cuando una solicitud es bloqueada, el cliente informa lo que falta. Nunca elude un permiso que hayas desactivado.

ErrorCausaSolución
Scope '<scope>' has not been grantedEl alcance está desactivado o el nombre está mal escrito.Habilita el alcance en la sección correspondiente.
HTTP 403 o 401, con el alcance habilitadoEl endpoint no acepta el token MCP.Usa el Tablero de Creadores o una clave API para esta tarea.
lacking capability <capability>Un script necesita una capacidad que no está otorgada.Habilita Conectar a Internet para Network. Otras capacidades no pueden ser otorgadas.
domain <domain> is not in the Assistant HTTP allowlistEl dominio no está en tu lista de permitidos.Agrega el dominio bajo Conectar a Internet ⟩ Lista de dominios HTTP permitidos.
502 … Access forbidden de una llamada a la tienda de datosEl alcance correspondiente de Guardar y cargar datos está desactivado.Habilita el alcance de lectura o actualización.
Studio access to APIs is not allowedEl acceso a la API de Studio está desactivado para este juego.Habilita Configuraciones del juego ⟩ Seguridad ⟩ Habilitar acceso de Studio a servicios API.
InternalError de una llamada a la tienda de memoriaLos alcances memory-store.* están desactivados.Habilita los alcances de la tienda de memoria bajo Guardar y cargar datos.
Archivo no en un directorio de subida aprobadoEl archivo está fuera de tus carpetas aprobadas.Aprueba la carpeta o mueve el archivo a una aprobada.
©2026 Roblox Corporation. Roblox, el logotipo de Roblox y "Powering Imagination" son algunas de nuestras marcas registradas y no registradas en los Estados Unidos y otros países.