Springbrand.ai

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

Thiết lập SpringBrand Agent

Cài đặt SpringBrand Production thông qua hướng dẫn Host gốc phù hợp: WorkBuddy sử dụng bản phát hành R2 đã công bố; Codex, Claude Code và Cursor giữ GitHub main. Các Agent khác sử dụng phương án dự phòng Skill-plus-MCP đã được ghi chú.

Cây mã nguồn này cung cấp năm Canonical Skills và một mục MCP cho mỗi môi trường. Gói WorkBuddy v1.2.2 đã công bố bao gồm cùng năm Skills đó. Mục MCP cung cấp năm Meta Tools dùng chung; các Domain Skills bảo toàn ranh giới nghiệp vụ thông qua các hợp đồng thao tác được khám phá thay vì các tiền tố tên công cụ đã đăng ký:

Skill	Vai trò	Sử dụng MCP
springbrand-gtm	Điểm vào nghiệp vụ GTM chính; chuyển tiếp cho một Domain Skill	không (không bao giờ gọi MCP)
ask-springbrand	Hỏi SpringBrand — Hướng dẫn năng lực không thực thi	không (không bao giờ gọi MCP)
springbrand-platform	Nền tảng — tạo/xuất bản tạo phẩm, vòng đời Plugin	các công cụ khám phá, lược đồ, thực thi và kết quả dùng chung
springbrand-action-api	Action API — thực thi dịch vụ API động	các công cụ khám phá, lược đồ, thực thi và kết quả dùng chung
springbrand-connector	Connector — các hệ thống bên thứ ba được ủy quyền	các công cụ dùng chung cộng với quản lý kết nối

Bắt đầu nhanh

SpringBrand có hai môi trường. Chọn môi trường bạn cần và dán lời nhắc phù hợp vào Agent của bạn (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy, hoặc bất kỳ Agent tương thích nào).

Production

Cài đặt hoặc cập nhật SpringBrand Production bằng cách làm theo https://plugin.springbrand.ai/INSTALL.md. Xác định Agent này, sử dụng hướng dẫn Host phù hợp, phát hiện xem SpringBrand đã được cài đặt chưa, làm mới Marketplace/Plugin hiện có tại chỗ khi cập nhật, ưu tiên OAuth gốc, bảo toàn cấu hình hiện có, và chỉ tạm dừng cho các bước UI hoặc OAuth mà tôi phải hoàn thành.

INSTALL.md là giao thức production phổ quát. Nó định tuyến WorkBuddy đến bản phát hành R2 đã công bố và các Host khác đến các đường dẫn GitHub hiện có của họ. Không sử dụng nhánh stable kế thừa hoặc đoán một phiên bản chưa công bố. Mục MCP production yêu cầu OAuth gốc của Host — một lần đồng ý cho mỗi Surface (một ủy quyền duy nhất bao phủ cả ba miền).

Development

Làm theo hướng dẫn cài đặt development chính thức của SpringBrand để hoàn tất thiết lập: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Xác định môi trường và Host mục tiêu trước. Chỉ cung cấp khóa API development tại thời điểm chạy thông qua luồng thông tin xác thực an toàn của Host. Cấu hình chính xác một mục springbrand-dev, bảo toàn cấu hình không liên quan, chạy kiểm tra danh tính có thẩm quyền và kiểm tra sức khỏe dịch vụ MCP đã cấu hình, và báo cáo xem có cần khởi động lại hoặc phiên mới hay không. Không khởi chạy OAuth khi khóa API hợp lệ; sử dụng hướng dẫn UI thủ công và dừng lại nếu Host không thể biểu diễn thông tin xác thực Bearer một cách an toàn.

Plugin development gốc là bản tiền phát hành bất biến v1.2.1-dev.2. Nó được xác định là springbrand-dev, hiển thị dưới dạng SpringBrand Dev, và đóng gói một mục MCP springbrand-dev duy nhất tại https://devconnector.springbrand.ai/mcp. Bộ mô tả development được chọn sở hữu phương thức truyền tải HTTP gốc và biểu diễn thông tin xác thực khóa API thời gian chạy của nó.

Giữ cả hai Plugin production và development đầy đủ được bật cùng nhau chỉ khi Host có thể phân biệt các mục và định tuyến của chúng. Bảo toàn mục production và tất cả cấu hình không liên quan trong quá trình cài đặt hoặc di chuyển development. Phương án dự phòng thủ công chia sẻ cùng năm Canonical Skills và chỉ thêm hoặc cập nhật mục MCP springbrand-dev được đặt tên riêng biệt.

