Springbrand.ai

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

SpringBrand Agent Kurulumu

SpringBrand Production'ı, eşleşen yerel Host rehberi üzerinden kurun: WorkBuddy yayınlanmış bir R2 sürümü kullanır; Codex, Claude Code ve Cursor, GitHub main adresini korur. Diğer Ajanlar, belgelenen Skill-artı-MCP yedekleme yöntemini kullanır.

Bu kaynak ağacı, her ortam için beş Canonical Skill ve bir MCP girişi içerir. Yayınlanmış WorkBuddy v1.2.2 paketi aynı beş Skill'i içerir. MCP girişi beş paylaşılan Meta Aracı sunar; Domain Skill'leri, kayıtlı araç adı önekleri yerine keşfedilen operasyon sözleşmeleri aracılığıyla iş sınırlarını korur:

Skill	Rol	MCP kullanımı
springbrand-gtm	Önemli GTM iş girişi; bir Domain Skill'ine devreder	yok (MCP'yi asla çağırmaz)
ask-springbrand	Ask SpringBrand — yürütmeyen Yetenek Rehberi	yok (MCP'yi asla çağırmaz)
springbrand-platform	Platform — artefakt oluştur/yayınla, Plugin yaşam döngüsü	paylaşılan keşif, şema, yürütme ve sonuç araçları
springbrand-action-api	Action API — dinamik API hizmet yürütme	paylaşılan keşif, şema, yürütme ve sonuç araçları
springbrand-connector	Connector — yetkili üçüncü taraf sistemler	paylaşılan araçlar artı bağlantı yönetimi

Hızlı başlangıç

SpringBrand'ın iki ortamı vardır. İhtiyacınız olanı seçin ve eşleşen istemi Ajanınıza (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy veya uyumlu herhangi bir Ajan) yapıştırın.

Production

SpringBrand Production'ı kurun veya güncelleyin: https://plugin.springbrand.ai/INSTALL.md. adresini izleyin. Bu Ajanı tanımlayın, eşleşen Host rehberini kullanın, SpringBrand'ın zaten kurulu olup olmadığını tespit edin, güncellerken mevcut Marketplace/Plugin'i yerinde yenileyin, yerel OAuth'u tercih edin, mevcut yapılandırmayı koruyun ve yalnızca tamamlamam gereken UI veya OAuth adımları için duraklayın.

INSTALL.md evrensel production protokolüdür. WorkBuddy'yi yayınlanmış R2 sürümüne, diğer Host'ları mevcut GitHub yollarına yönlendirir. Eski stable dalını kullanmayın veya yayınlanmamış bir sürümü tahmin etmeyin. Production MCP girişi, Host-native OAuth gerektirir — Surface başına bir onay (tek bir yetkilendirme üç alanı da kapsar).

Development

SpringBrand development kurulum rehberini izleyerek kurulumu tamamlayın: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Önce hedef ortamı ve Host'u tanımlayın. Development API anahtarını yalnızca çalışma zamanında Host'un güvenli kimlik bilgisi akışı aracılığıyla sağlayın. Tam olarak bir springbrand-dev girişi yapılandırın, ilgisiz yapılandırmayı koruyun, yetkili kimlik kontrolünü ve yapılandırılmış MCP hizmet sağlık kontrolünü çalıştırın ve yeniden başlatma veya yeni oturum gerekip gerekmediğini bildirin. API anahtarı geçerliyken OAuth başlatmayın; manuel UI talimatlarını kullanın ve Host, Bearer kimlik bilgilerini güvenli şekilde temsil edemiyorsa durun.

Yerel development Plugin'i, değişmez ön sürüm v1.2.1-dev.2 sürümüdür. springbrand-dev olarak tanımlanır, SpringBrand Dev olarak görüntülenir ve https://devconnector.springbrand.ai/mcp adresinde tek bir springbrand-dev MCP girişi paketler. Seçilen development tanımlayıcısı, kendi yerel HTTP taşımasına ve çalışma zamanı API anahtarı kimlik bilgisi temsiline sahiptir.

Tam production ve development Plugin'lerini birlikte etkin tutun, yalnızca Host girişlerini ve yönlendirmeyi ayırt edebiliyorsa. Development kurulumu veya geçişi sırasında production girişini ve tüm ilgisiz yapılandırmayı koruyun. Manuel yedekleme, aynı beş Canonical Skill'i paylaşır ve yalnızca ayrı adlandırılmış springbrand-dev MCP girişini ekler veya günceller.

Production vs Development

	Production	Development
Kurulum rehberi	INSTALL.md	INSTALL.dev.md
MCP giriş adı	springbrand	springbrand-dev
MCP URL	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Kimlik doğrulama	Host-native OAuth	Seçilen tanımlayıcı aracılığıyla çalışma zamanı API anahtarı
Amaç	Günlük kullanım	Yalnızca test
Tam Plugin'ler birlikte var olabilir	Host'a bağlı; yönlendirme açık olmalıdır	Host'a bağlı; yönlendirme açık olmalıdır
Manuel Skill-artı-MCP yedekleme birlikte var olabilir	Evet	Evet — aynı Skill'leri paylaşır ve ayrı bir MCP giriş adı kullanır

Mevcut kaynak ve en son dev sürümü springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api ve springbrand-connector içerir; Skill sürümlerini karıştırmak yerine tutarlı bir sürüm kurun. Development yalnızca test içindir ve production yapılandırması olarak kullanılmamalıdır.

Neler kurulur

• Codex Plugin — beş Canonical Skill'i, tek production MCP bildirimini ve desteklenen macOS Codex host'ları için statik ön kontrol Hook'unu paketler.
• Claude Code Plugin — aynı beş Skill'i, tek native OAuth destekli production MCP girişini ve Claude Code CLI ile Claude Desktop Code sekmesi için statik ön kontrol Hook'unu paketler; bkz. INSTALL.claude.md.
• Cursor Plugin — beş Skill'in tümünün üretilmiş, doğrulanmış Distribution Mirror'larını, tek native OAuth destekli production MCP girişiyle ve Cursor masaüstü için her zaman uygulanan ön kontrol Kuralı ile paketler; bkz. INSTALL.cursor.md.
• WorkBuddy Plugin — bir WorkBuddy Ajanı, onu paketlenmiş CLI aracılığıyla kurar; Add Marketplace manuel yedekleme olarak kalır; bkz. INSTALL.workbuddy.md.
• SpringBrand Dev Plugin (ön sürüm) — springbrand-gtm dahil beş Skill'i ve https://devconnector.springbrand.ai/mcp karşı iç test için tek springbrand-dev MCP girişini paketler; bkz. INSTALL.dev.md.
• Skill-artı-MCP yedekleme — desteklenmeyen host'lar için beş kullanıcı düzeyi Skill ve tek uzak MCP girişi.

Development API anahtarı yalnızca çalışma zamanında istenir ve asla depo dosyalarında, Skill metinlerinde, URL'lerde, günlüklerde, hatalarda veya raporlarda saklanmaz. Production kimlik doğrulaması, production sürüm sözleşmesine ait kalır. Hiçbir Plugin, yeniden kullanılabilir kimlik bilgileri veya statik yetkilendirme başlıkları içermez.

Dağıtım kanalları

Ortam	Kurulum kanalı
Production — WorkBuddy	INSTALL.workbuddy.md içinde seçilen yayınlanmış R2 sürümü (şu anda sabitlenmiş)
Production — diğer Host'lar	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Development	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy, R2'den değişmez bir production etiketli paket kurar, main canlı bir yansımasını değil; mevcut URL otomatik olarak ilerlemez. Diğer Host'lar hâlâ main izler. R2'ye sürüm yayınlama şu anda manuel olarak tetiklenir. Development Plugin'leri değişmez dev etiketleri olarak kalır ve asla main ile birleştirilmez.

Depo düzeni

Her Canonical Skill, paket sürümünü YAML metadata.version içinde bildirir. VERSION doğruluk kaynağıdır: production sürümlerinde -dev.N işareti yoktur; development sürümleri onu içerir. name değerini her iki kanalda da küçük harfli ve sabit tutun. Bu, kurulu Skill sürümünü tanımlar, MCP sunucu sürümünü değil.

Production senkronizasyonu, main hedefleyen aynı depodaki çekme isteklerinde otomatik olarak çalışır. Sürüm yazarı VERSION ve paket manifestolarını güncelledikten sonra, CI Canonical Skill'leri damgalar, Cursor/WorkBuddy Distribution Mirror'larını günceller ve oluşturulan değişiklikleri PR dalına işler. Ardından bu yeni işleme için doğrulama gönderir. İncelenen PR'ı birleştirin ve production etiketini senkronize edilmiş işlemeden oluşturun; ayrı bir sürüm senkronizasyon komutuna gerek yoktur. İş akışı, korumalı main dalına asla doğrudan itmez veya mevcut etiketleri yeniden yazmaz.

Development sürümleri, build_dev_variant.py --version ... içinde otomatik olarak senkronize edilir. Yerel önizlemeler veya fork katkıları için (CI'nin kaynak dalına yazamadığı durumlarda), aynı işlem şu şekilde mevcuttur:

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

CI, ana, etiketler ve doğrulama gönderimlerinde uyumsuz sürümleri veya mirror'ları reddeder. Otomatik PR senkronizasyonu, iş kapsamlı contents: write ve actions: write izinlerini kullanır; doğrulama işleri salt okunur kalır. Sürüm meta verileri, uzak sürümleri kontrol etmez veya kurulu bir Skill'i güncellemez; yükseltmeler hâlâ amaçlanan kanal için belgelenen kurulum akışını kullanır.

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 ve INSTALL.dev.md çekirdek üründür. Bir Ajan tarafından okunup yürütülmek üzere yazılmıştır. Skill kaynakları skills/<machine-name>/SKILL.md içinde yaşar ve kurulum sırasında Ajan tarafından getirilir; seçilen sürüm, tam Canonical Skill setini belirler.

Gereksinimler

Ajanınız şunları desteklemelidir:

• Uzak bir URL okuma ve dosyaları kullanıcı düzeyi Skill dizininize yazma.
• Seçilen sürüm kimlik bilgisi sözleşmesiyle uzak Streamable HTTP MCP sunucuları, development için güvenli bir Bearer kimlik bilgisi mekanizması dahil.

Bunlardan biri eksikse, INSTALL.md Ajan'a durmasını ve sınırlamayı bildirmesini söyler. Bazı masaüstü Ajanlar MCP sunucularını yalnızca UI'ları aracılığıyla ekleyebilir; bu durumda Ajan size elle girmeniz gereken tam değerleri verecektir.

Güvenlik

• Kurucu, API anahtarlarını, OAuth belirteçlerini, Authorization başlıklarını, Sağlayıcı Kimlik Bilgilerini veya ham yukarı akış yanıtlarını asla saklamaz veya yazdırmaz.
• Production MCP URL'si https://connector.springbrand.ai/mcp adresinde sabittir; development MCP URL'si https://devconnector.springbrand.ai/mcp adresinde sabittir.
• Mevcut MCP yapılandırması korunur. Manuel dev yedeklemesi yalnızca springbrand-dev girişini birleştirir; native Plugin yaşam döngüsü işlemleri yalnızca kendi paketlenmiş bileşenlerini kaldırır.
• Kurucu, harici üçüncü taraf betikleri yürütmez.
• Skill dosyalarına, depo içeriğine, URL'lere, günlüklere, hatalara veya son raporlara hiçbir kimlik bilgisi veya belirteç yerleştirilmez.

Güncelleme

Plugin'ler için her host'un native Marketplace güncelleme akışını kullanın. Manuel yedekleme için aynı istemi tekrar gönderin; INSTALL.md / INSTALL.dev.md mevcut girişleri kopya eklemek yerine günceller.

Eski Plugin Sürümünden Geçiş

Eski Plugin Sürümü — https://connector.springbrand.ai/mcp adresinde tek bir springbrand MCP girişi kullanan, Gateway'in eski karışık sözleşmesiyle (öneksiz araç adları) zaten kurulu bir SpringBrand Plugin sürümü — sahibinin production sürümü /mcp yuvasını birleşik uç noktaya (Gateway ADR-0014; emeklilik, sahibi kontrollü Gateway Issue 12'dir) geçirene kadar çalışmaya devam eder. Alan önekli araçlarla mevcut tek girişli Plugin'e yükseltme isteğe bağlıdır — otomatik bir sonlandırma yoktur.

Gelecek: deterministik kurucu

Programatik bir kurucu (npx @springbrand/setup@latest), istem tabanlı kurulumun güvenilmez olduğu ortamlar için deterministik bir alternatif olarak planlanmıştır. Mevcut akış için gerekli değildir.