Springbrand.ai

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

Pengaturan Agent SpringBrand

Instal SpringBrand Production melalui panduan Host asli yang sesuai: WorkBuddy menggunakan rilis R2 yang dipublikasikan; Codex, Claude Code, dan Cursor mempertahankan GitHub main. Agent lain menggunakan fallback Skill-plus-MCP yang terdokumentasi.

Pohon sumber ini menyertakan lima Canonical Skills dan satu entri MCP per lingkungan. Paket WorkBuddy v1.2.2 yang dipublikasikan mencakup lima Skills yang sama. Entri MCP mengekspos lima Meta Tools bersama; Domain Skills mempertahankan batas bisnis melalui kontrak operasi yang ditemukan, bukan awalan nama alat yang terdaftar:

Skill	Peran	Penggunaan MCP
springbrand-gtm	Entri bisnis GTM substantif; menyerahkan ke satu Domain Skill	tidak ada (tidak pernah memanggil MCP)
ask-springbrand	Tanya SpringBrand — Panduan Kapabilitas non-eksekusi	tidak ada (tidak pernah memanggil MCP)
springbrand-platform	Platform — buat/publikasikan artefak, siklus hidup Plugin	alat penemuan, skema, eksekusi, dan hasil bersama
springbrand-action-api	Action API — eksekusi layanan API dinamis	alat penemuan, skema, eksekusi, dan hasil bersama
springbrand-connector	Connector — sistem pihak ketiga yang berwenang	alat bersama plus manajemen koneksi

Mulai cepat

SpringBrand memiliki dua lingkungan. Pilih yang Anda butuhkan dan tempel prompt yang sesuai ke Agent Anda (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy, atau Agent yang kompatibel lainnya).

Produksi

Instal atau perbarui SpringBrand Production dengan mengikuti https://plugin.springbrand.ai/INSTALL.md. Identifikasi Agent ini, gunakan panduan Host yang sesuai, deteksi apakah SpringBrand sudah terinstal, segarkan Marketplace/Plugin yang ada di tempat saat memperbarui, lebih suka OAuth asli, pertahankan konfigurasi yang ada, dan jeda hanya untuk langkah UI atau OAuth yang harus saya selesaikan.

INSTALL.md adalah protokol produksi universal. Ini mengarahkan WorkBuddy ke rilis R2 yang dipublikasikan dan Host lain ke jalur GitHub yang ada. Jangan gunakan cabang stable lama atau menebak versi yang tidak dipublikasikan. Entri MCP produksi memerlukan OAuth asli Host — satu persetujuan per Surface (satu otorisasi mencakup ketiga domain).

Pengembangan

Ikuti panduan instalasi pengembangan resmi SpringBrand untuk menyelesaikan pengaturan: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Identifikasi lingkungan target dan Host terlebih dahulu. Berikan kunci API pengembangan hanya saat runtime melalui alur kredensial aman Host. Konfigurasikan tepat satu entri springbrand-dev, pertahankan konfigurasi yang tidak terkait, jalankan pemeriksaan identitas otoritatif dan pemeriksaan kesehatan layanan MCP yang dikonfigurasi, dan laporkan apakah restart atau sesi baru diperlukan. Jangan luncurkan OAuth saat kunci API valid; gunakan instruksi UI manual dan berhenti jika Host tidak dapat mewakili kredensial Bearer dengan aman.

Plugin pengembangan asli adalah prarilis yang tidak dapat diubah v1.2.1-dev.2. Ini diidentifikasi sebagai springbrand-dev, ditampilkan sebagai SpringBrand Dev, dan menggabungkan satu entri MCP springbrand-dev di https://devconnector.springbrand.ai/mcp. Deskriptor pengembangan yang dipilih memiliki transport HTTP asli dan representasi kredensial kunci API runtime.

Pertahankan Plugin produksi dan pengembangan lengkap diaktifkan bersama hanya ketika Host dapat membedakan entri dan peruteannya. Pertahankan entri produksi dan semua konfigurasi yang tidak terkait selama instalasi atau migrasi pengembangan. Fallback manual berbagi lima Canonical Skills yang sama dan menambah atau memperbarui hanya entri MCP springbrand-dev yang dinamai terpisah.