Production so với Development

	Production	Development
Hướng dẫn cài đặt	INSTALL.md	INSTALL.dev.md
Tên mục MCP	springbrand	springbrand-dev
URL MCP	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Xác thực	OAuth gốc của Host	Khóa API thời gian chạy thông qua bộ mô tả được chọn
Mục đích	Sử dụng hàng ngày	Chỉ để kiểm thử
Các Plugin đầy đủ có thể cùng tồn tại	Phụ thuộc vào Host; định tuyến phải không mơ hồ	Phụ thuộc vào Host; định tuyến phải không mơ hồ
Phương án dự phòng thủ công Skill-plus-MCP có thể cùng tồn tại	Có	Có — nó chia sẻ cùng Skills và sử dụng tên mục MCP riêng biệt

Mã nguồn hiện tại và bản phát hành dev mới nhất bao gồm springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api, và springbrand-connector; cài đặt một bản phát hành nhất quán thay vì trộn lẫn các phiên bản Skill. Development chỉ dành cho kiểm thử và không nên được sử dụng như một cấu hình production.

Những gì được cài đặt

• Codex Plugin — đóng gói năm Canonical Skills, khai báo MCP production duy nhất, và Hook tiền kiểm tra tĩnh cho các Host Codex macOS được hỗ trợ.
• Claude Code Plugin — đóng gói cùng năm Skills, một mục MCP production được hỗ trợ bởi OAuth gốc, và Hook tiền kiểm tra tĩnh cho Claude Code CLI và tab Code của Claude Desktop; xem INSTALL.claude.md.
• Cursor Plugin — đóng gói các Bản sao Phân phối đã tạo, đã xác minh của tất cả năm Skills với một mục MCP production được hỗ trợ bởi OAuth gốc và một Quy tắc tiền kiểm tra luôn được áp dụng cho Cursor desktop; xem INSTALL.cursor.md.
• WorkBuddy Plugin — một Agent WorkBuddy cài đặt nó thông qua CLI đi kèm; Add Marketplace vẫn là phương án dự phòng thủ công; xem INSTALL.workbuddy.md.
• SpringBrand Dev Plugin (tiền phát hành) — đóng gói năm Skills bao gồm springbrand-gtm và mục MCP springbrand-dev duy nhất để kiểm thử nội bộ chống lại https://devconnector.springbrand.ai/mcp; xem INSTALL.dev.md.
• Phương án dự phòng Skill-plus-MCP — năm Skills cấp người dùng và mục MCP từ xa duy nhất cho các Host không được hỗ trợ.

Khóa API development chỉ được yêu cầu tại thời điểm chạy và không bao giờ được lưu trữ trong các tệp kho lưu trữ, văn bản Skill, URL, nhật ký, lỗi hoặc báo cáo. Xác thực production vẫn thuộc sở hữu của hợp đồng phát hành production. Không Plugin nào chứa thông tin xác thực tái sử dụng hoặc tiêu đề ủy quyền tĩnh.

Các kênh phân phối

Môi trường	Kênh cài đặt
Production — WorkBuddy	Bản phát hành R2 đã công bố được chọn trong INSTALL.workbuddy.md (hiện đang ghim)
Production — các Host khác	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Development	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy cài đặt một gói thẻ production bất biến từ R2, không phải bản sao trực tiếp của main; URL hiện tại không tự động nâng cấp. Các Host khác vẫn làm theo main. Việc xuất bản Release-to-R2 hiện được kích hoạt thủ công. Các Plugin development vẫn là các thẻ dev bất biến và không bao giờ được hợp nhất vào main.

Bố cục kho lưu trữ

Mỗi Canonical Skill khai báo bản phát hành gói trong YAML metadata.version. VERSION là nguồn chân lý: các phiên bản production không có dấu hiệu -dev.N; các bản phát hành development bao gồm nó. Giữ name ở dạng chữ thường và ổn định trên cả hai kênh. Điều này xác định bản phát hành Skill đã cài đặt, không phải phiên bản máy chủ MCP.

Đồng bộ hóa production chạy tự động trên các yêu cầu kéo cùng kho lưu trữ nhắm vào main. Sau khi tác giả phát hành cập nhật VERSION và các tệp kê khai gói, CI đóng dấu các Canonical Skills, cập nhật các Bản sao Phân phối Cursor/WorkBuddy, và cam kết các thay đổi đã tạo vào nhánh PR. Sau đó, nó gửi xác thực cho cam kết mới đó. Hợp nhất PR đã xem xét và tạo thẻ production từ cam kết đã đồng bộ; không cần lệnh đồng bộ phiên bản riêng biệt. Quy trình làm việc không bao giờ đẩy trực tiếp vào main được bảo vệ hoặc viết lại các thẻ hiện có.

