Springbrand.ai
官方AI 助手用的能力市场
你可以用 Springbrand Ai MCP 做什麼？
- 安裝正式版 SpringBrand — 請您的助理依照
INSTALL.md操作，並以原生 OAuth 設定正式環境的 MCP 入口。 - 設定開發環境 — 請您的助理使用
INSTALL.dev.md安裝springbrand-dev預發行版本，並搭配執行時期 API 金鑰。 - 在特定主機上安裝 — 可透過
INSTALL.claude.md、INSTALL.cursor.md或INSTALL.workbuddy.md請求針對特定主機的安裝設定，分別適用於 Claude Code、Cursor 或 WorkBuddy。 - 更新既有安裝 — 請您的助理使用原生 Marketplace 更新流程，就地重新整理已安裝的 SpringBrand Plugin。
- 從舊版遷移 — 指示您的助理將舊版 Plugin Release 升級為目前單一入口的 Plugin，並使用具備網域前綴的工具。
託管 MCP 伺服器
npx add-mcp 'https://connector.springbrand.ai/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
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 | 詢問 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 是通用的 production 協定。它將 WorkBuddy 路由到已發布的 R2 版本，並將其他 Hosts 路由到其現有的 GitHub 路徑。請勿使用舊版的 stable 分支或猜測未發布的版本。production MCP 條目需要 Host 原生的 OAuth — 每個 Surface 一次同意（單一授權涵蓋所有三個網域）。
Development
依照官方的 SpringBrand development 安裝指南完成設定： https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md 首先識別目標環境和 Host。僅在執行階段透過 Host 的安全憑證流程提供 development API 金鑰。設定恰好一個
springbrand-dev條目，保留無關的設定，執行權威的身分檢查和設定的 MCP 服務健康檢查，並回報是否需要重新啟動或新工作階段。當 API 金鑰有效時，請勿啟動 OAuth；使用手動 UI 指示，如果 Host 無法安全地表示 Bearer 憑證，請停止。
原生 development Plugin 是不可變的預發布版 v1.2.1-dev.2。它被識別為 springbrand-dev，顯示為 SpringBrand Dev，並在 https://devconnector.springbrand.ai/mcp 綁定單一 springbrand-dev MCP 條目。所選的 development 描述檔擁有其原生 HTTP 傳輸和執行階段的 API 金鑰憑證表示。
僅在 Host 能區分其條目和路由時，才同時啟用完整的 production 和 development Plugins。在 development 安裝或遷移期間，保留 production 條目和所有無關的設定。手動備援方案共享相同的五個 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 條目名稱 |
目前的原始碼和最新的 dev 版本包含 springbrand-gtm、ask-springbrand、springbrand-platform、springbrand-action-api 和 springbrand-connector；請安裝一個連貫的版本，而不是混合 Skill 版本。Development 僅供測試使用，不應用作 production 設定。
安裝內容
- Codex Plugin — 打包五個 Canonical Skills、單一 production MCP 宣告，以及支援的 macOS Codex Hosts 的靜態 preflight Hook。
- Claude Code Plugin — 打包相同的五個 Skills、一個原生 OAuth 支援的 production MCP 條目，以及 Claude Code CLI 和 Claude Desktop Code 標籤頁的靜態 preflight Hook；請參閱
INSTALL.claude.md。 - Cursor Plugin — 打包所有五個 Skills 的已產生、已驗證的 Distribution Mirrors，包含一個原生 OAuth 支援的 production MCP 條目和一個始終套用的 Cursor 桌面 preflight Rule；請參閱
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-devMCP 條目；請參閱INSTALL.dev.md。 - Skill-plus-MCP 備援方案 — 針對不支援的 Hosts 的五個使用者層級 Skills 和單一遠端 MCP 條目。
development API 金鑰僅在執行階段要求，絕不會儲存在 儲存庫檔案、Skill 文字、URL、日誌、錯誤或報告中。Production 驗證仍由 production 發布合約擁有。沒有 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 安裝不可變的 production-tag 套件，而不是 main 的即時鏡像；目前的 URL 不會自動推進。其他 Hosts 仍遵循 main。發布到 R2 目前是手動觸發的。Development Plugins 保持為不可變的 dev tags，絕不會合併到 main。
儲存庫結構
每個 Canonical Skill 在 YAML metadata.version 中宣告套件版本。
VERSION 是事實來源：production 版本沒有 -dev.N 標記；
development 版本包含它。在兩個管道中保持 name 小寫且穩定。
這識別已安裝的 Skill 版本，而不是 MCP 伺服器版本。
Production 同步會針對目標為 main 的相同儲存庫拉取請求自動執行。在發布作者更新 VERSION 和套件
清單之後，CI 會標記 Canonical Skills、更新 Cursor/WorkBuddy Distribution
Mirrors，並將產生的變更提交到 PR 分支。然後它會為該新提交分派
驗證。合併已審查的 PR，並從同步的提交建立 production
tag；不需要單獨的版本同步命令。
工作流程絕不會直接推送到受保護的 main 或重寫現有的 tags。
Development 版本會在
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、tags 和驗證分派上不匹配的版本或鏡像。
自動 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 伺服器，具有所選版本的憑證 合約，包括用於 development 的安全 Bearer 憑證機制。
如果缺少任一項，INSTALL.md 會告訴 Agent 停止並回報限制。某些桌面 Agent 只能透過其 UI 新增 MCP 伺服器；在這種情況下，Agent 會給您需要手動輸入的確切值。
安全性
- 安裝程式絕不會儲存或列印 API 金鑰、OAuth tokens、Authorization 標頭、Provider Credentials 或原始上游回應。
- production MCP URL 固定在
https://connector.springbrand.ai/mcp；development MCP URL 固定在https://devconnector.springbrand.ai/mcp。 - 保留現有的 MCP 設定。手動 dev 備援方案僅合併
springbrand-dev條目；原生 Plugin 生命週期操作僅移除其自己的捆綁元件。 - 安裝程式不會執行任何外部第三方腳本。
- 不會將任何憑證或 tokens 放入 Skill 檔案、儲存庫內容、 URL、日誌、錯誤或最終報告中。
更新
使用每個 Host 的原生 Marketplace 更新流程來更新 Plugins。對於手動備援方案，再次傳送相同的提示；INSTALL.md / INSTALL.dev.md 會更新現有條目，而不是新增重複項。
從舊版 Plugin 版本遷移
舊版 Plugin 版本 — 已安裝的 SpringBrand Plugin 版本，在 https://connector.springbrand.ai/mcp 使用單一 springbrand MCP 條目，並使用 Gateway 的舊版混合合約（無前綴工具名稱）— 會持續運作，直到所有者的 production 版本將 /mcp 插槽切換到統一端點（Gateway ADR-0014；淘汰是 Gateway Issue 12，由所有者控制）。升級到目前具有網域前綴工具的單一條目 Plugin 是自願的 — 沒有自動淘汰。
未來：確定性安裝程式
計劃將程式化安裝程式（npx @springbrand/setup@latest）作為提示式安裝不可靠環境的確定性替代方案。目前的流程不需要它。