Springbrand.ai

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

การติดตั้ง SpringBrand Agent

ติดตั้ง SpringBrand Production ผ่านคู่มือ Host ที่ตรงกัน: WorkBuddy ใช้ R2 release ที่เผยแพร่แล้ว; Codex, Claude Code และ Cursor ใช้ GitHub main อยู่ ส่วน Agent อื่นๆ ใช้ Skill-plus-MCP fallback ตามเอกสาร

source tree นี้มาพร้อม Canonical Skills ห้าชุดและ MCP entry หนึ่งชุดต่อสภาพแวดล้อม WorkBuddy v1.2.2 package ที่เผยแพร่แล้วประกอบด้วย Skills ห้าชุดเดียวกัน MCP entry เปิดเผย Meta Tools ห้าชุดที่ใช้ร่วมกัน; Domain Skills คงขอบเขตธุรกิจ ผ่าน operation contracts ที่ค้นพบ แทนที่จะใช้ registered tool name prefixes:

Skill	บทบาท	การใช้ MCP
springbrand-gtm	จุดเริ่มต้นธุรกิจ GTM หลัก; ส่งต่อให้ Domain Skill หนึ่งชุด	ไม่ใช้ (ไม่เรียก MCP)
ask-springbrand	ถาม SpringBrand — Capability Guide ที่ไม่ดำเนินการ	ไม่ใช้ (ไม่เรียก MCP)
springbrand-platform	Platform — สร้าง/เผยแพร่ artifacts, จัดการ Plugin lifecycle	เครื่องมือ discovery, schema, execution และ result ที่ใช้ร่วมกัน
springbrand-action-api	Action API — ดำเนินการบริการ API แบบไดนามิก	เครื่องมือ discovery, schema, execution และ result ที่ใช้ร่วมกัน
springbrand-connector	Connector — ระบบบุคคลที่สามที่ได้รับอนุญาต	เครื่องมือที่ใช้ร่วมกันบวกการจัดการการเชื่อมต่อ

เริ่มต้นอย่างรวดเร็ว

SpringBrand มีสองสภาพแวดล้อม เลือกสิ่งที่คุณต้องการและวาง prompt ที่ตรงกันลงใน Agent ของคุณ (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy หรือ Agent ที่เข้ากันได้อื่นๆ)

Production

ติดตั้งหรืออัปเดต SpringBrand Production โดยทำตาม https://plugin.springbrand.ai/INSTALL.md. ระบุ Agent นี้ ใช้คู่มือ Host ที่ตรงกัน ตรวจสอบว่า SpringBrand ติดตั้งอยู่แล้วหรือไม่ รีเฟรช Marketplace/Plugin ที่มีอยู่เมื่ออัปเดต เลือกใช้ OAuth แบบ native รักษาการกำหนดค่าที่มีอยู่ และหยุดเฉพาะขั้นตอน UI หรือ OAuth ที่ฉันต้องทำเอง

INSTALL.md เป็นโปรโตคอล production สากล มันนำ WorkBuddy ไปยัง R2 release ที่เผยแพร่แล้วและ Host อื่นๆ ไปยังเส้นทาง GitHub ที่มีอยู่ อย่าใช้ stable branch แบบเดิมหรือเดาเวอร์ชันที่ไม่ได้เผยแพร่ MCP entry สำหรับ production ต้องใช้ OAuth แบบ Host-native — ต้องยินยอมหนึ่งครั้งต่อ Surface (การอนุญาตเดียวครอบคลุมทั้งสามโดเมน)

Development

ทำตามคู่มือการติดตั้ง development อย่างเป็นทางการของ SpringBrand เพื่อตั้งค่าให้เสร็จ: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md ระบุสภาพแวดล้อมเป้าหมายและ Host ก่อน ให้ development API key เฉพาะตอน runtime ผ่าน secure credential flow ของ Host กำหนดค่า springbrand-dev entry เพียงหนึ่งรายการ รักษาการกำหนดค่าที่ไม่เกี่ยวข้อง เรียกใช้การตรวจสอบตัวตนตามหลักและตรวจสอบสุขภาพบริการ MCP ที่กำหนดค่า และรายงานว่าจำเป็นต้องรีสตาร์ทหรือเปิดเซสชันใหม่หรือไม่ อย่าเริ่ม OAuth เมื่อ API key ถูกต้อง ใช้คำแนะนำ UI แบบ manual และหยุดหาก Host ไม่สามารถแสดง Bearer credentials ได้อย่างปลอดภัย

native development Plugin เป็น prerelease ที่ไม่สามารถแก้ไขได้ v1.2.1-dev.2 มันถูกระบุเป็น springbrand-dev แสดงเป็น SpringBrand Dev และรวม MCP entry springbrand-dev หนึ่งรายการที่ https://devconnector.springbrand.ai/mcp descriptor development ที่เลือกเป็นเจ้าของ HTTP transport แบบ native และการแสดง API-key credentials ตอน runtime

