# Compartir agentes


Sube (push) tu agente a un registro y compártelo por su nombre. Tus compañeros
de equipo harán referencia a `agentcatalog/security-expert` en lugar de copiar archivos
YAML de un lado a otro o preguntarte dónde se encuentra la configuración de tu agente.

Cuando actualizas el agente en el registro, todos obtienen la nueva versión
la próxima vez que realicen una descarga (pull) o reinicien su cliente.

## Requisitos previos

Para subir agentes a un registro, primero autentícate:

```console
$ docker login
```

Para otros registros, utiliza su método de autenticación.

## Publicar agentes

Sube la configuración de tu agente a un registro:

```console
$ docker agent share push ./agent.yml miusuario/nombre-agente
```

Subir el agente crea el repositorio si aún no existe. Utiliza Docker Hub o
cualquier registro compatible con OCI.

Etiqueta versiones específicas:

```console
$ docker agent share push ./agent.yml miusuario/nombre-agente:v1.0.0
$ docker agent share push ./agent.yml miusuario/nombre-agente:latest
```

## Uso de agentes publicados

Descarga (pull) un agente para inspeccionarlo localmente:

```console
$ docker agent share pull agentcatalog/pirate
```

Esto guarda la configuración como un archivo YAML local.

Ejecuta agentes directamente desde el registro:

```console
$ docker agent run agentcatalog/pirate
```

O haz referencia a él directamente en las integraciones:

### Integración con el editor (ACP)

Utiliza referencias de registro en las configuraciones de ACP para que tu editor siempre use
la última versión:

```json
{
  "agent_servers": {
    "myagent": {
      "command": "docker",
      "args": ["agent", "serve", "acp", "agentcatalog/pirate"]
    }
  }
}
```

### Integración con el cliente MCP

Los agentes pueden exponerse como herramientas en clientes MCP:

```json
{
  "mcpServers": {
    "myagent": {
      "command": "docker",
      "args": ["agent", "serve", "mcp", "agentcatalog/pirate"]
    }
  }
}
```

## ¿Qué sigue?

- Configura la [integración ACP](/ai/docker-agent/integrations/acp/) con agentes compartidos
- Configura la [integración MCP](/ai/docker-agent/integrations/mcp/) con agentes compartidos
- Explora el [catálogo de agentes](https://hub.docker.com/u/agentcatalog) para ver ejemplos