Springbrand.ai

npx add-mcp 'https://connector.springbrand.ai/mcp'

Configuração do Agente SpringBrand

Instale o SpringBrand Production seguindo o guia nativo do Host correspondente: WorkBuddy usa uma versão R2 publicada; Codex, Claude Code e Cursor mantêm o GitHub main. Outros Agentes usam o fallback documentado de Skill-plus-MCP.

Esta árvore de código-fonte inclui cinco Skills Canônicos e uma entrada MCP por ambiente. O pacote publicado WorkBuddy v1.2.2 inclui os mesmos cinco Skills. A entrada MCP expõe cinco Meta Tools compartilhadas; os Domain Skills preservam os limites de negócio por meio de contratos de operação descobertos, em vez de prefixos de nomes de ferramentas registrados:

Skill	Função	Uso do MCP
springbrand-gtm	Entrada de negócio GTM substantiva; repassa para um Domain Skill	nenhum (nunca chama MCP)
ask-springbrand	Ask SpringBrand — Guia de Capacidades sem execução	nenhum (nunca chama MCP)
springbrand-platform	Platform — criar/publicar artefatos, ciclo de vida de Plugins	ferramentas compartilhadas de descoberta, schema, execução e resultado
springbrand-action-api	Action API — execução dinâmica de serviços de API	ferramentas compartilhadas de descoberta, schema, execução e resultado
springbrand-connector	Connector — sistemas de terceiros autorizados	ferramentas compartilhadas mais gerenciamento de conexão

Início rápido

O SpringBrand tem dois ambientes. Escolha o que você precisa e cole o prompt correspondente no seu Agente (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy ou qualquer Agente compatível).

Produção

Instale ou atualize o SpringBrand Production seguindo https://plugin.springbrand.ai/INSTALL.md. Identifique este Agente, use o guia do Host correspondente, detecte se o SpringBrand já está instalado, atualize o Marketplace/Plugin existente no lugar ao atualizar, prefira OAuth nativo, preserve a configuração existente e pause apenas para etapas de UI ou OAuth que eu precise concluir.

INSTALL.md é o protocolo universal de produção. Ele direciona o WorkBuddy para a versão R2 publicada e outros Hosts para seus caminhos GitHub existentes. Não use o branch legado stable nem adivinhe uma versão não publicada. A entrada MCP de produção exige OAuth nativo do Host — um consentimento por Surface (uma única autorização cobre todos os três domínios).

Desenvolvimento

Siga o guia oficial de instalação de desenvolvimento do SpringBrand para concluir a configuração: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Identifique o ambiente e o Host de destino primeiro. Forneça a chave de API de desenvolvimento apenas em tempo de execução, pelo fluxo seguro de credenciais do Host. Configure exatamente uma entrada springbrand-dev, preserve a configuração não relacionada, execute a verificação de identidade autoritativa e a verificação de saúde do serviço MCP configurado, e informe se uma reinicialização ou nova sessão é necessária. Não inicie OAuth quando a chave de API for válida; use as instruções manuais de UI e pare se o Host não puder representar credenciais Bearer com segurança.

O Plugin de desenvolvimento nativo é o pré-lançamento imutável v1.2.1-dev.2. Ele é identificado como springbrand-dev, exibido como SpringBrand Dev e inclui uma única entrada MCP springbrand-dev em https://devconnector.springbrand.ai/mcp. O descritor de desenvolvimento selecionado possui seu próprio transporte HTTP nativo e a representação de credencial de chave de API em tempo de execução.

Mantenha os Plugins completos de produção e desenvolvimento habilitados juntos apenas quando o Host puder distinguir suas entradas e roteamento. Preserve a entrada de produção e toda a configuração não relacionada durante a instalação ou migração de desenvolvimento. O fallback manual compartilha os mesmos cinco Skills Canônicos e adiciona ou atualiza apenas a entrada MCP springbrand-dev nomeada separadamente.

Produção vs Desenvolvimento

	Produção	Desenvolvimento
