GoodBarber Public MCP

Gerencie seu aplicativo GoodBarber de eCommerce, Comunidade e Assinatura por meio de linguagem natural.

Documentação

Habilidades do GoodBarber

44 habilidades com tecnologia de IA para gerenciar seu aplicativo GoodBarber com qualquer cliente compatível com MCP — eCommerce, Comunidade, Assinaturas e CMS.

Listado no Smithery.

Estas habilidades se conectam ao servidor MCP do GoodBarber e fornecem ao seu assistente de IA fluxos de trabalho estruturados para gerenciar seus produtos, pedidos, clientes, promoções, assinaturas, conteúdo, análises e muito mais — tudo a partir de uma interface conversacional.

O que são Habilidades?

Habilidades são arquivos de instrução (.md) que ensinam a um assistente de IA como executar tarefas específicas usando a API do seu aplicativo GoodBarber via MCP (Model Context Protocol). Em vez de chamar manualmente as ferramentas da API uma a uma, uma habilidade orquestra o fluxo de trabalho completo — desde a recuperação de dados até o relatório formatado — em uma única solicitação em linguagem natural.

Por exemplo, perguntar "Mostre-me meus best-sellers deste mês" aciona a habilidade shop-best-sellers, que automaticamente busca seus pedidos e catálogo, calcula classificações e retorna um relatório formatado.

Início Rápido

Opção A — Instalar como plugin do Claude Code

O repositório é um plugin do Claude Code: ele inclui o servidor MCP do GoodBarber (.mcp.json) e as 44 habilidades em um único pacote.

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

Assim que o plugin estiver listado no marketplace da comunidade, instale-o a partir de qualquer sessão:

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

Na primeira chamada de ferramenta do GoodBarber, o Claude Code abre a página de autorização: cole sua chave da API Pública e valide. Detalhes em SETUP.md.

Opção B — Configuração manual (qualquer cliente MCP)

1. Conecte o MCP do GoodBarber

Você precisa adicionar o servidor MCP do GoodBarber como um conector personalizado no seu cliente. O servidor implementa o protocolo MCP 2026-07-28 sobre Streamable HTTP (clientes anteriores da era do handshake ainda se conectam). O nome do caminho /mcp/sse é histórico e mantido apenas para compatibilidade reversa.

URLs do Servidor MCP:

Configuração	URL
Aplicativo único	`https://mcp.goodbarber.dev/mcp/sse`
Múltiplos aplicativos	`https://mcp.goodbarber.dev/<app_id>/mcp/sse`

Substitua <app_id> pelo ID do seu aplicativo GoodBarber se você gerencia múltiplos aplicativos.

Autenticação: o servidor MCP do GoodBarber usa um fluxo OAuth baseado em navegador.

Quando seu cliente MCP se conecta ao endpoint MCP, ele pode abrir uma página de autorização em mcp.goodbarber.dev. Nessa página, você será solicitado a colar sua chave da API Pública do GoodBarber e validar a autorização. Gere sua chave da API Pública no backoffice do GoodBarber do seu aplicativo, na página Public API / MCP server.

Importante:

Não abra a URL /authorize manualmente no seu navegador.

Comece pelo cliente MCP conectando-se ao endpoint MCP.

O cliente gera automaticamente os parâmetros completos da solicitação de autorização (redirect_uri, client_id, state, code_challenge, etc.).

Se você abrir a página de autorização manualmente sem esses parâmetros, a autenticação falhará.

Claude Desktop (Cowork):

Abra Configurações > Conectores
Clique em Adicionar conector personalizado
Insira a URL do servidor MCP acima
O conector abre a página de autorização do GoodBarber — cole sua chave da API Pública lá e valide

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

Em seguida, inicie uma sessão do Claude Code — na primeira chamada de ferramenta do GoodBarber, a CLI abrirá a página de autorização do GoodBarber no seu navegador. Cole sua chave da API Pública lá e valide para concluir o fluxo OAuth.

Cursor / VS Code / Windsurf:

Adicione ao seu arquivo de configuração MCP (.cursor/mcp.json, .vscode/mcp.json, etc.):

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

A primeira conexão do seu cliente aciona o fluxo OAuth no seu navegador — cole sua chave da API Pública na página de autorização do GoodBarber e valide.

Cline:

Abra Servidores MCP no Cline, escolha "Servidor remoto", transporte Streamable HTTP, URL https://mcp.goodbarber.dev/mcp/sse, ou adicione isso ao cline_mcp_settings.json:

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

Na primeira conexão, o Cline abre a página de autorização do GoodBarber no seu navegador — cole seu token da API Pública lá e valide. Sem chave de API na configuração, sem variável de ambiente. Os agentes também podem seguir llms-install.md.

