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ámetro | Descripción |
|---|---|
| method | GET, POST, PUT, PATCH o DELETE. |
| endpoint | La ruta bajo https://apis.roblox.com,incluyendo cualquier cadena de consulta. Por ejemplo,/cloud/v2/universes/123`. |
| body | Un cuerpo de solicitud codificado en JSON. Omitir para GET y DELETE. |
| scopes | Los alcances que requiere el endpoint, como ["universe:read"]. Opcional, pero devuelve un error claro si un alcance requerido no está habilitado. |
| files | Archivos 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:
- Abre Assistant.
- Haz clic en … ⟩ Configuraciones.
- Selecciona la pestaña Permisos MCP.
- 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 acceso | Lo que activa |
|---|---|
| Seguro | Solo alcances de bajo riesgo. La mayoría de los permisos están desactivados. |
| Equilibrado | Alcances de bajo y moderado riesgo. |
| Acceso completo | Todos los alcances, incluidos los de alto riesgo que pueden costar Robux, afectar a tus jugadores o publicar en tu juego en vivo. |
| Personalizado | Se 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ón | Lo que permite | Alcances |
|---|---|---|
| Ver tu juego | Leer 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 juego | Cambiar 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 social | Leer 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 datos | Usar DataStoreService y MemoryStoreService desde execute_luau. | universe-datastores.*, universe.ordered-data-store.*, memory-store.* |
| Conectar a Internet | Hacer solicitudes HTTP desde Luau a dominios que permitas y publicar mensajes entre servidores. | Capacidad Network, universe-messaging-service:publish |
| Publicar y gestionar activos | Subir 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ón | Crear 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 jugadores | Leer, crear y eliminar prohibiciones. | universe.user-restriction:* |
| Seguridad y credenciales | Leer 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:
- Habilita los alcances que necesitas bajo Guardar y cargar datos. Las lecturas requieren universe-datastores.objects:read. Las escrituras requieren universe-datastores.objects:update.
- 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:
- 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:
Habilita Publicar y gestionar activos ⟩ asset:read y asset:write.
Aprueba la carpeta en la que van tus exportaciones.
Abre el modelo en tu herramienta 3D, o expórtalo como .glb o .fbx en la carpeta aprobada.
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.
| Habilidad | Descripción |
|---|---|
| rbx-open-cloud-usage | Llama a Open Cloud con open_cloud_invoke, selecciona el endpoint correcto y maneja errores. |
| rbx-permissions | Determina qué permisos necesita una tarea, verifica cuáles están habilitados y te pregunta solo por los que faltan. |
| rbx-import-asset | Importa 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.
| Error | Causa | Solución |
|---|---|---|
| Scope '<scope>' has not been granted | El alcance está desactivado o el nombre está mal escrito. | Habilita el alcance en la sección correspondiente. |
| HTTP 403 o 401, con el alcance habilitado | El 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 allowlist | El 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 datos | El alcance correspondiente de Guardar y cargar datos está desactivado. | Habilita el alcance de lectura o actualización. |
| Studio access to APIs is not allowed | El 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 memoria | Los 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 aprobado | El archivo está fuera de tus carpetas aprobadas. | Aprueba la carpeta o mueve el archivo a una aprobada. |