Springbrand.ai

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

SpringBrand Agent Einrichtung

Installieren Sie SpringBrand Production über die passende native Host-Anleitung: WorkBuddy verwendet eine veröffentlichte R2-Version; Codex, Claude Code und Cursor behalten GitHub main. Andere Agents verwenden den dokumentierten Skill-plus-MCP-Fallback.

Dieses Quellverzeichnis enthält fünf kanonische Skills und einen MCP-Eintrag pro Umgebung. Das veröffentlichte WorkBuddy v1.2.2-Paket enthält dieselben fünf Skills. Der MCP- Eintrag stellt fünf gemeinsame Meta-Tools bereit; die Domain-Skills bewahren Geschäftsgrenzen durch entdeckte Operationsverträge statt registrierter Tool- Namenspräfixe:

Skill	Rolle	MCP-Nutzung
springbrand-gtm	Inhaltlicher GTM-Geschäftseinstieg; übergibt an einen Domain-Skill	keine (ruft MCP nie auf)
ask-springbrand	Ask SpringBrand – nicht ausführender Capability-Leitfaden	keine (ruft MCP nie auf)
springbrand-platform	Plattform – Artefakte erstellen/veröffentlichen, Plugin-Lebenszyklus	gemeinsame Discovery-, Schema-, Ausführungs- und Ergebnistools
springbrand-action-api	Action API – dynamische API-Dienstausführung	gemeinsame Discovery-, Schema-, Ausführungs- und Ergebnistools
springbrand-connector	Connector – autorisierte Drittsysteme	gemeinsame Tools plus Verbindungsverwaltung

Schnellstart

SpringBrand hat zwei Umgebungen. Wählen Sie die benötigte und fügen Sie den passenden Prompt in Ihren Agent ein (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy oder einen beliebigen kompatiblen Agent).

Production

Installieren oder aktualisieren Sie SpringBrand Production, indem Sie https://plugin.springbrand.ai/INSTALL.md. befolgen. Identifizieren Sie diesen Agent, verwenden Sie die passende Host-Anleitung, erkennen Sie, ob SpringBrand bereits installiert ist, aktualisieren Sie das bestehende Marketplace/Plugin bei Updates direkt, bevorzugen Sie natives OAuth, bewahren Sie die bestehende Konfiguration und pausieren Sie nur für UI- oder OAuth-Schritte, die ich abschließen muss.

INSTALL.md ist das universelle Produktionsprotokoll. Es leitet WorkBuddy zur veröffentlichten R2-Version und andere Hosts zu ihren bestehenden GitHub-Pfaden. Verwenden Sie nicht den veralteten stable-Zweig oder raten Sie eine unveröffentlichte Version. Der Produktions-MCP-Eintrag erfordert Host-natives OAuth – eine Zustimmung pro Oberfläche (eine einzige Autorisierung deckt alle drei Domänen ab).

Entwicklung

Befolgen Sie die offizielle SpringBrand-Entwicklungsinstallationsanleitung, um die Einrichtung abzuschließen: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Identifizieren Sie zuerst die Zielumgebung und den Host. Stellen Sie den Entwicklungs-API-Schlüssel nur zur Laufzeit über den sicheren Anmeldeinformationsfluss des Hosts bereit. Konfigurieren Sie genau einen springbrand-dev-Eintrag, bewahren Sie nicht zusammenhängende Konfiguration, führen Sie die maßgebliche Identitätsprüfung und den konfigurierten MCP-Dienst-Gesundheitscheck aus und melden Sie, ob ein Neustart oder eine neue Sitzung erforderlich ist. Starten Sie kein OAuth, wenn der API-Schlüssel gültig ist; verwenden Sie die manuellen UI-Anweisungen und stoppen Sie, wenn der Host Bearer-Anmeldeinformationen nicht sicher darstellen kann.

Das native Entwicklungs-Plugin ist die unveränderliche Vorabversion v1.2.1-dev.2. Es wird als springbrand-dev identifiziert, als SpringBrand Dev angezeigt und bündelt einen einzelnen springbrand-dev-MCP-Eintrag unter https://devconnector.springbrand.ai/mcp. Der ausgewählte Entwicklungsdeskriptor besitzt seinen nativen HTTP-Transport und die Laufzeit-API-Schlüssel-Anmeldeinformationsdarstellung.