Các bản phát hành development đồng bộ hóa tự động trong build_dev_variant.py --version .... Đối với các bản xem trước cục bộ hoặc đóng góp fork (nơi CI không thể ghi vào nhánh nguồn), thao tác tương tự có sẵn:

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

CI từ chối các phiên bản hoặc bản sao không khớp trên main, các thẻ và các lần gửi xác thực. Đồng bộ hóa PR tự động sử dụng các quyền contents: write và actions: write theo phạm vi công việc; các công việc xác thực vẫn ở chế độ chỉ đọc. Siêu dữ liệu phiên bản không tự kiểm tra các bản phát hành từ xa hoặc cập nhật một Skill đã cài đặt; các nâng cấp vẫn sử dụng luồng cài đặt đã ghi chú cho kênh dự định.

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 và INSTALL.dev.md là sản phẩm cốt lõi. Chúng được viết để được đọc và thực thi bởi một Agent. Các nguồn Skill nằm trong skills/<machine-name>/SKILL.md và được Agent tìm nạp trong quá trình cài đặt; bản phát hành được chọn xác định bộ Canonical Skill hoàn chỉnh.

Yêu cầu

Agent của bạn phải hỗ trợ:

• Đọc một URL từ xa và ghi các tệp vào thư mục Skill cấp người dùng của bạn.
• Máy chủ MCP Streamable HTTP từ xa với hợp đồng thông tin xác thực bản phát hành đã chọn, bao gồm một cơ chế thông tin xác thực Bearer an toàn cho development.

Nếu thiếu một trong hai, INSTALL.md yêu cầu Agent dừng lại và báo cáo giới hạn. Một số Agent desktop chỉ có thể thêm máy chủ MCP thông qua UI của chúng; trong trường hợp đó, Agent sẽ cung cấp cho bạn các giá trị chính xác để nhập thủ công.

An toàn

• Trình cài đặt không bao giờ lưu trữ hoặc in khóa API, mã thông báo OAuth, tiêu đề Ủy quyền, Thông tin xác thực Nhà cung cấp hoặc phản hồi thô từ thượng nguồn.
• URL MCP production được cố định tại https://connector.springbrand.ai/mcp; URL MCP development được cố định tại https://devconnector.springbrand.ai/mcp.
• Cấu hình MCP hiện có được bảo toàn. Phương án dự phòng dev thủ công chỉ hợp nhất mục springbrand-dev; các thao tác vòng đời Plugin gốc chỉ loại bỏ các thành phần đi kèm của chính chúng.
• Trình cài đặt không thực thi bất kỳ tập lệnh bên thứ ba bên ngoài nào.
• Không có thông tin xác thực hoặc mã thông báo nào được đặt trong các tệp Skill, nội dung kho lưu trữ, URL, nhật ký, lỗi hoặc báo cáo cuối cùng.

Cập nhật

Sử dụng luồng cập nhật Marketplace gốc của mỗi Host cho các Plugin. Đối với phương án dự phòng thủ công, hãy gửi lại cùng lời nhắc; INSTALL.md / INSTALL.dev.md cập nhật các mục hiện có thay vì thêm các mục trùng lặp.

Di chuyển từ Bản phát hành Plugin Kế thừa

Bản phát hành Plugin Kế thừa — một phiên bản Plugin SpringBrand đã cài đặt sử dụng một mục MCP springbrand duy nhất tại https://connector.springbrand.ai/mcp với hợp đồng hỗn hợp kế thừa của Gateway (tên công cụ không có tiền tố) — tiếp tục hoạt động cho đến khi bản phát hành production của chủ sở hữu chuyển vị trí /mcp sang điểm cuối hợp nhất (Gateway ADR-0014; ngừng hoạt động là Vấn đề Gateway 12, do chủ sở hữu kiểm soát). Việc nâng cấp lên Plugin một mục hiện tại với các công cụ có tiền tố miền là tự nguyện — không có thời hạn ngừng hoạt động tự động.

Tương lai: trình cài đặt xác định

Một trình cài đặt theo chương trình (npx @springbrand/setup@latest) được lên kế hoạch như một phương án thay thế xác định cho các môi trường nơi cài đặt dựa trên lời nhắc không đáng tin cậy. Nó không bắt buộc cho luồng hiện tại.