Ir al contenido
Operar

Conecta un agente de IA

Deja que Claude, Cursor u otro agente de IA trabaje por ti en tu panel: ver tus proyectos, leer logs, desplegar, hacer una copia de seguridad. Actúa como tú y te pide aprobación antes de borrar, gastar o dar acceso.

Tiempo · 5 min Necesitas · Un cliente de agentes de IA y un panel

Objetivo

Tendrás un agente de IA conectado a tu panel, con tu usuario, que se detiene y te pregunta antes de cualquier cosa que no se pueda deshacer o que cueste dinero.

Qué puede hacer un agente

Un agente puede hacer lo que tú haces en el panel, y nada más: usa tu rol y los proyectos a los que tienes acceso. Puede ver proyectos e instancias, leer logs, desplegar, hacer copias de seguridad, clonar un staging y cambiar ajustes.

Algunas cosas se quedan en el panel a propósito. Las contraseñas, claves y tokens nunca llegan al agente y este no puede establecerlos. Subir una copia de seguridad para restaurarla y las terminales interactivas tampoco están a su alcance.

Pasos

  1. Abre la página de conexión. En tu panel, abre el menú de usuario (tu nombre, arriba a la derecha) y elige Conectar un agente. Muestra la dirección MCP de tu panel, con un botón para copiarla, y los pasos de cada cliente con esa dirección ya puesta.
  2. Añade el panel a tu cliente. La página cubre Claude Code, Claude y Claude Desktop, Cursor, VS Code y Codex. En Claude Code, por ejemplo, ejecutas esto con la dirección de tu panel:
    claude mcp add --transport http --scope user incubacloud 'https://<tu panel>/mcp'
  3. Inicia sesión con IncubaCloud. La primera vez, el agente abre una página donde inicias sesión con tu cuenta de IncubaCloud, como haces en el navegador. Si te invitaron a un panel y nunca lo abriste, ábrelo antes una vez para que exista tu usuario.
  4. Permite el agente. La página nombra al agente y al panel al que quiere llegar. Permite solo un agente que hayas iniciado tú. Elige Permitir, o Cancelar para rechazarlo.

Comprueba que funciona

  • Pide al agente que liste tus proyectos: responde con los tuyos.
  • Aparece en Agentes conectados, con el panel y el día en que lo permitiste.

Lo que siempre te pide confirmación

Algunas acciones esperan por ti, lo que pida el agente. Hasta que apruebes, no ocurre nada:

  • Gastar dinero: contratar un VPS, contratar, cambiar o cancelar almacenamiento de copias, cambiar tu plan, añadir o quitar extras. La aprobación muestra el importe y cada cuánto se factura, sin IVA.
  • Dar o quitar acceso: invitar a un usuario, cambiar un rol, quitar o reactivar a un usuario.
  • Borrar datos: un proyecto, una instancia, un servidor o un destino de copias. Restaurar una copia, reemplazar los datos de un staging con una copia de producción y mover una instancia también esperan por ti.
  • Llegar a tus instancias y servidores: un enlace de acceso a una instancia, un enlace de descarga de una copia, un comando en una instancia de producción y todos los comandos en un servidor. Ves el comando exacto.
  • Seguridad: cambiar un ajuste de seguridad y confiar en la clave SSH de un servidor. Ves los valores antes y después, o la clave anterior y la nueva.

Según tu cliente, ves una pregunta de sí o no dentro de él, o el panel abre una página de aprobación, o el agente te da el enlace a esa página. La página necesita tu sesión del panel y muestra lo que va a ocurrir, con Aprobar y Cancelar. Una aprobación dura diez minutos y vale una sola vez, solo para el agente que la pidió.

De qué te protege una aprobación

Te protege de los errores del agente y de instrucciones escondidas en un log o en un correo que el agente lea. No te protege de un cliente en el que no debas confiar, ni de un agente que maneje tu navegador mientras tu panel está abierto. Conecta solo clientes de confianza y revoca los que dejes de considerar así.

Ver y revocar tus agentes

Abre Mi IncubaCloud y busca Agentes conectados al final de la página. Lista cada agente con su panel, cuándo lo permitiste y cuándo se usó por última vez. Revocar lo corta: su acceso termina en cinco minutos como máximo y no puede renovarlo. Un agente que pasa 30 días sin usarse se corta solo.

Cerrar sesión

Cerrar sesión en tu cuenta de IncubaCloud no desconecta a tus agentes: no dependen de la sesión de tu navegador. Para cortar uno, revócalo en Agentes conectados.

Paneles autoalojados y claves de API

Los paneles alojados por IncubaCloud inician sesión de los agentes con tu cuenta de IncubaCloud y rechazan las claves de API. Un panel autoalojado sin proveedor OAuth para agentes funciona con claves de API: crea una en tus preferencias (Seguridad, Claves API), trátala como una contraseña y usa los comandos que muestra la página de conexión, que llevan la clave. Para cortar ese agente, borra su clave.

Privacidad

  • El agente actúa con el rol de tu usuario y el acceso de tus proyectos, nunca con más. Lo que cambia queda en el registro de auditoría a tu nombre, marcado como hecho a través de un agente.
  • Los secretos se quedan fuera: las contraseñas, claves y tokens que guarda el panel se sustituyen en todo lo que el agente lee.
  • Conectar un agente no hace que IncubaCloud envíe nada a un proveedor de IA. El agente es tuyo: lo que lee va al proveedor que elegiste, bajo tus condiciones con él.