Produksi vs Pengembangan

	Produksi	Pengembangan
Panduan instalasi	INSTALL.md	INSTALL.dev.md
Nama entri MCP	springbrand	springbrand-dev
URL MCP	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Autentikasi	OAuth asli Host	Kunci API runtime melalui deskriptor yang dipilih
Tujuan	Penggunaan sehari-hari	Hanya pengujian
Plugin lengkap dapat berdampingan	Tergantung Host; perutean harus tetap tidak ambigu	Tergantung Host; perutean harus tetap tidak ambigu
Fallback manual Skill-plus-MCP dapat berdampingan	Ya	Ya — berbagi Skills yang sama dan menggunakan nama entri MCP terpisah

Sumber saat ini dan rilis dev terbaru mencakup springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api, dan springbrand-connector; instal satu rilis yang koheren daripada mencampur versi Skill. Pengembangan hanya untuk pengujian dan tidak boleh digunakan sebagai konfigurasi produksi.

Apa yang diinstal

• Codex Plugin — mengemas lima Canonical Skills, deklarasi MCP produksi tunggal, dan Hook preflight statis untuk host Codex macOS yang didukung.
• Claude Code Plugin — mengemas lima Skills yang sama, satu entri MCP produksi yang didukung OAuth asli, dan Hook preflight statis untuk Claude Code CLI dan tab Kode Claude Desktop; lihat INSTALL.claude.md.
• Cursor Plugin — mengemas Distribution Mirrors yang dihasilkan dan diverifikasi dari semua lima Skills dengan satu entri MCP produksi yang didukung OAuth asli dan Rule preflight yang selalu diterapkan untuk desktop Cursor; lihat INSTALL.cursor.md.
• WorkBuddy Plugin — Agent WorkBuddy menginstalnya melalui CLI yang digabungkan; Add Marketplace tetap menjadi fallback manual; lihat INSTALL.workbuddy.md.
• SpringBrand Dev Plugin (prarilis) — mengemas lima Skills termasuk springbrand-gtm dan entri MCP tunggal springbrand-dev untuk pengujian internal terhadap https://devconnector.springbrand.ai/mcp; lihat INSTALL.dev.md.
• Fallback Skill-plus-MCP — lima Skills tingkat pengguna dan entri MCP jarak jauh tunggal untuk host yang tidak didukung.

Kunci API pengembangan diminta hanya saat runtime dan tidak pernah disimpan di file repositori, teks Skill, URL, log, kesalahan, atau laporan. Autentikasi produksi tetap dimiliki oleh kontrak rilis produksi. Tidak ada Plugin yang berisi kredensial yang dapat digunakan kembali atau header otorisasi statis.

Saluran distribusi

Lingkungan	Saluran instalasi
Produksi — WorkBuddy	Rilis R2 yang dipublikasikan dipilih di INSTALL.workbuddy.md (saat ini disematkan)
Produksi — Host lain	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Pengembangan	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy menginstal paket tag produksi yang tidak dapat diubah dari R2, bukan cermin langsung dari main; URL saat ini tidak otomatis maju. Host lain masih mengikuti main. Publikasi rilis-ke-R2 saat ini dipicu secara manual. Plugin pengembangan tetap tag dev yang tidak dapat diubah dan tidak pernah digabungkan ke main.

Tata letak repositori

Setiap Canonical Skill mendeklarasikan rilis paket di YAML metadata.version. VERSION adalah sumber kebenaran: versi produksi tidak memiliki penanda -dev.N; rilis pengembangan menyertakannya. Pertahankan name huruf kecil dan stabil di kedua saluran. Ini mengidentifikasi rilis Skill yang diinstal, bukan versi server MCP.

