Springbrand.ai

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

SpringBrand Agent 设置

通过匹配的原生 Host 指南安装 SpringBrand Production：WorkBuddy 使用已发布的 R2 版本；Codex、Claude Code 和 Cursor 保留 GitHub main。其他 Agent 使用文档中描述的 Skill-plus-MCP 回退方案。

此源代码树包含五个 Canonical Skills，每个环境对应一个 MCP 条目。 已发布的 WorkBuddy v1.2.2 包包含相同的五个 Skills。MCP 条目暴露了五个共享的 Meta Tools；Domain Skills 通过发现的操作契约而非注册的工具名称前缀来保持业务边界：

Skill	角色	MCP 使用
springbrand-gtm	实质性 GTM 业务入口；移交给一个 Domain Skill	无（从不调用 MCP）
ask-springbrand	Ask SpringBrand — 非执行能力指南	无（从不调用 MCP）
springbrand-platform	Platform — 创建/发布工件、Plugin 生命周期	共享发现、模式、执行和结果工具
springbrand-action-api	Action API — 动态 API 服务执行	共享发现、模式、执行和结果工具
springbrand-connector	Connector — 授权的第三方系统	共享工具及连接管理

快速开始

SpringBrand 有两个环境。选择你需要的环境，并将匹配的提示词粘贴到你的 Agent（Cursor、Claude Code、Codex、Copilot、Devin、Windsurf、WorkBuddy 或任何兼容的 Agent）中。

Production

通过遵循 https://plugin.springbrand.ai/INSTALL.md. 安装或更新 SpringBrand Production。识别此 Agent，使用匹配的 Host 指南，检测 SpringBrand 是否已安装，更新时原地刷新现有的 Marketplace/Plugin，优先使用原生 OAuth，保留现有配置，并且仅在我必须完成的 UI 或 OAuth 步骤时暂停。

INSTALL.md 是通用生产协议。它将 WorkBuddy 路由到已发布的 R2 版本，并将其他 Hosts 路由到其现有的 GitHub 路径。不要使用旧的 stable 分支或猜测未发布的版本。生产 MCP 条目需要 Host 原生 OAuth — 每个 Surface 一次同意（单个授权涵盖所有三个域）。

Development

遵循官方的 SpringBrand 开发安装指南以完成设置： https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md 首先识别目标环境和 Host。仅在运行时通过 Host 的安全凭据流程提供开发 API 密钥。配置恰好一个 springbrand-dev 条目，保留无关配置，运行权威身份检查和配置的 MCP 服务健康检查，并报告是否需要重启或新会话。当 API 密钥有效时不要启动 OAuth；使用手动 UI 说明，如果 Host 无法安全地表示 Bearer 凭据，则停止。

原生开发 Plugin 是不可变的预发布版本 v1.2.1-dev.2。它被标识为 springbrand-dev，显示为 SpringBrand Dev，并在 https://devconnector.springbrand.ai/mcp 处捆绑了一个单一的 springbrand-dev MCP 条目。选定的开发描述符拥有其原生 HTTP 传输和运行时 API 密钥凭据表示。

仅当 Host 能够区分其条目和路由时，才同时启用完整的生产和开发 Plugins。在开发安装或迁移期间，保留生产条目和所有无关配置。手动回退共享相同的五个 Canonical Skills，并且仅添加或更新单独命名的 springbrand-dev MCP 条目。

Production 与 Development 对比

	Production	Development
安装指南	INSTALL.md	INSTALL.dev.md
MCP 条目名称	springbrand	springbrand-dev
MCP URL	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
认证	Host 原生 OAuth	通过选定描述符的运行时 API 密钥
用途	日常使用	仅测试
完整 Plugins 可共存	取决于 Host；路由必须保持明确	取决于 Host；路由必须保持明确
手动 Skill-plus-MCP 回退可共存	是	是 — 它共享相同的 Skills 并使用单独的 MCP 条目名称

当前源代码和最新的开发版本包括 springbrand-gtm、ask-springbrand、springbrand-platform、springbrand-action-api 和 springbrand-connector；安装一个连贯的版本，而不是混合 Skill 版本。Development 仅用于测试，不应作为生产配置使用。

安装内容

• Codex Plugin — 打包五个 Canonical Skills、单一生产 MCP 声明，以及适用于受支持的 macOS Codex Hosts 的静态预检 Hook。
• Claude Code Plugin — 打包相同的五个 Skills、一个原生 OAuth 支持的生产 MCP 条目，以及适用于 Claude Code CLI 和 Claude Desktop Code 标签页的静态预检 Hook；参见 INSTALL.claude.md。
• Cursor Plugin — 打包所有五个 Skills 的生成、验证的 Distribution Mirrors，带有一个原生 OAuth 支持的生产 MCP 条目和一个始终应用的预检 Rule，适用于 Cursor 桌面；参见 INSTALL.cursor.md。
• WorkBuddy Plugin — WorkBuddy Agent 通过捆绑的 CLI 安装它；Add Marketplace 仍然是手动回退；参见 INSTALL.workbuddy.md。
• SpringBrand Dev Plugin（预发布） — 打包五个 Skills，包括 springbrand-gtm 和针对 https://devconnector.springbrand.ai/mcp 进行内部测试的单一 springbrand-dev MCP 条目；参见 INSTALL.dev.md。
• Skill-plus-MCP 回退 — 适用于不受支持的 Hosts 的五个用户级 Skills 和单一远程 MCP 条目。