Qualquer outro cliente compatível com MCP:

Aponte seu cliente para o endpoint MCP acima (Streamable HTTP). O servidor MCP do GoodBarber segue o protocolo MCP padrão e funciona com qualquer cliente compatível.

2. Instale as habilidades

Clone este repositório e copie apenas as habilidades para o tipo do seu aplicativo:

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

Nota: os exemplos abaixo usam o diretório local de habilidades do Claude (~/.claude/skills/). Se você usar outro cliente, copie as pastas de habilidades para o diretório esperado por esse cliente.

Aplicativo eCommerce:

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

Aplicativo de Comunidade:

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

Aplicativo de Assinaturas:

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

CMS / Conteúdo (qualquer aplicativo com seções de conteúdo):

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

Dica: as habilidades de CMS são transversais — instale-as junto com qualquer tipo de aplicativo que tenha seções de conteúdo (artigos, agenda, mapas, galerias, vídeos, sons).

Dica: se seu aplicativo GoodBarber combina múltiplos tipos (ex.: eCommerce + Assinaturas), instale habilidades de ambos os diretórios.

Nota: os nomes dos diretórios de habilidades carregam seu prefixo de família (shop-, community-, membership-, cms-) e são únicos, então habilidades de várias famílias podem coexistir no mesmo destino sem colisões.

3. Verifique

Pergunte ao seu assistente de IA: "Quais habilidades você tem?" — ele deve listar as habilidades do GoodBarber instaladas.

Opção C — Instalar no Grok Build

O mesmo pacote é um plugin do Grok Build: .grok-plugin/plugin.json lista as 44 habilidades e .mcp.json declara o servidor MCP do GoodBarber.

grok plugin install goodbarber/goodbarber-skills --trust

Assim que o plugin estiver listado no marketplace de plugins do xAI, instale-o pelo nome (grok plugin install goodbarber --trust) ou selecione-o em /marketplace.

Na primeira chamada de ferramenta do GoodBarber, o Grok abre a página de autorização no seu navegador: cole sua chave da API Pública e valide. Use /mcps para verificar a conexão e /skills para listar as 44 habilidades. Detalhes em SETUP.md.

Habilidades por Tipo de Aplicativo

eCommerce (18 habilidades)

Catálogo e Produtos

Habilidade	Descrição
`shop-best-sellers`	Classificar produtos por volume de vendas e receita em um período determinado
`shop-catalog-audit`	Detectar fichas de produto incompletas (imagens, descrições, variações ausentes)
`shop-low-performers`	Identificar produtos com vendas zero ou muito baixas
`shop-orphan-products`	Encontrar produtos não atribuídos a nenhuma coleção
`shop-product-launch`	Criação guiada de um produto completo com variações, imagens e SEO
`shop-stock-check`	Auditar níveis de estoque — sinalizar itens esgotados e com estoque baixo
`shop-reorder-planner`	Gerar uma fila de reposição pronta para fornecedores com base na velocidade de vendas

Pedidos e Clientes

Habilidade	Descrição
`shop-order-followup`	Lista de tarefas de pedidos a processar (pendentes, a enviar, a entregar)
`shop-customer-insights`	Segmentar clientes em perfis VIP, fiéis, inativos e de compra única
`shop-rfm-segmentation`	Segmentação de clientes por Recência / Frequência / Valor Monetário
`shop-prospect-nurture`	Priorizar prospects e sugerir ações de conversão

Promoções

Habilidade	Descrição
`shop-promo-campaign`	Criar um código promocional + enviar um push de anúncio em um único fluxo de trabalho
`shop-promo-performance-review`	Analisar o impacto da promoção: antes, durante e depois da campanha

Análises e Comunicação

Habilidade	Descrição
`shop-traffic-report`	Análises do aplicativo: visualizações de página, aberturas, sessões, plataformas
`shop-kpi-monitor`	Alertas de saúde de KPIs diários/semanais baseados em limites
`shop-weekly-digest`	Resumo semanal automatizado do negócio
`shop-push-broadcast`	Compor, visualizar, agendar e enviar uma notificação push para todos os clientes
`shop-push-targeted`	Compor, visualizar, agendar e enviar um push para clientes ou prospects específicos

Comunidade (5 habilidades)

Habilidade	Descrição
`community-traffic-report`	Análises do aplicativo: visualizações de página, aberturas, sessões por plataforma
`community-push-broadcast`	Enviar um push para todos ou para grupos específicos da comunidade
`community-push-targeted`	Enviar um push para usuários específicos da comunidade
`community-device-landscape`	Distribuição de plataformas, principais dispositivos, versões de SO
`community-weekly-digest`	Resumo semanal da atividade da comunidade