ให้เปิดใช้งาน Plugin production และ development เต็มรูปแบบพร้อมกันเฉพาะเมื่อ Host สามารถแยกแยะ entries และ routing ได้ รักษา production entry และการกำหนดค่า ที่ไม่เกี่ยวข้องทั้งหมดระหว่างการติดตั้งหรือย้าย development fallback แบบ manual ใช้ Canonical Skills ห้าชุดเดียวกันและเพิ่มหรืออัปเดตเฉพาะ MCP entry springbrand-dev ที่แยกชื่อเท่านั้น

Production เทียบกับ Development

	Production	Development
คู่มือการติดตั้ง	INSTALL.md	INSTALL.dev.md
ชื่อ MCP entry	springbrand	springbrand-dev
MCP URL	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
การรับรองความถูกต้อง	OAuth แบบ Host-native	Runtime API key ผ่าน descriptor ที่เลือก
วัตถุประสงค์	การใช้งานประจำวัน	การทดสอบเท่านั้น
Plugin เต็มรูปแบบสามารถอยู่ร่วมกันได้	ขึ้นอยู่กับ Host; routing ต้องไม่คลุมเครือ	ขึ้นอยู่กับ Host; routing ต้องไม่คลุมเครือ
fallback แบบ manual Skill-plus-MCP สามารถอยู่ร่วมกันได้	ใช่	ใช่ — ใช้ Skills เดียวกันและใช้ชื่อ MCP entry แยกต่างหาก

source ปัจจุบันและ dev release ล่าสุดรวม springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api และ springbrand-connector; ติดตั้ง release ที่สอดคล้องกันหนึ่งชุดแทนการผสม Skill versions Development มีไว้สำหรับการทดสอบเท่านั้นและไม่ควรใช้เป็นการกำหนดค่า production

สิ่งที่ติดตั้ง

• Codex Plugin — รวม Canonical Skills ห้าชุด, การประกาศ MCP production หนึ่งรายการ และ static preflight Hook สำหรับ Codex hosts บน macOS ที่รองรับ
• Claude Code Plugin — รวม Skills ห้าชุดเดียวกัน, MCP entry production ที่ใช้ OAuth แบบ native หนึ่งรายการ และ static preflight Hook สำหรับ Claude Code CLI และ Claude Desktop Code tab; ดู INSTALL.claude.md
• Cursor Plugin — รวม Distribution Mirrors ที่สร้างและตรวจสอบแล้วของ Skills ทั้งห้าชุด พร้อม MCP entry production ที่ใช้ OAuth แบบ native หนึ่งรายการและ preflight Rule ที่ใช้เสมอสำหรับ Cursor desktop; ดู INSTALL.cursor.md
• WorkBuddy Plugin — WorkBuddy Agent ติดตั้งผ่าน CLI ที่มาพร้อมกัน; Add Marketplace ยังคงเป็น fallback แบบ manual; ดู INSTALL.workbuddy.md
• SpringBrand Dev Plugin (prerelease) — รวม Skills ห้าชุดรวมถึง springbrand-gtm และ MCP entry springbrand-dev หนึ่งรายการสำหรับการทดสอบภายในกับ https://devconnector.springbrand.ai/mcp; ดู INSTALL.dev.md
• Skill-plus-MCP fallback — Skills ระดับผู้ใช้ห้าชุดและ MCP entry ระยะไกลหนึ่งรายการสำหรับ hosts ที่ไม่รองรับ

development API key จะถูกร้องขอเฉพาะตอน runtime และไม่ถูกเก็บในไฟล์ repository, ข้อความ Skill, URLs, logs, errors หรือ reports การรับรองความถูกต้อง production ยังคงเป็นของ production release contract ไม่มี Plugin ใดมี reusable credentials หรือ static authorization headers

ช่องทางการเผยแพร่

สภาพแวดล้อม	ช่องทางการติดตั้ง
Production — WorkBuddy	R2 release ที่เผยแพร่แล้วซึ่งเลือกใน INSTALL.workbuddy.md (ปักหมุดอยู่ตอนนี้)
Production — Host อื่นๆ	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Development	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy ติดตั้ง package production-tag ที่ไม่สามารถแก้ไขได้จาก R2 ไม่ใช่ mirror สดของ main; URL ปัจจุบันไม่เลื่อนอัตโนมัติ Host อื่นๆ ยังคงทำตาม main การเผยแพร่ release ไปยัง R2 ถูกเรียกด้วยตนเองในตอนนี้ Development Plugins ยังคงเป็น dev tags ที่ไม่สามารถแก้ไขได้และไม่ถูกรวมเข้า main

โครงสร้าง Repository

Canonical Skill แต่ละชุดประกาศ package release ใน YAML metadata.version VERSION เป็นแหล่งความจริง: production versions ไม่มีเครื่องหมาย -dev.N; development releases รวมไว้ รักษา name เป็นตัวพิมพ์เล็กและคงที่ในทั้งสอง ช่องทาง นี่ระบุ Skill release ที่ติดตั้ง ไม่ใช่เวอร์ชัน MCP server

