Yellow es un lugar donde los agentes externos pueden leer y escribir. Claude Desktop, Claude Code o cualquier cliente que hable el Model Context Protocol (MCP) puede listar tus modelos, buscar instancias, crear y actualizar registros, ejecutar automatizaciones y hacer propuestas, con las mismas reglas que tiene un miembro: el agente solo ve lo que su identidad le permite, y cada escritura se convierte en una versión con el autor marcado.

Este artículo explica qué es un agente en Yellow, cómo le das acceso y qué ves después.

El agente es una aplicación

Un agente no tiene una cuenta propia. Actúa como una aplicación: la identidad que una organización crea dentro de un entorno, con roles que dicen qué puede hacer. Encontrarás las aplicaciones en la organización, en la sección «Aplicaciones».

Qué tiene la aplicación Qué significa para el agente
Entorno El agente solo lee y escribe en ese entorno.
Roles Las herramientas que el agente ve son una proyección de las capacidades de los roles. Un rol que solo permite leer instancias da un agente que puede listar y leer, y nada que escriba.
Solo lectura Con IsReadonly activado, todas las herramientas que escriben desaparecen, digan lo que digan los roles.
Propiedad Crear o cambiar modelos requiere la organización propietaria del entorno. Una aplicación de otra organización nunca obtiene esas herramientas.

La lista de herramientas que recibe un agente es la que realmente puede usar: una herramienta que los roles no permiten no se ofrece, y una llamada a ella se rechaza antes de ejecutarse.

Keys

El agente se autentica con una key de la aplicación. Las keys viven en la ficha de la aplicación, en la pestaña «Keys».

Campo Qué hace
Etiqueta Un nombre para distinguir las keys, como el cliente que la usa.
Válida durante Cuánto tiempo autentica la key: 30, 90, 180 o 365 días. Una key caducada se rechaza como una revocada.
Secreto Se muestra una vez, al crear la key. Solo se guarda su hash; si lo pierdes, crea una key nueva.
Último uso Cuándo inició sesión la key por última vez, actualizado como máximo cada cuarto de hora.

Siete días antes de que una key caduque, los propietarios de la organización reciben una notificación. Usa Rotar en la key: crea un reemplazo con la misma etiqueta, muestra el nuevo secreto una vez y ofrece revocar la key antigua en el mismo paso.

Conectar un cliente

La ficha de la aplicación tiene una sección «Conecta tu agente» con la dirección del endpoint y una definición para pegar para cada cliente. El secreto de una key solo se muestra una vez, así que el diálogo que lo muestra puede copiar una definición con la key ya puesta.

Cliente Cómo se conecta
Claude Desktop Añade la entrada a claude_desktop_config.json dentro de mcpServers. Claude Desktop solo ejecuta programas locales, así que un pequeño puente llamado mcp-remote reenvía al endpoint; necesita Node instalado.
Claude Code Ejecuta la línea claude mcp add una vez en un terminal. Claude Code habla directamente con el endpoint.
Cualquier cliente MCP La dirección del endpoint por Streamable HTTP, con la key como cabecera bearer.
Conectores de Claude.ai y ChatGPT Los conectores alojados se identifican con OAuth, no con una key. Pega la dirección del endpoint, inicia sesión con tu propia cuenta de Yellow y elige el entorno. El agente actuará como tú, con tus roles, y cada versión que escriba llevará tu nombre.

El endpoint no mantiene ninguna sesión, así que reiniciar el backend es transparente para el agente. Cada key tiene un límite de 120 peticiones por minuto.

Qué ves después

Todo lo que hace el agente se atribuye a la aplicación.

  • Actividad: la ficha de la aplicación muestra las llamadas del agente por día durante un mes, su último acceso, las versiones que ha escrito y las propuestas que ha hecho y que todavía esperan una decisión.
  • Uso: el panel «Uso» lista la aplicación bajo el origen «Agente (MCP)», junto al chat y las automatizaciones, y la organización puede poner un límite mensual a sus llamadas de herramientas desde la ficha de la aplicación. En modo aviso, el límite se registra; en modo duro, el agente recibe un rechazo legible y no se ejecuta nada.
  • Propuestas: cuando la política de escritura de un modelo pide que los cambios de la IA se revisen, las escrituras del agente se convierten en propuestas en la bandeja «Propuestas» en lugar de versiones.
  • Historial: cada versión que escribe un agente queda marcada como escrita por la IA, con la aplicación como autora, y se puede revertir como cualquier otra.

Agentes conectados como tú

Un agente conectado a través de un conector alojado tiene una concesión a tu nombre, para un entorno. La configuración de tu usuario los lista en Mis agentes: el cliente, el entorno, cuándo lo concediste, cuándo renovó el acceso por última vez y cuándo caduca la concesión si no se usa. Revocar cierra el acceso del agente en la próxima renovación; se puede volver a conceder iniciando sesión desde el cliente.

Dónde encontrarlo

Abre la organización, ve a «Aplicaciones» y abre la aplicación. La pestaña «General» tiene los roles, la actividad y la cuota; la pestaña «Keys» tiene las keys y las definiciones de conexión.