Springbrand.ai

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

SpringBrand Agent सेटअप

SpringBrand Production को संबंधित नेटिव Host गाइड के माध्यम से इंस्टॉल करें: WorkBuddy एक प्रकाशित R2 रिलीज़ का उपयोग करता है; Codex, Claude Code और Cursor GitHub main को बनाए रखते हैं। अन्य Agents प्रलेखित 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 सार्वभौमिक 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 की पहचान करें। Development API कुंजी केवल रनटाइम पर Host के सुरक्षित क्रेडेंशियल प्रवाह के माध्यम से प्रदान करें। ठीक एक 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-कुंजी क्रेडेंशियल प्रतिनिधित्व का स्वामी है।

पूर्ण production और development Plugins को एक साथ तभी सक्षम रखें जब Host उनकी प्रविष्टियों और रूटिंग को अलग कर सके। 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 (प्रीरिलीज़) — springbrand-gtm सहित पाँच Skills और https://devconnector.springbrand.ai/mcp के विरुद्ध आंतरिक परीक्षण के लिए एकल springbrand-dev MCP प्रविष्टि पैकेज करता है; देखें INSTALL.dev.md।
• Skill-plus-MCP फ़ॉलबैक — असमर्थित Hosts के लिए पाँच उपयोगकर्ता-स्तरीय Skills और एकल दूरस्थ MCP प्रविष्टि।

Development API कुंजी केवल रनटाइम पर अनुरोध की जाती है और कभी भी रिपॉजिटरी फ़ाइलों, Skill टेक्स्ट, URLs, लॉग्स, त्रुटियों, या रिपोर्टों में संग्रहीत नहीं की जाती है। 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-टैग पैकेज इंस्टॉल करता है, न कि main का लाइव मिरर; वर्तमान URL स्वचालित रूप से आगे नहीं बढ़ता है। अन्य Hosts अभी भी main का पालन करते हैं। R2 में रिलीज़-से-प्रकाशन वर्तमान में मैन्युअल रूप से ट्रिगर किया जाता है। Development Plugins अपरिवर्तनीय dev टैग बने रहते हैं और कभी भी 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 टैग बनाएं; किसी अलग संस्करण-सिंक कमांड की आवश्यकता नहीं है। वर्कफ़्लो कभी भी सीधे संरक्षित main पर पुश नहीं करता है या मौजूदा टैग को फिर से नहीं लिखता है।

Development रिलीज़ स्वचालित रूप से build_dev_variant.py --version ... में सिंक्रनाइज़ होते हैं। स्थानीय पूर्वावलोकन या फोर्क योगदान के लिए (जहां CI सोर्स शाखा में नहीं लिख सकता है), वही ऑपरेशन उपलब्ध है:

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

CI मुख्य, टैग और सत्यापन डिस्पैच पर बेमेल संस्करणों या मिररों को अस्वीकार करता है। स्वचालित 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 को रुकने और सीमा की रिपोर्ट करने के लिए कहता है। कुछ डेस्कटॉप Agents केवल अपने UI के माध्यम से MCP सर्वर जोड़ सकते हैं; उस स्थिति में Agent आपको मैन्युअल रूप से दर्ज करने के लिए सटीक मान देगा।

सुरक्षा

• इंस्टॉलर कभी भी API कुंजी, OAuth टोकन, Authorization हेडर, Provider Credentials, या कच्चे अपस्ट्रीम प्रतिक्रियाओं को संग्रहीत या प्रिंट नहीं करता है।
• Production MCP URL https://connector.springbrand.ai/mcp पर तय है; development MCP URL https://devconnector.springbrand.ai/mcp पर तय है।
• मौजूदा MCP कॉन्फ़िगरेशन संरक्षित है। मैन्युअल dev फ़ॉलबैक केवल springbrand-dev प्रविष्टि को मर्ज करता है; नेटिव Plugin जीवनचक्र संचालन केवल अपने स्वयं के बंडल किए गए घटकों को हटाते हैं।
• इंस्टॉलर कोई बाहरी तृतीय-पक्ष स्क्रिप्ट निष्पादित नहीं करता है।
• कोई क्रेडेंशियल या टोकन Skill फ़ाइलों, रिपॉजिटरी सामग्री, URLs, लॉग्स, त्रुटियों, या अंतिम रिपोर्टों में नहीं रखे जाते हैं।

अपडेट करना

Plugins के लिए प्रत्येक Host के नेटिव Marketplace अपडेट प्रवाह का उपयोग करें। मैन्युअल फ़ॉलबैक के लिए, वही प्रॉम्प्ट फिर से भेजें; INSTALL.md / INSTALL.dev.md डुप्लिकेट जोड़ने के बजाय मौजूदा प्रविष्टियों को अपडेट करता है।

लीगेसी Plugin रिलीज़ से माइग्रेशन

एक लीगेसी Plugin रिलीज़ — एक पहले से इंस्टॉल किया गया SpringBrand Plugin संस्करण जो Gateway के लीगेसी मिश्रित अनुबंध (अप्रीफिक्स्ड टूल नाम) के साथ https://connector.springbrand.ai/mcp पर एक एकल springbrand MCP प्रविष्टि का उपयोग करता है — तब तक काम करना जारी रखता है जब तक मालिक का production रिलीज़ /mcp स्लॉट को एकीकृत एंडपॉइंट पर स्विच नहीं करता है (Gateway ADR-0014; सेवानिवृत्ति Gateway Issue 12 है, मालिक-नियंत्रित)। डोमेन-प्रीफिक्स्ड टूल के साथ वर्तमान एकल-प्रविष्टि Plugin में अपग्रेड करना स्वैच्छिक है — कोई स्वचालित समाप्ति नहीं है।

भविष्य: नियतात्मक इंस्टॉलर

एक प्रोग्रामेटिक इंस्टॉलर (npx @springbrand/setup@latest) उन वातावरणों के लिए एक नियतात्मक विकल्प के रूप में योजनाबद्ध है जहां प्रॉम्प्ट-आधारित इंस्टॉलेशन अविश्वसनीय है। यह वर्तमान प्रवाह के लिए आवश्यक नहीं है।