GoodBarber Public MCP

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

Documentação

GoodBarber Skills

44 habilidades alimentadas por IA para gerenciar seu aplicativo GoodBarber com qualquer cliente compatível com MCP — eCommerce, Comunidade, Assinatura e CMS.

Estas habilidades se conectam ao servidor MCP do GoodBarber e dão 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 por 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 mais vendidos este mês" dispara a habilidade best-sellers, que automaticamente busca seus pedidos e catálogo, calcula rankings e retorna um relatório formatado.

Início Rápido

1. Conecte o MCP do GoodBarber

Você precisa adicionar o servidor MCP do GoodBarber como um conector personalizado no seu cliente. O servidor MCP usa Server-Sent Events (SSE).

URLs do servidor MCP:

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

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

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

Quando seu cliente MCP se conecta ao endpoint SSE, ele pode abrir uma página de autorização em mcp.goodbarber.dev. Nessa página, será solicitado que você cole sua chave da API Pública do GoodBarber e valide a autorização. Gere sua chave da API Pública no backoffice do seu app GoodBarber, 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 SSE.

O cliente gera automaticamente todos os parâmetros 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 sse https://mcp.goodbarber.dev/mcp/sse

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

Em seguida, inicie uma sessão do Claude Code — na primeira chamada de ferramenta do GoodBarber, o 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 dispara o fluxo OAuth no seu navegador — cole sua chave da API Pública na página de autorização do GoodBarber e valide.

Qualquer outro cliente compatível com MCP:

Aponte seu cliente para o endpoint SSE acima. 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 app:

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ê usa outro cliente, copie as pastas de habilidades para o diretório esperado pelo seu cliente.

App eCommerce:

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

App de Comunidade:

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

App de Assinatura:

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

CMS / Conteúdo (qualquer app 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 app que tenha seções de conteúdo (artigos, agenda, mapas, galerias, vídeos, sons).

Dica: se o seu app GoodBarber combina vários tipos (por exemplo, eCommerce + Assinatura), instale habilidades de ambos os diretórios.

Aviso: alguns nomes de habilidades são compartilhados entre tipos de app (por exemplo, weekly-digest, traffic-report, push-broadcast ou push-targeted). Se você instalar habilidades de vários diretórios no mesmo destino, renomeie-as ou coloque-as em namespaces separados para evitar colisões.

3. Verifique

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

Habilidades por Tipo de App

eCommerce (18 habilidades)

Catálogo e Produtos

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

Pedidos e Clientes

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

Promoções

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

Analítica e Comunicação

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

Comunidade (5 habilidades)

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

Assinatura (10 habilidades)

Assinaturas

Habilidade	Descrição
`subscription-audit`	Ativas vs expiradas, taxa de churn, assinantes em risco, oportunidades de reativação
`expiration-calendar`	Linha do tempo de vencimentos de assinaturas próximos
`longest-subscribers`	Identificar seus assinantes de longo prazo mais fiéis
`internal-subscription-grant`	Criar, atualizar ou revogar assinaturas internas

Usuários e Análises

Habilidade	Descrição
`prospect-followup`	Priorizar prospects de assinatura para conversão
`traffic-report`	Análises do app: visualizações de página, lançamentos, sessões por plataforma
`push-broadcast`	Enviar uma notificação push para todos os usuários elegíveis
`push-targeted`	Enviar um push para usuários específicos ou públicos por status de assinatura
`device-landscape`	Distribuição por plataforma, principais dispositivos, versões de SO
`weekly-digest`	Resumo comercial semanal 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. Funcionam com qualquer app GoodBarber que tenha seções de conteúdo CMS.

Autoria e Publicação

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

Qualidade e Governança

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

Planejamento e Resumo

Habilidade	Descrição
`editorial-calendar`	Visão futura: publicações agendadas, eventos futuros, conteúdo expirando
`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 app. As habilidades de CMS são agrupadas por um prefixo cms- no frontmatter (por exemplo, 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 habilidades seguem estas regras:

Ciente de paginação — Grandes conjuntos de dados são filtrados no lado do servidor, não paginados cegamente
Correspondência difusa — Mencione um produto ou coleção pelo nome; a habilidade resolve
Encadeamento de fluxos de trabalho — Cada habilidade sugere 2–3 habilidades 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 habilidade retorna um relatório formatado, não uma única linha

Compatibilidade

Estas habilidades 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
Qualquer cliente que suporte o Model Context Protocol

Estrutura do Repositório

goodbarber-skills/
├── README.md
└── skills/
    ├── ecommerce/
    │   ├── best-sellers/SKILL.md
    │   ├── catalog-audit/SKILL.md
    │   ├── customer-insights/SKILL.md
    │   ├── ...
    │   ├── push-targeted/SKILL.md
    │   └── weekly-digest/SKILL.md
    ├── community/
    │   ├── device-landscape/SKILL.md
    │   ├── push-broadcast/SKILL.md
    │   ├── push-targeted/SKILL.md
    │   ├── traffic-report/SKILL.md
    │   └── weekly-digest/SKILL.md
    ├── membership/
    │   ├── subscription-audit/SKILL.md
    │   ├── expiration-calendar/SKILL.md
    │   ├── ...
    │   ├── push-broadcast/SKILL.md
    │   ├── push-targeted/SKILL.md
    │   └── weekly-digest/SKILL.md
    └── cms/
        ├── article-publish/SKILL.md
        ├── content-audit/SKILL.md
        ├── editorial-calendar/SKILL.md
        ├── ...
        └── weekly-digest/SKILL.md

Contribuindo

Quer adicionar uma habilidade? 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.