Sinkronisasi produksi berjalan otomatis pada permintaan tarik repositori yang sama yang menargetkan main. Setelah penulis rilis memperbarui VERSION dan manifest paket, CI menandai Canonical Skills, memperbarui Distribution Mirrors Cursor/WorkBuddy, dan melakukan perubahan yang dihasilkan ke cabang PR. Kemudian mengirimkan validasi untuk komit baru tersebut. Gabungkan PR yang ditinjau dan buat tag produksi dari komit yang disinkronkan; tidak ada perintah sinkronisasi versi terpisah yang diperlukan. Alur kerja tidak pernah mendorong ke main yang dilindungi secara langsung atau menulis ulang tag yang ada.

Rilis pengembangan disinkronkan secara otomatis di build_dev_variant.py --version .... Untuk pratinjau lokal atau kontribusi fork (di mana CI tidak dapat menulis ke cabang sumber), operasi yang sama tersedia:

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

CI menolak versi atau mirror yang tidak cocok di main, tag, dan pengiriman validasi. Sinkronisasi PR otomatis menggunakan izin contents: write dan actions: write berlingkup pekerjaan; pekerjaan validasi tetap hanya-baca. Metadata versi tidak dengan sendirinya memeriksa rilis jarak jauh atau memperbarui Skill yang diinstal; peningkatan masih menggunakan alur instalasi yang didokumentasikan untuk saluran yang dimaksud.

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 dan INSTALL.dev.md adalah produk inti. Mereka ditulis untuk dibaca dan dieksekusi oleh Agent. Sumber Skill berada di skills/<machine-name>/SKILL.md dan diambil oleh Agent selama instalasi; rilis yang dipilih menentukan set Canonical Skill lengkap.

Persyaratan

Agent Anda harus mendukung:

• Membaca URL jarak jauh dan menulis file ke direktori Skill tingkat pengguna Anda.
• Server MCP Streamable HTTP jarak jauh dengan kontrak kredensial rilis yang dipilih, termasuk mekanisme kredensial Bearer yang aman untuk pengembangan.

Jika salah satu hilang, INSTALL.md memberi tahu Agent untuk berhenti dan melaporkan keterbatasan. Beberapa Agent desktop hanya dapat menambahkan server MCP melalui UI mereka; dalam hal ini Agent akan memberi Anda nilai yang tepat untuk dimasukkan secara manual.

Keamanan

• Penginstal tidak pernah menyimpan atau mencetak kunci API, token OAuth, header Authorization, Provider Credentials, atau respons upstream mentah.
• URL MCP produksi ditetapkan di https://connector.springbrand.ai/mcp; URL MCP pengembangan ditetapkan di https://devconnector.springbrand.ai/mcp.
• Konfigurasi MCP yang ada dipertahankan. Fallback dev manual hanya menggabungkan entri springbrand-dev; operasi siklus hidup Plugin asli hanya menghapus komponen yang digabungkan sendiri.
• Penginstal tidak mengeksekusi skrip pihak ketiga eksternal apa pun.
• Tidak ada kredensial atau token yang ditempatkan di file Skill, konten repositori, URL, log, kesalahan, atau laporan akhir.

Pembaruan

Gunakan alur pembaruan Marketplace asli setiap host untuk Plugin. Untuk fallback manual, kirim prompt yang sama lagi; INSTALL.md / INSTALL.dev.md memperbarui entri yang ada daripada menambahkan duplikat.

Migrasi dari Rilis Plugin Lama

Rilis Plugin Lama — versi Plugin SpringBrand yang sudah diinstal yang menggunakan satu entri MCP springbrand di https://connector.springbrand.ai/mcp dengan kontrak campuran lama Gateway (nama alat tanpa awalan) — terus berfungsi hingga rilis produksi pemilik mengganti slot /mcp ke endpoint terpadu (Gateway ADR-0014; pensiun adalah Gateway Issue 12, dikendalikan pemilik). Meningkatkan ke Plugin entri tunggal saat ini dengan alat berawalan domain bersifat sukarela — tidak ada sunset otomatis.

Masa depan: penginstal deterministik

Penginstal terprogram (npx @springbrand/setup@latest) direncanakan sebagai alternatif deterministik untuk lingkungan di mana instalasi berbasis prompt tidak dapat diandalkan. Ini tidak diperlukan untuk alur saat ini.