Guia de instalação	INSTALL.md	INSTALL.dev.md
Nome da entrada MCP	springbrand	springbrand-dev
URL do MCP	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Autenticação	OAuth nativo do Host	Chave de API em tempo de execução pelo descritor selecionado
Finalidade	Uso diário	Somente testes
Plugins completos podem coexistir	Depende do Host; o roteamento deve permanecer inequívoco	Depende do Host; o roteamento deve permanecer inequívoco
Fallback manual Skill-plus-MCP pode coexistir	Sim	Sim — compartilha os mesmos Skills e usa um nome de entrada MCP separado

O código-fonte atual e a versão de desenvolvimento mais recente incluem springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api e springbrand-connector; instale uma versão coerente em vez de misturar versões de Skills. Desenvolvimento é apenas para testes e não deve ser usado como configuração de produção.

O que é instalado

• Codex Plugin — empacota os cinco Skills Canônicos, a declaração MCP única de produção e o Hook de preflight estático para Hosts macOS Codex compatíveis.
• Claude Code Plugin — empacota os mesmos cinco Skills, uma entrada MCP de produção nativa com OAuth e o Hook de preflight estático para Claude Code CLI e a aba Code do Claude Desktop; veja INSTALL.claude.md.
• Cursor Plugin — empacota Distribution Mirrors gerados e verificados de todos os cinco Skills com uma entrada MCP de produção nativa com OAuth e uma Rule de preflight sempre aplicada para o Cursor desktop; veja INSTALL.cursor.md.
• WorkBuddy Plugin — um Agente WorkBuddy o instala por meio do CLI incluído; Add Marketplace permanece como fallback manual; veja INSTALL.workbuddy.md.
• SpringBrand Dev Plugin (pré-lançamento) — empacota cinco Skills, incluindo springbrand-gtm e a entrada MCP única springbrand-dev para testes internos contra https://devconnector.springbrand.ai/mcp; veja INSTALL.dev.md.
• Fallback Skill-plus-MCP — os cinco Skills de nível de usuário e a entrada MCP remota única para Hosts não compatíveis.

A chave de API de desenvolvimento é solicitada apenas em tempo de execução e nunca armazenada em arquivos do repositório, texto de Skills, URLs, logs, erros ou relatórios. A autenticação de produção permanece de propriedade do contrato de versão de produção. Nenhum Plugin contém credenciais reutilizáveis ou cabeçalhos de autorização estáticos.

Canais de distribuição

Ambiente	Canal de instalação
Produção — WorkBuddy	Versão R2 publicada selecionada em INSTALL.workbuddy.md (atualmente fixada)
Produção — outros Hosts	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Desenvolvimento	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

O WorkBuddy instala um pacote imutável com tag de produção do R2, não um espelho ao vivo de main; a URL atual não avança automaticamente. Outros Hosts ainda seguem main. A publicação de versão para R2 é atualmente acionada manualmente. Os Plugins de desenvolvimento permanecem como tags de desenvolvimento imutáveis e nunca são mesclados em main.

Estrutura do repositório

Cada Skill Canônico declara a versão do pacote em YAML metadata.version. VERSION é a fonte da verdade: versões de produção não têm marcador -dev.N; versões de desenvolvimento o incluem. Mantenha name em minúsculas e estável em ambos os canais. Isso identifica a versão do Skill instalado, não a versão do servidor MCP.

A sincronização de produção é executada automaticamente em pull requests do mesmo repositório direcionados a main. Após o autor da versão atualizar VERSION e os manifestos do pacote, o CI carimba os Skills Canônicos, atualiza os Distribution Mirrors do Cursor/WorkBuddy e confirma as alterações geradas no branch do PR. Em seguida, ele despacha a validação para esse novo commit. Mescle o PR revisado e crie a tag de produção a partir do commit sincronizado; nenhum comando separado de sincronização de versão é necessário. O fluxo de trabalho nunca envia diretamente para main protegido nem reescreve tags existentes.

