Connecta el teu agent
Yellow és un lloc on els agents externs poden llegir i escriure. Claude Desktop, Claude Code o qualsevol client que parli el Model Context Protocol (MCP) pot llistar els teus models, cercar instàncies, crear i actualitzar registres, executar automatitzacions i fer propostes, amb les mateixes regles que té un membre: l'agent només veu el que la seva identitat li permet, i cada escriptura es converteix en una versió amb l'autor marcat.
Aquest article explica què és un agent a Yellow, com li dones accés i què veus després.
L'agent és una aplicació
Un agent no té un compte propi. Actua com una aplicació: la identitat que una organització crea dins d'un entorn, amb rols que diuen què pot fer. Trobaràs les aplicacions a l'organització, a la secció «Aplicacions».
| Què té l'aplicació | Què vol dir per a l'agent |
|---|---|
| Entorn | L'agent només llegeix i escriu en aquell entorn. |
| Rols | Les eines que l'agent veu són una projecció de les capacitats dels rols. Un rol que només permet llegir instàncies dona un agent que pot llistar i llegir, i res que escrigui. |
| Només lectura | Amb IsReadonly activat, totes les eines que escriuen desapareixen, diguin el que diguin els rols. |
| Propietat | Crear o canviar models requereix l'organització propietària de l'entorn. Una aplicació d'una altra organització no obté mai aquestes eines. |
La llista d'eines que rep un agent és la que realment pot fer servir: una eina que els rols no permeten no s'ofereix, i una crida a ella es rebutja abans d'executar-se.
Keys
L'agent s'autentica amb una key de l'aplicació. Les keys viuen a la fitxa de l'aplicació, a la pestanya «Keys».
| Camp | Què fa |
|---|---|
| Etiqueta | Un nom per distingir les keys, com ara el client que la fa servir. |
| Vàlida durant | Quant de temps autentica la key: 30, 90, 180 o 365 dies. Una key caducada es rebutja com una de revocada. |
| Secret | Es mostra un cop, en crear la key. Només se'n guarda el hash; si el perds, crea una key nova. |
| Últim ús | Quan la key va iniciar sessió per última vegada, actualitzat com a màxim cada quart d'hora. |
Set dies abans que una key caduqui, els propietaris de l'organització reben una notificació. Fes servir Rota a la key: crea un reemplaçament amb la mateixa etiqueta, mostra el nou secret un cop i ofereix revocar la key antiga en el mateix pas.
Connectar un client
La fitxa de l'aplicació té una secció «Connecta el teu agent» amb l'adreça de l'endpoint i una definició per enganxar per a cada client. El secret d'una key només es mostra un cop, així que el diàleg que el mostra pot copiar una definició amb la key ja posada.
| Client | Com es connecta |
|---|---|
| Claude Desktop | Afegeix l'entrada a claude_desktop_config.json dins de mcpServers. Claude Desktop només executa programes locals, així que un petit pont anomenat mcp-remote reenvia a l'endpoint; necessita Node instal·lat. |
| Claude Code | Executa la línia claude mcp add un cop en un terminal. Claude Code parla directament amb l'endpoint. |
| Qualsevol client MCP | L'adreça de l'endpoint per Streamable HTTP, amb la key com a capçalera bearer. |
| Connectors de Claude.ai i ChatGPT | Els connectors allotjats s'identifiquen amb OAuth, no amb una key. Enganxa l'adreça de l'endpoint, inicia la sessió amb el teu propi compte de Yellow i tria l'entorn. L'agent actuarà com tu, amb els teus rols, i cada versió que escrigui portarà el teu nom. |
L'endpoint no manté cap sessió, així que reiniciar el backend és transparent per a l'agent. Cada key té un límit de 120 peticions per minut.
Què veus després
Tot el que fa l'agent s'atribueix a l'aplicació.
- Activitat: la fitxa de l'aplicació mostra les crides de l'agent per dia durant un mes, el seu últim accés, les versions que ha escrit i les propostes que ha fet i que encara esperen una decisió.
- Ús: el panell «Ús» llista l'aplicació sota l'origen «Agent (MCP)», al costat del xat i les automatitzacions, i l'organització pot posar un límit mensual a les seves crides d'eines des de la fitxa de l'aplicació. En mode avís, el límit es registra; en mode dur, l'agent rep un rebuig llegible i no s'executa res.
- Propostes: quan la política d'escriptura d'un model demana que els canvis de la IA es revisin, les escriptures de l'agent es converteixen en propostes a la safata «Propostes» en lloc de versions.
- Historial: cada versió que escriu un agent queda marcada com a escrita per la IA, amb l'aplicació com a autora, i es pot revertir com qualsevol altra.
Agents connectats com tu
Un agent connectat a través d'un connector allotjat té una concessió a nom teu, per a un entorn. La configuració del teu usuari els llista a Els meus agents: el client, l'entorn, quan el vas concedir, quan va renovar l'accés per última vegada i quan caduca la concessió si no s'usa. Revoca tanca l'accés de l'agent a la propera renovació; es pot tornar a concedir iniciant la sessió des del client.
On trobar-ho
Obre l'organització, ves a «Aplicacions» i obre l'aplicació. La pestanya «General» té els rols, l'activitat i la quota; la pestanya «Keys» té les keys i les definicions de connexió.