Assinaturas (10 habilidades)

Assinaturas

Habilidade	Descrição
`membership-subscription-audit`	Ativas vs. expiradas, taxa de churn, assinantes em risco, oportunidades de reconquista
`membership-expiration-calendar`	Linha do tempo de expirações de assinaturas futuras
`membership-longest-subscribers`	Identificar seus assinantes de longo prazo mais fiéis
`membership-internal-subscription-grant`	Criar, atualizar ou revogar assinaturas internas

Usuários e Análises

Habilidade	Descrição
`membership-prospect-followup`	Priorizar prospects de assinatura para conversão
`membership-traffic-report`	Análises do aplicativo: visualizações de página, aberturas, sessões por plataforma
`membership-push-broadcast`	Enviar uma notificação push para todos os usuários elegíveis
`membership-push-targeted`	Enviar um push para usuários específicos ou públicos por status de assinatura
`membership-device-landscape`	Distribuição de plataformas, principais dispositivos, versões de SO
`membership-weekly-digest`	Resumo semanal do negócio de assinaturas

CMS / Conteúdo (11 habilidades)

Habilidades para gerenciar conteúdo editorial — artigos, eventos de agenda, pontos de interesse no mapa, galerias de fotos, vídeos e sons. Funciona com qualquer aplicativo GoodBarber que tenha seções de conteúdo CMS.

Criação e Publicação

Habilidade	Descrição
`cms-article-publish`	Criação guiada de um artigo completo: parágrafos do corpo, categoria, slug, agendamento, paywall
`cms-event-publish`	Criar um evento de agenda com data/hora de início e fim, local e conteúdo do corpo
`cms-place-publish`	Criar um ponto de interesse no mapa (endereço + coordenadas) com descrição
`cms-gallery-builder`	Enviar imagens em lote para uma galeria de fotos e definir títulos/status
`cms-article-restructure`	Reordenar, limpar e corrigir os parágrafos do corpo de um artigo existente

Qualidade e Governança

Habilidade	Descrição
`cms-content-audit`	Detectar conteúdo incompleto em todos os tipos (sem capa, corpo vazio, datas/coordenadas ausentes)
`cms-draft-review`	Revelar rascunhos antigos e conteúdo inacabado com uma próxima etapa recomendada
`cms-paywall-audit`	Aplicativos IAP: verificar se o conteúdo premium tem uma prévia gratuita coerente (accessTier, maxFreeParagraphs)
`cms-stale-content-refresh`	Classificar artigos antigos como candidatos a atualização, re-promoção ou aposentadoria

Planejamento e Resumo

Habilidade	Descrição
`cms-editorial-calendar`	Visão futura: publicações agendadas, próximos eventos, conteúdo expirando
`cms-weekly-digest`	O que foi publicado esta semana + o que está agendado para a próxima semana, por tipo de conteúdo

Nota: os nomes weekly-digest, traffic-report, push-broadcast e push-targeted se repetem entre os tipos de aplicativo. As habilidades de CMS são nomeadas com um prefixo cms- em seu frontmatter (ex.: cms-weekly-digest) para evitar colisões — mantenha-as em uma pasta separada se você instalar habilidades de vários diretórios.

Exemplos 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)

Princípios de Design

Todas as skills seguem estas regras:

Ciente de paginação — Grandes conjuntos de dados são filtrados no servidor, não paginados cegamente
Correspondência difusa — Mencione um produto ou coleção pelo nome; a skill resolve
Encadeamento de fluxo de trabalho — Cada skill sugere 2–3 skills relacionadas para executar em seguida
Sem ações destrutivas sem confirmação — Mutações sempre exigem validação explícita do usuário
Saída estruturada — Cada skill retorna um relatório formatado, não uma linha única

Compatibilidade

Estas skills funcionam com qualquer cliente de IA compatível com MCP, incluindo:

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

Estrutura do Repositório

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

Instalação com a CLI de skills

A CLI de skills instala estas skills em qualquer agente suportado (Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, Antigravity, Cline e outros) com um único comando:

npx skills add goodbarber/goodbarber-skills

Escolha as skills que você precisa da lista, ou instale todas as 44 com --all. As skills chamam o servidor MCP do GoodBarber, então conecte-o primeiro (veja "Instale o servidor MCP" acima).

Contribuindo

Quer adicionar uma skill? Crie uma pasta em skills/<app-type>/ com um arquivo SKILL.md. Siga o formato existente: frontmatter YAML (name, description, compatibility) + instruções em markdown com fluxo de trabalho de ferramentas, contratos de entrada/saída e proteções.

Licença

The Unlicense — domínio público, sem restrições.