# Dejar que un agente despliegue Desplegar con Claude Code sin entregar la organización. Permisos agente de IA, un token por organización y qué no debe ver el agente. Canonical URL: https://unbroker.cloud/es/blog/coding-agent-deploy-safely Published: 2026-10-27 Reviewed: 2026-10-27 Author: Unbroker ## La respuesta corta El riesgo es la credencial, no el agente. Un token de lectura de una sola organización puede inspeccionar el proyecto. No puede crear ni cambiar nada hasta que emitas un token más amplio. Desplegar con Claude Code, o con otro agente, pide ese token, una organización, un proyecto y un servicio con nombre, y un despliegue que llegue a un estado terminal. Unbroker es el ejemplo. El mismo reparto vale para [Claude Code](https://unbroker.cloud/deploy/claude-code), [Codex](https://unbroker.cloud/es/desplegar/codex) y [Cursor](https://unbroker.cloud/es/desplegar/cursor). ## Qué hace un agente de código cuando despliega Ejecuta `ubctl`, la misma CLI que usarías en una terminal. No aloja la aplicación. Los permisos agente de IA son el alcance del token más tu rol en esa organización. Instalar `ubctl-ops` no crea una cuenta, no emite un token y no despliega solo por estar instalada. [Instala la skill](https://docs.unbroker.cloud/guides/install-agent-skill) después de `ubctl login`, y lee [agentes de código](https://unbroker.cloud/agents). Claude Code usa `/ubctl-ops`. Codex usa `$ubctl-ops`. ## Empieza en solo lectura Empieza con un token de lectura y una tarea que solo liste proyectos. Ese token alcanza para inspeccionar. No puede crear ni cambiar recursos. El primer prompt de la guía de instalación pide la organización activa y sus proyectos, y dice que no cree ni modifique nada. Comprueba que `ubctl whoami` nombre esa organización. En MCP, un token de lectura puede conectar y listar herramientas, y una llamada de escritura devuelve un error de solo lectura. El alcance del token del servidor MCP es ese mismo alcance de lectura o de lectura y escritura. La referencia está en la [documentación de MCP](https://docs.unbroker.cloud/integrations/mcp). ## Un token por agente y por organización Cada token de API pertenece a una sola organización, la que estaba seleccionada en Cloud al crearlo. Un token de una organización no entra en otra. Crea un token distinto para cada agente, en esa organización, para poder revocar un cliente sin tocar a los demás. Cloud muestra el secreto una sola vez. `ubctl login` lo guarda en local con permisos solo para el dueño del archivo. No uses `ubctl login --token` en una computadora compartida: el valor puede quedar en el historial del shell. En el MCP de Codex, la configuración guarda el nombre de la variable de entorno, no el valor del token. Los roles owner y admin activan MCP por organización en Settings, luego Integrations, en `https://api.unbroker.cloud/mcp`. Mira la [documentación de MCP](https://docs.unbroker.cloud/integrations/mcp) y el [registro de MCP](https://unbroker.cloud/changelog/2026-10-15-mcp-and-live-dashboard). ## Deja los secretos fuera de la conversación Carga los valores secretos en Cloud. Dile al agente qué claves necesita el servicio, y no pegues los valores en el chat, un repositorio, una captura o un issue. La inspección de servicios por MCP no devuelve credenciales ni valores de variables de entorno. Cada variable tiene alcance All, Production o Preview, y un valor con alcance pisa el de All en ese entorno. Un preview puede usar una clave de prueba sin leer el valor de producción. Eso está en [variables por entorno](https://unbroker.cloud/changelog/2026-10-06-environment-scoped-variables). ## Límites antes de tocar producción Nombra la organización, el proyecto y el servicio, y espera a que el despliegue termine. Un despliegue en cola no es un release terminado. El acceso de producción llega después del paso de solo lectura. Los previews de pull request piden Pro, y cerrar el pull request elimina ese preview. Di si el agente puede crear recursos. Crear un servicio no lo despliega, y crear recursos o dejar un servicio corriendo puede generar cargos. La espera documentada es `ubctl apps deploy --wait`, que sale con error si el despliegue falla. El prompt está en [Desplegar una aplicación con Claude Code](https://docs.unbroker.cloud/guides/deploy-with-claude-code). [El glosario de NIST](https://csrc.nist.gov/glossary/term/least_privilege/) describe el mínimo privilegio como restringir el acceso a lo necesario para la tarea. ## Cuando el despliegue sale mal Lee el log del despliegue y los logs de runtime, y corrige esa causa antes de reintentar. Un rollback es otro despliegue, y no vuelve a ejecutar el comando pre-deploy. `ubctl apps rollback` promueve un despliegue anterior. Muestra progreso y logs, se puede cancelar y queda en el historial. No reconstruye el commit, y no restaura una base de datos ni un volumen. Como el pre-deploy no corre, deja las migraciones compatibles hacia atrás. La CLI también expone métricas del servicio. Un comando manual de una vez, o una ejecución de job, registra quién lo lanzó y a qué servicio pertenece. El texto del comando queda en esa ejecución, no en el feed de actividad de toda la organización. Mira [comandos auditados](https://unbroker.cloud/changelog/2026-10-08-audited-commands). ## Lista antes de dejar que el agente despliegue Termina esta lista antes de que el token pueda cambiar producción. La lista es el límite. No reemplaza el log del despliegue. 1. Crea el token con la organización correcta seleccionada en Cloud. 2. Usa alcance de lectura hasta que `ubctl whoami` y la lista de proyectos coincidan. 3. Emite un token para este agente, y otro token para cada organización distinta. 4. Deja el secreto fuera del prompt, del repositorio y del historial del shell. 5. Nombra la organización, el proyecto y el servicio en la tarea. 6. Carga los valores secretos en Cloud. Dale al agente solo los nombres de las claves. 7. Espera un estado terminal. No trates en cola como publicado. 8. Usa un preview de pull request en Pro, con variables de alcance Preview, antes de producción. 9. Si haces rollback, espera un despliegue que salta el pre-deploy. Mantén las migraciones compatibles hacia atrás. ## Preguntas frecuentes ### ¿Es seguro dejar que Claude Code o Codex desplieguen mi app? Solo hasta el límite del token que le diste a ese agente. Un token de lectura lista e inspecciona. Uno de lectura y escritura puede crear y cambiar recursos, y esos cambios pueden generar cargos. Empieza con la [tarea de solo lectura](https://docs.unbroker.cloud/guides/install-agent-skill). ### ¿Qué permisos necesita un agente de código? Inspeccionar pide un token de lectura. Crear, desplegar o cambiar un recurso pide alcance de lectura y escritura, y los permisos de la organización para esa acción. La skill no agrega permisos propios. Cada [token de API](https://docs.unbroker.cloud/cli/get-started) pertenece a una organización. ### ¿Le doy a mi agente de IA un token de API de producción? No en la primera tarea. Usa un token de lectura, confirma la organización con ubctl whoami y usa un preview antes de producción. El acceso de producción puede esperar a que el proyecto y el servicio estén nombrados. ### ¿Cómo evito que un agente de IA vea mis secretos? Carga los valores en Cloud y dale al agente solo los nombres de las claves. No pegues tokens ni valores de variables en el chat, el repositorio o una captura. La inspección de servicios por MCP no devuelve credenciales ni valores de variables. ### ¿Puedo revocar el acceso de un agente sin romper otras integraciones? Sí, si ese agente tiene su propio token. Revócalo en API Tokens. Los demás tokens siguen funcionando, y desactivar MCP en la organización bloquea MCP sin revocar tokens ni el acceso REST. ### Si el despliegue falla, ¿puedo volver atrás? Sí. ubctl apps rollback promueve un despliegue anterior. Es un despliegue real, con progreso y logs, y no vuelve a ejecutar el comando pre-deploy. No reconstruye el commit, y no restaura una base de datos ni un volumen. ### ¿Claude Code aloja mi app? No. Claude Code ejecuta ubctl. El alojamiento, el build y la URL pública son Cloud Apps de Unbroker. Lo mismo vale para Codex y para Cursor cuando llaman a la misma API. ## Related reading - [Desplegar con Claude Code](https://unbroker.cloud/deploy/claude-code) - [Desplegar con Codex](https://unbroker.cloud/es/desplegar/codex) - [Desplegar una app de Cursor](https://unbroker.cloud/es/desplegar/cursor) - [Agentes de código](https://unbroker.cloud/agents) - [Registro del servidor MCP](https://unbroker.cloud/changelog/2026-10-15-mcp-and-live-dashboard)