开发 API 密钥仅在运行时请求，并且永远不会存储在仓库文件、Skill 文本、URL、日志、错误或报告中。生产认证仍由生产发布契约拥有。没有 Plugin 包含可重用的凭据或静态授权头。

分发渠道

环境	安装渠道
Production — WorkBuddy	在 INSTALL.workbuddy.md 中选择的已发布 R2 版本（当前已固定）
Production — 其他 Hosts	https://github.com/springbrand-lab/springbrand-agent-setup（main）
Development	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy 从 R2 安装不可变的生产标签包，而不是 main 的实时镜像；当前 URL 不会自动前进。其他 Hosts 仍然遵循 main。发布到 R2 目前是手动触发的。Development Plugins 保持不可变的开发标签，并且永远不会合并到 main 中。

仓库布局

每个 Canonical Skill 在 YAML metadata.version 中声明包版本。 VERSION 是事实来源：生产版本没有 -dev.N 标记； 开发版本包含它。保持 name 小写，并在两个渠道中保持稳定。 这标识已安装的 Skill 版本，而不是 MCP 服务器版本。

生产同步在针对 main 的同一仓库拉取请求上自动运行。在发布作者更新 VERSION 和包清单后，CI 标记 Canonical Skills，更新 Cursor/WorkBuddy Distribution Mirrors，并将生成的更改提交到 PR 分支。然后它为那个新提交调度验证。合并已审查的 PR，并从同步的提交创建生产标签；不需要单独的版本同步命令。工作流永远不会直接推送到受保护的 main 或重写现有标签。

开发版本在 build_dev_variant.py --version ... 中自动同步。 对于本地预览或 fork 贡献（CI 无法写入源分支），相同的操作可用：

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

CI 拒绝 main、标签和验证调度上的不匹配版本或镜像。 自动 PR 同步使用作业范围的 contents: write 和 actions: write 权限；验证作业保持只读。版本元数据本身不会检查远程版本或更新已安装的 Skill；升级仍然使用目标渠道的文档化安装流程。

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 和 INSTALL.dev.md 是核心产品。它们被编写为供 Agent 阅读和执行。Skill 源位于 skills/<machine-name>/SKILL.md，并在安装期间由 Agent 获取；选定的版本确定完整的 Canonical Skill 集。

要求

你的 Agent 必须支持：

• 读取远程 URL 并将文件写入你的用户级 Skill 目录。
• 远程 Streamable HTTP MCP 服务器，带有选定的版本凭据契约，包括开发的安全 Bearer 凭据机制。

如果缺少任何一个，INSTALL.md 会告诉 Agent 停止并报告限制。一些桌面 Agent 只能通过其 UI 添加 MCP 服务器；在这种情况下，Agent 会给你需要手动输入的确切值。

安全性

• 安装程序永远不会存储或打印 API 密钥、OAuth 令牌、Authorization 头、Provider Credentials 或原始上游响应。
• 生产 MCP URL 固定在 https://connector.springbrand.ai/mcp；开发 MCP URL 固定在 https://devconnector.springbrand.ai/mcp。
• 现有的 MCP 配置被保留。手动开发回退仅合并 springbrand-dev 条目；原生 Plugin 生命周期操作仅移除它们自己的捆绑组件。
• 安装程序不执行任何外部第三方脚本。
• 没有凭据或令牌被放置在 Skill 文件、仓库内容、URL、日志、错误或最终报告中。

更新

使用每个 Host 的原生 Marketplace 更新流程来更新 Plugins。对于手动回退，再次发送相同的提示词；INSTALL.md / INSTALL.dev.md 更新现有条目，而不是添加重复项。

从旧版 Plugin 版本迁移

旧版 Plugin 版本 — 一个已安装的 SpringBrand Plugin 版本，使用 springbrand 处的单一 https://connector.springbrand.ai/mcp MCP 条目，带有 Gateway 的旧版混合契约（无前缀工具名称）— 将继续工作，直到所有者的生产版本将 /mcp 槽位切换到统一端点（Gateway ADR-0014；退役是 Gateway Issue 12，由所有者控制）。升级到当前具有域前缀工具的单一条目 Plugin 是自愿的 — 没有自动日落。

未来：确定性安装程序

计划了一个程序化安装程序（npx @springbrand/setup@latest），作为基于提示词的安装不可靠的环境中的确定性替代方案。当前流程不需要它。