Halten Sie die vollständigen Production- und Entwicklungs-Plugins nur dann gemeinsam aktiviert, wenn der Host ihre Einträge und das Routing unterscheiden kann. Bewahren Sie den Produktionseintrag und alle nicht zusammenhängenden Konfigurationen während der Entwicklungsinstallation oder -migration auf. Der manuelle Fallback teilt dieselben fünf kanonischen Skills und fügt nur den separat benannten springbrand-dev-MCP-Eintrag hinzu oder aktualisiert ihn.

Production vs. Entwicklung

	Production	Entwicklung
Installationsanleitung	INSTALL.md	INSTALL.dev.md
MCP-Eintragsname	springbrand	springbrand-dev
MCP-URL	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Authentifizierung	Host-natives OAuth	Laufzeit-API-Schlüssel über den ausgewählten Deskriptor
Zweck	Tägliche Nutzung	Nur zum Testen
Vollständige Plugins können koexistieren	Hostabhängig; Routing muss eindeutig bleiben	Hostabhängig; Routing muss eindeutig bleiben
Manueller Skill-plus-MCP-Fallback kann koexistieren	Ja	Ja – er teilt dieselben Skills und verwendet einen separaten MCP-Eintragsnamen

Der aktuelle Quellcode und die neueste Entwicklungsversion enthalten springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api und springbrand-connector; installieren Sie eine kohärente Version, anstatt Skill-Versionen zu mischen. Entwicklung ist nur zum Testen gedacht und sollte nicht als Produktionskonfiguration verwendet werden.

Was installiert wird

• Codex-Plugin – verpackt die fünf kanonischen Skills, die einzelne Produktions-MCP-Deklaration und einen statischen Preflight-Hook für unterstützte macOS-Codex-Hosts.
• Claude-Code-Plugin – verpackt dieselben fünf Skills, einen nativen OAuth-gestützten Produktions-MCP-Eintrag und einen statischen Preflight-Hook für Claude Code CLI und den Claude-Desktop-Code-Tab; siehe INSTALL.claude.md.
• Cursor-Plugin – verpackt generierte, verifizierte Distributionsspiegel aller fünf Skills mit einem nativen OAuth-gestützten Produktions-MCP-Eintrag und einer immer angewendeten Preflight-Regel für Cursor-Desktop; siehe INSTALL.cursor.md.
• WorkBuddy-Plugin – ein WorkBuddy-Agent installiert es über die gebündelte CLI; Add Marketplace bleibt der manuelle Fallback; siehe INSTALL.workbuddy.md.
• SpringBrand-Dev-Plugin (Vorabversion) – verpackt fünf Skills einschließlich springbrand-gtm und den einzelnen springbrand-dev-MCP-Eintrag für interne Tests gegen https://devconnector.springbrand.ai/mcp; siehe INSTALL.dev.md.
• Skill-plus-MCP-Fallback – die fünf Benutzerebene-Skills und der einzelne Remote-MCP-Eintrag für nicht unterstützte Hosts.

Der Entwicklungs-API-Schlüssel wird nur zur Laufzeit angefordert und niemals in Repository-Dateien, Skill-Texten, URLs, Protokollen, Fehlern oder Berichten gespeichert. Die Produktions- authentifizierung bleibt Eigentum des Produktionsfreigabevertrags. Kein Plugin enthält wiederverwendbare Anmeldeinformationen oder statische Autorisierungsheader.

Vertriebskanäle

Umgebung	Installationskanal
Production – WorkBuddy	Veröffentlichte R2-Version, ausgewählt in INSTALL.workbuddy.md (derzeit fixiert)
Production – andere Hosts	https://github.com/springbrand-lab/springbrand-agent-setup (main)
Entwicklung	springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2

WorkBuddy installiert ein unveränderliches Produktions-Tag-Paket von R2, keinen Live-Spiegel von main; die aktuelle URL schreitet nicht automatisch fort. Andere Hosts folgen weiterhin main. Die Veröffentlichung zu R2 wird derzeit manuell ausgelöst. Entwicklungs-Plugins bleiben unveränderliche Dev-Tags und werden niemals in main zusammengeführt.

Repository-Struktur

Jeder kanonische Skill deklariert die Paketversion in YAML metadata.version. VERSION ist die Quelle der Wahrheit: Produktionsversionen haben kein -dev.N-Markierung; Entwicklungsversionen enthalten sie. Halten Sie name in Kleinbuchstaben und stabil über beide Kanäle. Dies identifiziert die installierte Skill-Version, nicht die MCP-Serverversion.