As versões de desenvolvimento são sincronizadas automaticamente em build_dev_variant.py --version .... Para visualizações locais ou contribuições de forks (onde o CI não pode gravar no branch de origem), a mesma operação está disponível:

python3 scripts/sync_skill_versions.py
python3 scripts/sync_skill_versions.py --check
python3 tests/validate_plugin.py

O CI rejeita versões ou espelhos incompatíveis em main, tags e despachos de validação. A sincronização automática de PR usa permissões contents: write e actions: write com escopo de job; os jobs de validação permanecem somente leitura. Os metadados de versão não verificam versões remotas nem atualizam um Skill instalado; as atualizações ainda usam o fluxo de instalação documentado para o canal pretendido.

springbrand-agent-setup/
├── README.md                          # this file — for humans
├── INSTALL.md                         # the production installation protocol — for Agents
├── INSTALL.dev.md                     # the development installation protocol — for Agents
├── VERSION                            # current release version
└── skills/
    ├── ask-springbrand/SKILL.md       # Ask SpringBrand — non-executing Capability Guide
    ├── springbrand-platform/SKILL.md  # Platform Domain Skill
    ├── springbrand-action-api/SKILL.md # Action API Domain Skill
    ├── springbrand-connector/SKILL.md # Connector Domain Skill
    └── springbrand-gtm/SKILL.md       # GTM Scenario Skill

INSTALL.md e INSTALL.dev.md são o produto principal. Eles são escritos para serem lidos e executados por um Agente. As fontes dos Skills ficam em skills/<machine-name>/SKILL.md e são buscadas pelo Agente durante a instalação; a versão selecionada determina o conjunto completo de Skills Canônicos.

Requisitos

Seu Agente deve suportar:

• Ler uma URL remota e gravar arquivos no diretório de Skills de nível de usuário.
• Servidores MCP remotos Streamable HTTP com o contrato de credencial da versão selecionada, incluindo um mecanismo seguro de credencial Bearer para desenvolvimento.

Se algum desses itens estiver ausente, INSTALL.md instrui o Agente a parar e relatar a limitação. Alguns Agentes de desktop só podem adicionar servidores MCP pela interface; nesse caso, o Agente fornecerá os valores exatos para você inserir manualmente.

Segurança

• O instalador nunca armazena ou imprime chaves de API, tokens OAuth, cabeçalhos Authorization, Provider Credentials ou respostas upstream brutas.
• A URL MCP de produção é fixa em https://connector.springbrand.ai/mcp; a URL MCP de desenvolvimento é fixa em https://devconnector.springbrand.ai/mcp.
• A configuração MCP existente é preservada. O fallback manual de desenvolvimento mescla apenas a entrada springbrand-dev; as operações nativas do ciclo de vida do Plugin removem apenas seus próprios componentes incluídos.
• O instalador não executa nenhum script externo de terceiros.
• Nenhuma credencial ou token é colocado em arquivos de Skills, conteúdo do repositório, URLs, logs, erros ou relatórios finais.

Atualização

Use o fluxo de atualização nativo do Marketplace de cada Host para Plugins. Para o fallback manual, envie o mesmo prompt novamente; INSTALL.md / INSTALL.dev.md atualiza as entradas existentes em vez de adicionar duplicatas.

Migração de uma versão legada de Plugin

Uma versão legada de Plugin — uma versão do SpringBrand Plugin já instalada que usa uma única entrada MCP springbrand em https://connector.springbrand.ai/mcp com o contrato misto legado do Gateway (nomes de ferramentas sem prefixo) — continua funcionando até que a versão de produção do proprietário alterne o slot /mcp para o endpoint unificado (Gateway ADR-0014; a aposentadoria é a Issue 12 do Gateway, controlada pelo proprietário). Atualizar para o Plugin atual de entrada única com ferramentas com prefixo de domínio é voluntário — não há descontinuação automática.

Futuro: instalador determinístico

Um instalador programático (npx @springbrand/setup@latest) está planejado como uma alternativa determinística para ambientes onde a instalação baseada em prompt não é confiável. Ele não é necessário para o fluxo atual.