---
title: Carga y descubrimiento
description: Valida el manifiesto, descubre los componentes compatibles y aplica límites de fallo específicos.
---

# Carga y descubrimiento



## Establecer el límite del paquete [#establecer-el-límite-del-paquete]

La raíz del plugin es una única ubicación del sistema de archivos. Después de resolver enlaces simbólicos, puntos de unión, puntos de reanálisis y mecanismos equivalentes, todos los archivos del paquete que el cliente descubra, lea o ejecute deben permanecer dentro de la raíz resuelta por el sistema de archivos.

## Cargar primero el manifiesto [#cargar-primero-el-manifiesto]

Los clientes buscan `plugin.json` en la raíz del plugin y lo cargan antes de descubrir componentes o aplicar comportamiento propio. El objeto JSON cerrado tiene dos campos obligatorios: `$schema` selecciona la versión de Agent Plugins y el contrato de validación, mientras que `name` identifica el plugin. Los demás campos permitidos aportan metadatos opcionales o [datos de extensiones de cliente](/es/plugin-authors/client-extensions). Consulta la [referencia del manifiesto](/es/plugin-authors/manifest) para ver todos los campos.

Selecciona a partir de `$schema` las reglas de validación e interpretación disponibles localmente; no descargues un schema mientras cargas el plugin. Si falta `$schema` o no es compatible, el cliente rechaza el plugin.

Las dos infracciones siguientes del schema del manifiesto no son fatales:

* Informa de cada campo desconocido de nivel superior y omítelo. Continúa si el resto del manifiesto es válido.
* Informa de un campo `extensions` que no sea un objeto y omítelo. Después, continúa cargando componentes.

Cualquier otra infracción del schema del manifiesto provoca el rechazo del plugin completo.

Cuando `extensions` es un objeto, cada miembro pertenece al cliente identificado por su espacio de nombres de dominio inverso. Ignora los espacios de nombres que el cliente no implementa sin validar sus valores.

## Descubrir componentes compatibles [#descubrir-componentes-compatibles]

Agent Plugins asigna una ubicación fija a cada tipo de componente:

| Tipo de componente                               | Ubicación fija | Regla de descubrimiento                                                      |
| ------------------------------------------------ | -------------- | ---------------------------------------------------------------------------- |
| [Agent Skills](/es/plugin-authors/skills)        | `skills/`      | Directorios secundarios directos que contienen un archivo normal `SKILL.md`. |
| [Servidores MCP](/es/plugin-authors/mcp-servers) | `mcp.json`     | Un documento de configuración JSON en la raíz.                               |

La ausencia de una ubicación fija no es un error. Si la ubicación existe con un tipo incorrecto del sistema de archivos, marca como no válido solo ese tipo de componente y continúa con los demás tipos compatibles.

Si una Agent Skill descubierta no cumple la especificación de Agent Skills, omítela y continúa cargando las Agent Skills del mismo nivel. No busques otras Agent Skills de forma recursiva en descendientes anidados.

Un cliente ignora los tipos de componentes que no implementa. La falta de compatibilidad no constituye por sí misma un error del plugin; un cliente conforme implementa al menos uno de estos tipos: Agent Skills o servidores MCP. La forma de presentar una Agent Skill válida a usuarios o modelos queda bajo la política del cliente.

## Límites de fallo de rutas [#límites-de-fallo-de-rutas]

Aplica el límite específico pertinente:

1. Rechaza el plugin si `plugin.json` se resuelve fuera de la raíz del plugin.
2. Desactiva un tipo de componente cuando su ubicación fija tenga un tipo incorrecto del sistema de archivos o escape de la raíz.
3. Omite una Agent Skill cuando su `SKILL.md` escape de la raíz.
4. Omite una entrada MCP cuando una ruta configurada del paquete escape de la raíz permitida.
5. Deniega el acceso a otras rutas del paquete que escapen de la raíz.


---

Source: [content/docs/client-implementers/loading-and-discovery.mdx](https://github.com/agentplugins/agent-plugins-site/blob/237bbf575f5843214923419f9d0933852662f4f3/content/docs/client-implementers/loading-and-discovery.mdx)
Source commit: 237bbf575f5843214923419f9d0933852662f4f3

---

For a semantic overview of all documentation, see [/es/sitemap.md](/es/sitemap.md)

For an index of all available documentation, see [/es/llms.txt](/es/llms.txt)