Die Produktionssynchronisierung läuft automatisch bei Pull-Requests im selben Repository gegen main. Nachdem der Versionsautor VERSION und die Paket- Manifeste aktualisiert hat, stempelt CI die kanonischen Skills, aktualisiert Cursor/WorkBuddy-Distributions- spiegel und überträgt generierte Änderungen an den PR-Zweig. Anschließend sendet es Validierung für diesen neuen Commit. Führen Sie den geprüften PR zusammen und erstellen Sie das Produktions- Tag aus dem synchronisierten Commit; kein separater Versionssynchronisierungsbefehl ist erforderlich. Der Workflow pusht niemals direkt zu geschütztem main oder schreibt bestehende Tags um.

Entwicklungsversionen synchronisieren automatisch in build_dev_variant.py --version .... Für lokale Vorschauen oder Fork-Beiträge (wo CI nicht in den Quellzweig schreiben kann), ist dieselbe Operation verfügbar:

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

CI lehnt nicht übereinstimmende Versionen oder Spiegel auf main, Tags und Validierungsübertragungen ab. Die automatische PR-Synchronisierung verwendet auftragsbezogene contents: write- und actions: write- Berechtigungen; Validierungsjobs bleiben schreibgeschützt. Versionsmetadaten prüfen selbst keine Remote-Versionen oder aktualisieren einen installierten Skill; Upgrades verwenden weiterhin den dokumentierten Installationsablauf für den vorgesehenen Kanal.

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 und INSTALL.dev.md sind das Kernprodukt. Sie sind geschrieben, um von einem Agent gelesen und ausgeführt zu werden. Die Skill-Quellen liegen in skills/<machine-name>/SKILL.md und werden vom Agent während der Installation abgerufen; die ausgewählte Version bestimmt den vollständigen Satz kanonischer Skills.

Anforderungen

Ihr Agent muss unterstützen:

• Lesen einer Remote-URL und Schreiben von Dateien in Ihr Benutzerebene-Skill-Verzeichnis.
• Remote-Streamable-HTTP-MCP-Server mit dem ausgewählten Versions-Anmeldeinformations- vertrag, einschließlich eines sicheren Bearer-Anmeldeinformationsmechanismus für die Entwicklung.

Wenn eines davon fehlt, weist INSTALL.md den Agent an, anzuhalten und die Einschränkung zu melden. Einige Desktop-Agents können MCP-Server nur über ihre UI hinzufügen; in diesem Fall gibt Ihnen der Agent die genauen Werte zur manuellen Eingabe.

Sicherheit

• Der Installer speichert oder druckt niemals API-Schlüssel, OAuth-Tokens, Autorisierungs- header, Provider-Anmeldeinformationen oder rohe Upstream-Antworten.
• Die Produktions-MCP-URL ist festgelegt auf https://connector.springbrand.ai/mcp; die Entwicklungs-MCP-URL ist festgelegt auf https://devconnector.springbrand.ai/mcp.
• Bestehende MCP-Konfiguration wird bewahrt. Der manuelle Dev-Fallback führt nur den springbrand-dev-Eintrag zusammen; native Plugin-Lebenszyklusoperationen entfernen nur ihre eigenen gebündelten Komponenten.
• Der Installer führt keine externen Drittanbieter-Skripte aus.
• Keine Anmeldeinformationen oder Tokens werden in Skill-Dateien, Repository-Inhalten, URLs, Protokollen, Fehlern oder Abschlussberichten platziert.

Aktualisierung

Verwenden Sie für Plugins den nativen Marketplace-Aktualisierungsablauf jedes Hosts. Für den manuellen Fallback senden Sie denselben Prompt erneut; INSTALL.md / INSTALL.dev.md aktualisiert die bestehenden Einträge, anstatt Duplikate hinzuzufügen.

Migration von einer Legacy-Plugin-Version

Eine Legacy-Plugin-Version – eine bereits installierte SpringBrand-Plugin-Version, die einen einzelnen springbrand-MCP-Eintrag unter https://connector.springbrand.ai/mcp mit dem veralteten gemischten Vertrag des Gateways (nicht präfixierte Toolnamen) verwendet – funktioniert weiterhin, bis die Produktionsversion des Eigentümers den /mcp-Slot auf den einheitlichen Endpunkt umstellt (Gateway ADR-0014; Ruhestand ist Gateway-Problem 12, eigentümergesteuert). Das Upgrade auf das aktuelle Einzeleintrags-Plugin mit domänenpräfixierten Tools ist freiwillig – es gibt keine automatische Abschaltung.

Zukunft: deterministischer Installer

Ein programmatischer Installer (npx @springbrand/setup@latest) ist als deterministische Alternative für Umgebungen geplant, in denen die promptbasierte Installation unzuverlässig ist. Er ist für den aktuellen Ablauf nicht erforderlich.