การซิงโครไนซ์ production ทำงานอัตโนมัติบน pull requests ใน repository เดียวกัน ที่กำหนดเป้าหมาย main หลังจากผู้เขียน release อัปเดต VERSION และ package manifests, CI ประทับ Canonical Skills, อัปเดต Cursor/WorkBuddy Distribution Mirrors และ commit การเปลี่ยนแปลงที่สร้างขึ้นไปยัง PR branch จากนั้นส่ง การตรวจสอบสำหรับ commit ใหม่นั้น รวม PR ที่ตรวจสอบแล้วและสร้าง production tag จาก commit ที่ซิงโครไนซ์; ไม่จำเป็นต้องใช้คำสั่ง version-sync แยกต่างหาก workflow ไม่ผลักไปยัง main ที่ป้องกันโดยตรงหรือเขียน tags ที่มีอยู่ใหม่

การซิงโครไนซ์ development releases ทำงานอัตโนมัติใน build_dev_variant.py --version ... สำหรับการแสดงตัวอย่างในเครื่องหรือการมีส่วนร่วมจาก fork (ที่ CI ไม่สามารถเขียนไปยัง source branch) การดำเนินการเดียวกันมีให้:

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

CI ปฏิเสธ versions หรือ mirrors ที่ไม่ตรงกันบน main, tags และ validation dispatches การซิงโครไนซ์ PR อัตโนมัติใช้สิทธิ์ contents: write และ actions: write ที่จำกัดขอบเขตงาน; งานตรวจสอบยังคงอ่านอย่างเดียว metadata เวอร์ชันไม่ได้ ตรวจสอบ remote releases หรืออัปเดต 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 sources อยู่ใน skills/<machine-name>/SKILL.md และถูกดึงโดย Agent ระหว่างการติดตั้ง; release ที่เลือกกำหนดชุด Canonical Skill ที่สมบูรณ์

ข้อกำหนด

Agent ของคุณต้องรองรับ:

• การอ่าน URL ระยะไกลและเขียนไฟล์ไปยังไดเรกทอรี Skill ระดับผู้ใช้ของคุณ
• MCP servers แบบ Streamable HTTP ระยะไกลพร้อมสัญญา credentials ของ release ที่เลือก รวมถึงกลไก Bearer credential ที่ปลอดภัยสำหรับ development

หากขาดอย่างใดอย่างหนึ่ง INSTALL.md บอกให้ Agent หยุดและรายงานข้อจำกัด Agent บนเดสก์ท็อปบางตัวสามารถเพิ่ม MCP servers ผ่าน UI เท่านั้น; ในกรณีนั้น Agent จะให้ค่าที่แน่นอนแก่คุณเพื่อป้อนด้วยตนเอง

ความปลอดภัย

• ตัวติดตั้งไม่เคยเก็บหรือพิมพ์ API keys, OAuth tokens, Authorization headers, Provider Credentials หรือการตอบสนอง upstream ดิบ
• production MCP URL ถูกกำหนดที่ https://connector.springbrand.ai/mcp; development MCP URL ถูกกำหนดที่ https://devconnector.springbrand.ai/mcp
• การกำหนดค่า MCP ที่มีอยู่ถูกรักษาไว้ fallback dev แบบ manual รวมเฉพาะ springbrand-dev entry; การดำเนินการ lifecycle Plugin แบบ native ลบเฉพาะส่วนประกอบที่มาพร้อมกันของตัวเอง
• ตัวติดตั้งไม่ดำเนินการสคริปต์บุคคลที่สามภายนอกใดๆ
• ไม่มี credentials หรือ tokens ถูกวางในไฟล์ Skill, เนื้อหา repository, URLs, logs, errors หรือรายงานสุดท้าย

การอัปเดต

ใช้ขั้นตอนการอัปเดต Marketplace แบบ native ของแต่ละ host สำหรับ Plugins สำหรับ fallback แบบ manual ส่ง prompt เดิมอีกครั้ง; INSTALL.md / INSTALL.dev.md อัปเดต entries ที่มีอยู่แทนการเพิ่มรายการซ้ำ

การย้ายจาก Legacy Plugin Release

Legacy Plugin Release — เวอร์ชัน SpringBrand Plugin ที่ติดตั้งแล้วซึ่งใช้ MCP entry springbrand หนึ่งรายการที่ https://connector.springbrand.ai/mcp กับสัญญาผสมแบบเดิมของ Gateway (tool names ที่ไม่มีคำนำหน้า) — ยังคงทำงานจนกว่า production release ของเจ้าของ จะสลับช่อง /mcp ไปยัง unified endpoint (Gateway ADR-0014; การเลิกใช้คือ Gateway Issue 12, ควบคุมโดยเจ้าของ) การอัปเกรดเป็น Plugin รายการเดียวปัจจุบัน ที่มี tool names ที่มีคำนำหน้าโดเมนเป็นความสมัครใจ — ไม่มีการเลิกใช้อัตโนมัติ

อนาคต: ตัวติดตั้งแบบกำหนดได้

ตัวติดตั้งแบบโปรแกรม (npx @springbrand/setup@latest) ถูกวางแผนเป็นทางเลือกที่กำหนดได้สำหรับ สภาพแวดล้อมที่การติดตั้งแบบ prompt ไม่น่าเชื่อถือ ไม่จำเป็นสำหรับขั้นตอนปัจจุบัน