GoodBarber Public MCP

Gestiona tu aplicación de eCommerce, Comunidad y Membresía de GoodBarber mediante lenguaje natural.

Documentación

Habilidades de GoodBarber

44 habilidades impulsadas por IA para gestionar tu app GoodBarber con cualquier cliente compatible con MCP — eCommerce, Comunidad, Membresía y CMS.

Listado en Smithery.

Estas habilidades se conectan al servidor MCP de GoodBarber y le dan a tu asistente de IA flujos de trabajo estructurados para gestionar tus productos, pedidos, clientes, promociones, suscripciones, contenido, analíticas y más — todo desde una interfaz conversacional.

¿Qué son las Habilidades?

Las habilidades son archivos de instrucciones (.md) que enseñan a un asistente de IA cómo realizar tareas específicas usando la API de tu app GoodBarber a través de MCP (Protocolo de Contexto de Modelo). En lugar de llamar manualmente a las herramientas de la API una por una, una habilidad orquesta el flujo de trabajo completo — desde la recuperación de datos hasta el informe formateado — en una única solicitud en lenguaje natural.

Por ejemplo, preguntar "Muéstrame mis productos más vendidos este mes" activa la habilidad shop-best-sellers, que automáticamente obtiene tus pedidos y catálogo, calcula clasificaciones y devuelve un informe formateado.

Inicio Rápido

Opción A — Instalar como plugin de Claude Code

El repositorio es un plugin de Claude Code: incluye el servidor MCP de GoodBarber (.mcp.json) y las 44 habilidades en un solo paquete.

git clone https://github.com/goodbarber/goodbarber-skills.git
claude --plugin-dir ./goodbarber-skills

Una vez que el plugin esté listado en el marketplace de la comunidad, instálalo desde cualquier sesión:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install goodbarber@claude-community

En la primera llamada a una herramienta de GoodBarber, Claude Code abre la página de autorización: pega tu clave de API pública y valida. Detalles en SETUP.md.

Opción B — Configuración manual (cualquier cliente MCP)

1. Conectar el MCP de GoodBarber

Debes añadir el servidor MCP de GoodBarber como un conector personalizado en tu cliente. El servidor implementa el protocolo MCP 2026-07-28 sobre HTTP Streamable (los clientes de la era anterior de handshake aún se conectan). El nombre de ruta /mcp/sse es histórico y se mantiene solo por compatibilidad con versiones anteriores.

URLs del servidor MCP:

Configuración	URL
App única	`https://mcp.goodbarber.dev/mcp/sse`
Múltiples apps	`https://mcp.goodbarber.dev/<app_id>/mcp/sse`

Reemplaza <app_id> con el ID de tu app GoodBarber si gestionas múltiples apps.

Autenticación: el servidor MCP de GoodBarber utiliza un flujo OAuth basado en navegador.

Cuando tu cliente MCP se conecta al endpoint MCP, puede abrir una página de autorización en mcp.goodbarber.dev. En esa página, se te pedirá que pegues tu clave de API pública de GoodBarber y valides la autorización. Genera tu clave de API pública desde el backoffice de tu app GoodBarber, en la página API pública / servidor MCP.

Importante:

No abras la URL /authorize manualmente en tu navegador.

Comienza desde el cliente MCP conectándote al endpoint MCP.

El cliente genera automáticamente los parámetros completos de la solicitud de autorización (redirect_uri, client_id, state, code_challenge, etc.).

Si abres la página de autorización manualmente sin esos parámetros, la autenticación fallará.

Claude Desktop (Cowork):

Abre Configuración > Conectores
Haz clic en Añadir conector personalizado
Introduce la URL del servidor MCP anterior
El conector abre la página de autorización de GoodBarber — pega tu clave de API pública allí y valida

Claude Code (CLI):

# Single app
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/mcp/sse

# Multiple apps
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/<app_id>/mcp/sse

Luego inicia una sesión de Claude Code — en la primera llamada a una herramienta de GoodBarber, la CLI abrirá la página de autorización de GoodBarber en tu navegador. Pega tu clave de API pública allí y valida para completar el flujo OAuth.

Cursor / VS Code / Windsurf:

Añade a tu archivo de configuración MCP (.cursor/mcp.json, .vscode/mcp.json, etc.):

{
  "mcpServers": {
    "goodbarber": {
      "url": "https://mcp.goodbarber.dev/mcp/sse"
    }
  }
}

La primera conexión desde tu cliente activa el flujo OAuth en tu navegador — pega tu clave de API pública en la página de autorización de GoodBarber y valida.

Cline:

Abre Servidores MCP en Cline, elige "Servidor remoto", transporte HTTP Streamable, URL https://mcp.goodbarber.dev/mcp/sse, o añade esto a cline_mcp_settings.json:

{
  "mcpServers": {
    "goodbarber": {
      "type": "streamableHttp",
      "url": "https://mcp.goodbarber.dev/mcp/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

En la primera conexión, Cline abre la página de autorización de GoodBarber en tu navegador — pega tu token de API pública allí y valida. Sin clave de API en la configuración, sin variable de entorno. Los agentes también pueden seguir llms-install.md.

Cualquier otro cliente compatible con MCP:

Apunta tu cliente al endpoint MCP anterior (HTTP Streamable). El servidor MCP de GoodBarber sigue el protocolo MCP estándar y funciona con cualquier cliente compatible.

2. Instalar las habilidades

Clona este repositorio y copia solo las habilidades para tu tipo de app:

git clone https://github.com/goodbarber/goodbarber-skills.git

Nota: los ejemplos a continuación usan el directorio local de habilidades de Claude (~/.claude/skills/). Si usas otro cliente, copia las carpetas de habilidades al directorio esperado por ese cliente.

App eCommerce:

cp -r goodbarber-skills/skills/ecommerce/* ~/.claude/skills/

App Comunidad:

cp -r goodbarber-skills/skills/community/* ~/.claude/skills/

App Membresía:

cp -r goodbarber-skills/skills/membership/* ~/.claude/skills/

CMS / Contenido (cualquier app con secciones de contenido):

cp -r goodbarber-skills/skills/cms/* ~/.claude/skills/

Consejo: las habilidades de CMS son transversales — instálalas junto con cualquier tipo de app que tenga secciones de contenido (artículos, agenda, mapas, galerías, videos, sonidos).

Consejo: si tu app GoodBarber combina múltiples tipos (por ejemplo, eCommerce + Membresía), instala habilidades de ambos directorios.

Nota: los nombres de los directorios de habilidades llevan su prefijo de familia (shop-, community-, membership-, cms-) y son únicos, por lo que las habilidades de varias familias pueden coexistir en el mismo destino sin colisiones.

3. Verificar

Pregunta a tu asistente de IA: "¿Qué habilidades tienes?" — debería listar las habilidades de GoodBarber instaladas.

Opción C — Instalar en Grok Build

El mismo paquete es un plugin de Grok Build: .grok-plugin/plugin.json lista las 44 habilidades y .mcp.json declara el servidor MCP de GoodBarber.

grok plugin install goodbarber/goodbarber-skills --trust

Una vez que el plugin esté listado en el marketplace de plugins de xAI, instálalo por nombre (grok plugin install goodbarber --trust) o elígelo en /marketplace.

En la primera llamada a una herramienta de GoodBarber, Grok abre la página de autorización en tu navegador: pega tu clave de API pública y valida. Usa /mcps para verificar la conexión y /skills para listar las 44 habilidades. Detalles en SETUP.md.

Habilidades por Tipo de App

eCommerce (18 habilidades)

Catálogo y Productos

Habilidad	Descripción
`shop-best-sellers`	Clasifica productos por volumen de ventas e ingresos en un período determinado
`shop-catalog-audit`	Detecta fichas de producto incompletas (imágenes, descripciones, variantes faltantes)
`shop-low-performers`	Identifica productos con cero o muy bajas ventas
`shop-orphan-products`	Encuentra productos no asignados a ninguna colección
`shop-product-launch`	Creación guiada de un producto completo con variantes, imágenes y SEO
`shop-stock-check`	Audita niveles de stock — señala artículos agotados y con stock bajo
`shop-reorder-planner`	Genera una cola de reposición lista para proveedores basada en la velocidad de ventas

Pedidos y Clientes

Habilidad	Descripción
`shop-order-followup`	Lista de tareas de pedidos a procesar (pendientes, por enviar, por entregar)
`shop-customer-insights`	Segmenta clientes en perfiles VIP, leales, inactivos y de una sola compra
`shop-rfm-segmentation`	Segmentación de clientes por Recencia / Frecuencia / Valor Monetario
`shop-prospect-nurture`	Prioriza prospectos y sugiere acciones de conversión

Promociones

Habilidad	Descripción
`shop-promo-campaign`	Crea un código promocional + envía un push de anuncio en un solo flujo de trabajo
`shop-promo-performance-review`	Analiza el impacto de la promoción: antes, durante y después de la campaña

Analíticas y Comunicación

Habilidad	Descripción
`shop-traffic-report`	Analíticas a nivel de app: vistas de página, lanzamientos, sesiones, plataformas
`shop-kpi-monitor`	Alertas de salud de KPIs diarios/semanales basadas en umbrales
`shop-weekly-digest`	Resumen semanal automatizado del negocio
`shop-push-broadcast`	Redacta, previsualiza, programa y envía una notificación push a todos los clientes
`shop-push-targeted`	Redacta, previsualiza, programa y envía un push a clientes o prospectos específicos

Comunidad (5 habilidades)

Habilidad	Descripción
`community-traffic-report`	Analíticas de la app: vistas de página, lanzamientos, sesiones por plataforma
`community-push-broadcast`	Envía un push a todos o a grupos de comunidad específicos
`community-push-targeted`	Envía un push a usuarios de comunidad específicos
`community-device-landscape`	Distribución de plataformas, dispositivos principales, versiones de SO
`community-weekly-digest`	Resumen semanal de actividad de la comunidad

Membresía (10 habilidades)

Suscripciones

Habilidad	Descripción
`membership-subscription-audit`	Activas vs. expiradas, tasa de abandono, suscriptores en riesgo, oportunidades de recuperación
`membership-expiration-calendar`	Cronograma de expiraciones de suscripciones próximas
`membership-longest-subscribers`	Identifica a tus suscriptores más leales a largo plazo
`membership-internal-subscription-grant`	Crea, actualiza o revoca suscripciones internas

Usuarios y Analíticas

Habilidad	Descripción
`membership-prospect-followup`	Prioriza prospectos de membresía para conversión
`membership-traffic-report`	Analíticas de la app: vistas de página, lanzamientos, sesiones por plataforma
`membership-push-broadcast`	Envía una notificación push a todos los usuarios elegibles
`membership-push-targeted`	Envía un push a usuarios específicos o audiencias por estado de suscripción
`membership-device-landscape`	Distribución de plataformas, dispositivos principales, versiones de SO
`membership-weekly-digest`	Resumen semanal del negocio de membresía

CMS / Contenido (11 habilidades)

Habilidades para gestionar contenido editorial — artículos, eventos de agenda, puntos de interés en mapas, galerías de fotos, videos y sonidos. Funciona con cualquier app GoodBarber que tenga secciones de contenido CMS.

Redacción y Publicación

Habilidad	Descripción
`cms-article-publish`	Creación guiada de un artículo completo: párrafos del cuerpo, categoría, slug, programación, muro de pago
`cms-event-publish`	Crea un evento de agenda con fecha/hora de inicio y fin, ubicación y contenido del cuerpo
`cms-place-publish`	Crea un punto de interés en el mapa (dirección + coordenadas) con descripción
`cms-gallery-builder`	Sube imágenes por lotes a una galería de fotos y establece títulos/estado
`cms-article-restructure`	Reordena, limpia y corrige los párrafos del cuerpo de un artículo existente

Calidad y Gobernanza

Habilidad	Descripción
`cms-content-audit`	Detecta contenido incompleto en todos los tipos (sin portada, cuerpo vacío, fechas/coordenadas faltantes)
`cms-draft-review`	Señala borradores antiguos y contenido sin terminar con un siguiente paso recomendado
`cms-paywall-audit`	Apps con compras integradas: verifica que el contenido premium tenga una vista previa gratuita coherente (accessTier, maxFreeParagraphs)
`cms-stale-content-refresh`	Clasifica artículos antiguos como candidatos a actualizar, re-promocionar o retirar

Planificación y Resumen

Habilidad	Descripción
`cms-editorial-calendar`	Vista a futuro: publicaciones programadas, próximos eventos, contenido por expirar
`cms-weekly-digest`	Qué se publicó esta semana + qué está programado para la próxima semana, por tipo de contenido

Nota: los nombres weekly-digest, traffic-report, push-broadcast y push-targeted se repiten en varios tipos de app. Las habilidades de CMS tienen un prefijo de espacio de nombres cms- en su frontmatter (por ejemplo, cms-weekly-digest) para evitar colisiones — mantenlas en una carpeta separada si instalas habilidades de varios directorios.

Ejemplos de Uso

"Show me my best sellers this month"
→ best-sellers

"Any products running low on stock?"
→ stock-check

"Create a 20% promo code for summer and notify everyone"
→ promo-campaign

"How's my churn rate looking?"
→ subscription-audit

"Send a push to the Paris group: meetup Friday at 7pm"
→ push-broadcast (community)

"Send a push to Marie and Alex: your item is back in stock"
→ push-targeted (eCommerce)

"Notify expired subscribers about the renewal offer tomorrow at 9am"
→ push-targeted (membership)

"Give me my weekly digest"
→ weekly-digest

"Write and publish an article about our new opening hours"
→ article-publish (cms)

"What content is scheduled to go live next week?"
→ editorial-calendar (cms)

"Audit my content for missing covers and empty posts"
→ content-audit (cms)

Principios de diseño

Todas las skills siguen estas reglas:

Conscientes de la paginación — Los conjuntos de datos grandes se filtran en el servidor, no se paginan a ciegas
Coincidencia difusa — Menciona un producto o colección por nombre; la skill lo resuelve
Encadenamiento de flujos de trabajo — Cada skill sugiere 2–3 skills relacionadas para ejecutar a continuación
Sin acciones destructivas sin confirmación — Las mutaciones siempre requieren validación explícita del usuario
Salida estructurada — Cada skill devuelve un informe formateado, no una línea suelta

Compatibilidad

Estas skills funcionan con cualquier cliente de IA compatible con MCP, incluyendo:

Claude Desktop (Cowork)
Claude Code (CLI)
Cursor
VS Code (Copilot, Claude, Cline, etc.)
Windsurf
Codex CLI
Gemini CLI
Grok Build (CLI)
Cualquier cliente que admita el Model Context Protocol

Estructura del repositorio

goodbarber-skills/
├── .claude-plugin/plugin.json
├── .grok-plugin/plugin.json   # Grok Build manifest (lists the 44 skills)
├── .mcp.json
├── README.md
├── SETUP.md
├── server.json        # manifest published to the official MCP registry (dev.goodbarber/goodbarber-public-mcp)
└── skills/
    ├── ecommerce/
    │   ├── shop-best-sellers/SKILL.md
    │   ├── shop-catalog-audit/SKILL.md
    │   ├── shop-customer-insights/SKILL.md
    │   ├── shop-kpi-monitor/SKILL.md
    │   ├── shop-low-performers/SKILL.md
    │   ├── shop-order-followup/SKILL.md
    │   ├── shop-orphan-products/SKILL.md
    │   ├── shop-product-launch/SKILL.md
    │   ├── shop-promo-campaign/SKILL.md
    │   ├── shop-promo-performance-review/SKILL.md
    │   ├── shop-prospect-nurture/SKILL.md
    │   ├── shop-push-broadcast/SKILL.md
    │   ├── shop-push-targeted/SKILL.md
    │   ├── shop-reorder-planner/SKILL.md
    │   ├── shop-rfm-segmentation/SKILL.md
    │   ├── shop-stock-check/SKILL.md
    │   ├── shop-traffic-report/SKILL.md
    │   └── shop-weekly-digest/SKILL.md
    ├── community/
    │   ├── community-device-landscape/SKILL.md
    │   ├── community-push-broadcast/SKILL.md
    │   ├── community-push-targeted/SKILL.md
    │   ├── community-traffic-report/SKILL.md
    │   └── community-weekly-digest/SKILL.md
    ├── membership/
    │   ├── membership-device-landscape/SKILL.md
    │   ├── membership-expiration-calendar/SKILL.md
    │   ├── membership-internal-subscription-grant/SKILL.md
    │   ├── membership-longest-subscribers/SKILL.md
    │   ├── membership-prospect-followup/SKILL.md
    │   ├── membership-push-broadcast/SKILL.md
    │   ├── membership-push-targeted/SKILL.md
    │   ├── membership-subscription-audit/SKILL.md
    │   ├── membership-traffic-report/SKILL.md
    │   └── membership-weekly-digest/SKILL.md
    └── cms/
        ├── cms-article-publish/SKILL.md
        ├── cms-article-restructure/SKILL.md
        ├── cms-content-audit/SKILL.md
        ├── cms-draft-review/SKILL.md
        ├── cms-editorial-calendar/SKILL.md
        ├── cms-event-publish/SKILL.md
        ├── cms-gallery-builder/SKILL.md
        ├── cms-paywall-audit/SKILL.md
        ├── cms-place-publish/SKILL.md
        ├── cms-stale-content-refresh/SKILL.md
        └── cms-weekly-digest/SKILL.md

Instalación con la CLI de skills

La CLI de skills instala estas skills en cualquier agente compatible (Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, Antigravity, Cline y más) con un solo comando:

npx skills add goodbarber/goodbarber-skills

Elige las skills que necesites de la lista, o instala las 44 con --all. Las skills llaman al servidor MCP de GoodBarber, así que conéctalo primero (consulta "Instalación del servidor MCP" más arriba).

Contribuciones

¿Quieres añadir una skill? Crea una carpeta en skills/<app-type>/ con un archivo SKILL.md. Sigue el formato existente: frontmatter YAML (name, description, compatibility) + instrucciones en markdown con el flujo de trabajo de las herramientas, contratos de entrada/salida y salvaguardas.

Licencia

The Unlicense — dominio público, sin restricciones.