Si buscas el portal para enviar plugins de Claude, debes usar el portal para desarrolladores de Anthropic: claude.ai/directory/manage. La ruta actual es Submit new → Plugin bundle, aunque para que el plugin llegue al directorio público también necesitarás un repositorio público en GitHub, un plan y un rol compatibles, además de superar la revisión.
Cómo se envía actualmente un plugin de Claude
El proceso oficial empieza en la documentación de Anthropic para enviar plugins, no en el repositorio público del marketplace de GitHub. Cada carpeta de plugin se envía por separado, aunque varios plugins estén dentro del mismo repositorio.
| Qué necesitas | Requisito actual |
|---|---|
| Página de envío | claude.ai/directory/manage |
| Tipo de envío | Plugin bundle |
| Origen | Un repositorio público de GitHub antes de que la ficha se publique |
| Acceso | Un plan y un rol autorizados para enviar plugins al directorio |
| Revisión | Validación y análisis de seguridad; algunas versiones quedan pendientes de revisión manual |
| Publicación | Una versión que supera las comprobaciones todavía debe publicarse |
Esta guía explica cómo distribuir un plugin en el directorio público, no cómo compartirlo con un equipo privado ni cómo instalarlo localmente.
Qué preparar antes de abrir el portal
Deja el repositorio listo antes de entrar en el portal.
1. Sube el plugin a GitHub
El directorio obtiene los plugins desde github.com y Anthropic indica que el repositorio debe ser público antes de que la ficha pueda publicarse. Si el plugin está dentro de una subcarpeta, apunta su ruta exacta.
Un plugin estándar de Claude Code suele incluir:
plugin-name/
├── .claude-plugin/
│ └── plugin.json
├── .mcp.json # optional
├── commands/ # optional
├── agents/ # optional
├── skills/ # optional
└── README.md
El manifiesto y el README aportan buena parte de la información que aparecerá en el directorio. Antes de enviarlo, revisa también la licencia del plugin y los servicios externos que utiliza.
2. Ejecuta la validación local
Desde el directorio que contiene la carpeta del plugin, ejecuta:
claude plugin validate ./<plugin-folder>
Este comando detecta problemas de estructura y formato, pero el paso Validate del portal realiza comprobaciones adicionales. Toma la validación local como una primera revisión, no como una aprobación.
3. Separa el conector MCP cuando sea necesario
Si el plugin utiliza un servidor MCP remoto que administras y todavía no se ha enviado, la guía de Anthropic indica que debes enviarlo por separado como MCP connector. El paquete del plugin y el conector son fichas distintas dentro del directorio.
Cómo enviar un paquete de plugin paso a paso
1. Elige Plugin bundle
Abre el portal para desarrolladores y selecciona Submit new. Cuando te pregunte qué quieres enviar, elige Plugin bundle. Selecciona MCP connector únicamente si vas a registrar un servidor MCP remoto como ficha independiente.
2. Introduce el repositorio, la ruta y la rama
En Source, indica:
- La URL de GitHub o el formato
owner/repo. - Plugin path, si
.claude-plugin/plugin.jsonno está en la raíz del repositorio. - Branch or tag, si el directorio debe seguir algo distinto de la rama predeterminada.
Una etiqueta permanece vinculada a su commit hasta que cambias la etiqueta. Si el nombre de la rama contiene una barra, introdúcelo explícitamente o utiliza el formato owner/repo@branch que se describe en la guía oficial de envío.
Selecciona Validate. Si algún hallazgo bloquea el envío, corrige el repositorio, sube el cambio y vuelve a validarlo. Cada resultado de validación corresponde a un único commit.
3. Revisa la ficha generada
El paso Listing details muestra cómo aparecerá el plugin en el directorio. Anthropic obtiene estos datos de plugin.json y del README.
Si necesitas corregir el nombre o la descripción breve, modifica los archivos de origen. El directorio oficial de plugins de Anthropic también advierte que el slug de instalación publicado debe mantenerse estable, ya que los usuarios pueden encontrarse con el error plugin-not-found. Usa una etiqueta visible para los cambios de redacción habituales y reserva el mapeo de renombre para las migraciones necesarias.
4. Responde a las preguntas sobre el tratamiento de datos
El paso Data handling pregunta si el plugin:
- Lee o almacena datos personales.
- Envía datos a servicios distintos de los conectores declarados.
- Conserva datos y durante cuánto tiempo.
- Está dirigido a menores de 18 años.
Responde según el funcionamiento real del plugin. Incluye los servicios remotos, el acceso a archivos, la telemetría y las políticas de conservación de datos.
5. Completa las confirmaciones de cumplimiento
En Compliance, confirma un correo electrónico de contacto en el que Anthropic pueda localizarte y selecciona las confirmaciones requeridas. El plugin debe cumplir la política del Software Directory de Anthropic.
6. Envía el plugin y elige cómo recibir actualizaciones
En Review and submit, confirma los datos y decide cómo se incorporarán las nuevas versiones:
- GitHub push webhook, seleccionado de forma predeterminada en la guía actual; puede activar comprobaciones después de cada push cuando está configurado.
- Scheduled check only, que depende de comprobaciones periódicas de la rama o etiqueta seguida.
Selecciona Submit for review. Para configurar el webhook necesitas acceso de administrador en GitHub. Anthropic limita actualmente a una organización a 10 envíos en cualquier periodo de 24 horas; los borradores guardados y los envíos retirados también cuentan para ese límite. Estos límites y las opciones de actualización se explican en el flujo de envío.
Qué ocurre después de enviar el plugin
Anthropic analiza el commit más reciente de la rama o etiqueta seguida, vuelve a ejecutar la validación del directorio y realiza un análisis de seguridad. La guía oficial contempla estos estados:
| Estado | Qué significa | Siguiente paso |
|---|---|---|
| Supera todas las comprobaciones | La versión puede publicarse | Selecciona Publish |
| Pendiente de revisión | Un revisor debe resolver los hallazgos | Aplica los cambios solicitados o espera la revisión |
| No supera las comprobaciones | El portal muestra las reglas incumplidas o una categoría de seguridad | Corrige el repositorio y comprueba el nuevo commit |
| Rechazado | El envío no ha sido aprobado | Revisa los cambios solicitados y usa Resubmit for review |
Que una versión supere las comprobaciones no significa necesariamente que ya esté disponible. La configuración predeterminada puede exigir una solicitud de publicación y que un revisor la publique; el portal también permite activar la publicación automática para algunas versiones posteriores que superen la revisión.
Abre el plugin en Submissions y consulta Versions para seguir el proceso. Después de corregir un problema, utiliza Check for new commits cuando esté disponible. Para actualizar el plugin, sube cambios a la rama seguida o mueve la etiqueta seguida; no tienes que volver a enviar el formulario. La última versión publicada seguirá disponible mientras una nueva versión falla o espera revisión.
Comprobaciones de seguridad que no conviene saltarse
El directorio oficial de Anthropic advierte que los plugins pueden incluir servidores MCP, archivos y otro software que queda fuera del control de Anthropic. Antes de enviar el plugin, documenta todos los servicios externos, permisos, periodos de conservación y acciones que se ejecuten en segundo plano.
“I mean, I asked it to audit why my plugin submissions failed and fix the issue.” — @tarasshyn, X, describiendo un fallo de envío y el proceso de auditoría.
Usa esta lista de comprobación:
- Declara y documenta todos los servicios de salida.
- Explica en el README los permisos, la configuración, el flujo de datos y la conservación de la información.
- Confirma que la referencia seguida contiene exactamente el código que quieres publicar.
- Vuelve a validar después de cada commit de corrección.
- Informa de cualquier indexación en segundo plano, telemetría o comportamiento automatizado que pueda generar costes.
FAQ: envío de plugins de Claude
¿El repositorio de GitHub tiene que ser público?
Sí. La documentación actual de Anthropic indica que el repositorio debe ser público antes de que la ficha pueda publicarse.
¿Puedo enviar varios plugins desde un mismo repositorio?
Sí, pero cada carpeta de plugin constituye un envío independiente. Introduce por separado en el portal cada ruta que corresponda.
¿Puedo enviarlo mediante una pull request al repositorio de la comunidad?
No. El README del marketplace de la comunidad de Anthropic describe ese repositorio como un espejo de solo lectura e indica que las pull requests directas se cierran automáticamente. Debes utilizar el portal para desarrolladores.
¿Tengo que enviar por separado un servidor MCP remoto?
Si el plugin utiliza un servidor MCP remoto que administras y ese servidor todavía no aparece en el directorio, debes enviarlo por separado como MCP connector.
¿Qué ocurre si falla la validación?
Corrige el repositorio, sube el cambio y vuelve a validarlo. La validación se aplica a un commit concreto. Después de enviar el plugin, utiliza la comprobación de nuevos commits del portal cuando esté disponible.
¿Una revisión aprobada publica automáticamente el plugin?
No siempre. Una versión aprobada todavía puede requerir Publish y la publicación por parte de un revisor. La opción de publicación automática del portal determina cómo se gestionan las versiones posteriores que superen las comprobaciones.
¿Puedo retirar del directorio un plugin publicado?
Sí. Abre el plugin activo en el portal para desarrolladores y solicita Delist plugin. Anthropic indica que el cambio puede tardar en llegar a todas las aplicaciones de Claude y que los usuarios existentes podrían dejar de recibir actualizaciones.
Para publicar una ficha, el camino más corto es hacer público el repositorio, validar localmente, enviar Plugin bundle, corregir los hallazgos asociados al commit, completar los pasos de datos y cumplimiento, y publicar la versión aprobada. Si el alcance del directorio no compensa la revisión y el mantenimiento públicos, mantén privado el paquete destinado únicamente al equipo.