Springbrand.ai

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

Настройка SpringBrand Agent

Установите SpringBrand Production через соответствующее нативное руководство Host: WorkBuddy использует опубликованный релиз R2; Codex, Claude Code и Cursor используют GitHub main. Другие Agent'ы используют документированный запасной вариант Skill-plus-MCP.

Это дерево исходников содержит пять канонических навыков и одну запись MCP для каждого окружения. Опубликованный пакет WorkBuddy v1.2.2 включает те же пять навыков. Запись MCP предоставляет пять общих Meta Tools; доменные навыки сохраняют бизнес-границы через обнаруженные контракты операций, а не через зарегистрированные префиксы имен инструментов:

Навык	Роль	Использование MCP
springbrand-gtm	Основная точка входа GTM-бизнеса; передает управление одному доменному навыку	нет (никогда не вызывает MCP)
ask-springbrand	Ask SpringBrand — неисполняемое руководство по возможностям	нет (никогда не вызывает MCP)
springbrand-platform	Платформа — создание/публикация артефактов, жизненный цикл плагинов	общие инструменты обнаружения, схемы, выполнения и результатов
springbrand-action-api	Action API — динамическое выполнение сервисов API	общие инструменты обнаружения, схемы, выполнения и результатов
springbrand-connector	Connector — авторизованные сторонние системы	общие инструменты плюс управление подключениями

Быстрый старт

SpringBrand имеет два окружения. Выберите нужное и вставьте соответствующий промпт в ваш 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, сохраняйте существующую конфигурацию и приостанавливайтесь только для шагов UI или OAuth, которые я должен выполнить.

INSTALL.md — универсальный протокол production. Он направляет WorkBuddy на опубликованный релиз R2, а другие Host'ы — на их существующие пути GitHub. Не используйте устаревшую ветку stable и не угадывайте неопубликованную версию. Запись MCP для production требует нативного OAuth Host — одно согласие на Surface (одна авторизация покрывает все три домена).

Development

Следуйте официальному руководству по установке SpringBrand для разработки, чтобы завершить настройку: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Сначала определите целевое окружение и Host. Предоставляйте ключ API для разработки только во время выполнения через защищенный поток учетных данных Host. Настройте ровно одну запись springbrand-dev, сохраняйте несвязанную конфигурацию, выполните авторитетную проверку идентичности и проверку работоспособности настроенного сервиса MCP, и сообщите, требуется ли перезапуск или новая сессия. Не запускайте OAuth, если ключ API действителен; используйте ручные инструкции UI и остановитесь, если Host не может безопасно представить учетные данные Bearer.

Нативный плагин для разработки — это неизменяемый предрелизный v1.2.1-dev.2. Он идентифицируется как springbrand-dev, отображается как SpringBrand Dev и включает одну запись MCP springbrand-dev по адресу https://devconnector.springbrand.ai/mcp. Выбранный дескриптор разработки владеет собственным нативным HTTP-транспортом и представлением учетных данных API-ключа во время выполнения.

Держите полные плагины production и development включенными вместе только тогда, когда Host может различать их записи и маршрутизацию. Сохраняйте запись production и всю несвязанную конфигурацию во время установки или миграции development. Ручной запасной вариант использует те же пять канонических навыков и добавляет или обновляет только отдельно названную запись MCP springbrand-dev.

Production vs Development

	Production	Development
Руководство по установке	INSTALL.md	INSTALL.dev.md
Имя записи MCP	springbrand	springbrand-dev
URL MCP	https://connector.springbrand.ai/mcp	https://devconnector.springbrand.ai/mcp
Аутентификация	Нативный OAuth Host	Ключ API во время выполнения через выбранный дескриптор
Назначение	Повседневное использование	Только тестирование
Полные плагины могут сосуществовать	Зависит от Host; маршрутизация должна оставаться однозначной	Зависит от Host; маршрутизация должна оставаться однозначной
Ручной запасной вариант Skill-plus-MCP может сосуществовать	Да	Да — он использует те же навыки и отдельное имя записи MCP

Текущий исходный код и последний dev-релиз включают springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api и springbrand-connector; устанавливайте один целостный релиз, а не смешивайте версии навыков. Development предназначен только для тестирования и не должен использоваться как production-конфигурация.

Что устанавливается

• Codex Plugin — включает пять канонических навыков, одну декларацию MCP для production и статический предварительный Hook для поддерживаемых macOS Codex Host'ов.
• Claude Code Plugin — включает те же пять навыков, одну нативную запись MCP для production с поддержкой OAuth и статический предварительный Hook для Claude Code CLI и вкладки кода Claude Desktop; см. INSTALL.claude.md.
• Cursor Plugin — включает сгенерированные, проверенные Distribution Mirrors всех пяти навыков с одной нативной записью MCP для production с поддержкой OAuth и постоянно применяемое предварительное правило для Cursor desktop; см. INSTALL.cursor.md.
• WorkBuddy Plugin — Agent WorkBuddy устанавливает его через встроенный CLI; Add Marketplace остается ручным запасным вариантом; см. INSTALL.workbuddy.md.
• SpringBrand Dev Plugin (предрелизный) — включает пять навыков, включая springbrand-gtm, и одну запись MCP springbrand-dev для внутреннего тестирования против https://devconnector.springbrand.ai/mcp; см. INSTALL.dev.md.
• Запасной вариант Skill-plus-MCP — пять пользовательских навыков и одна удаленная запись MCP для неподдерживаемых Host'ов.

Ключ API для разработки запрашивается только во время выполнения и никогда не хранится в файлах репозитория, тексте навыков, URL, журналах, ошибках или отчетах. Аутентификация production остается за контрактом production-релиза. Ни один плагин не содержит многоразовых учетных данных или статических заголовков авторизации.

Каналы распространения

Окружение	Канал установки
Production — WorkBuddy	Опубликованный релиз R2, выбранный в 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 устанавливает неизменяемый пакет production-тега из R2, а не живую зеркальную копию main; текущий URL не обновляется автоматически. Другие Host'ы по-прежнему следуют main. Публикация релиза в R2 в настоящее время запускается вручную. Плагины development остаются неизменяемыми dev-тегами и никогда не объединяются в main.

Структура репозитория

Каждый канонический навык объявляет релиз пакета в YAML metadata.version. VERSION — источник истины: production-версии не имеют маркера -dev.N; development-релизы включают его. Держите name в нижнем регистре и стабильным в обоих каналах. Это идентифицирует установленный релиз навыка, а не версию сервера MCP.

Синхронизация production запускается автоматически при pull request'ах в том же репозитории, нацеленных на main. После того как автор релиза обновит VERSION и манифесты пакетов, CI штампует канонические навыки, обновляет 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 отклоняет несоответствующие версии или зеркала на main, тегах и валидационных отправках. Автоматическая синхронизация PR использует разрешения contents: write и actions: write в рамках задания; валидационные задания остаются только для чтения. Метаданные версии сами по себе не проверяют удаленные релизы и не обновляют установленный навык; обновления по-прежнему используют документированный процесс установки для целевого канала.

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. Исходники навыков находятся в skills/<machine-name>/SKILL.md и извлекаются Agent'ом во время установки; выбранный релиз определяет полный набор канонических навыков.

Требования

Ваш Agent должен поддерживать:

• Чтение удаленного URL и запись файлов в каталог пользовательских навыков.
• Удаленные MCP-серверы Streamable HTTP с контрактом учетных данных выбранного релиза, включая безопасный механизм учетных данных Bearer для development.

Если что-то из этого отсутствует, INSTALL.md сообщает Agent'у остановиться и сообщить об ограничении. Некоторые настольные Agent'ы могут добавлять MCP-серверы только через свой UI; в этом случае Agent предоставит вам точные значения для ручного ввода.

Безопасность

• Установщик никогда не хранит и не печатает ключи API, токены OAuth, заголовки Authorization, учетные данные провайдера или необработанные ответы вышестоящих систем.
• URL MCP для production фиксирован на https://connector.springbrand.ai/mcp; URL MCP для development фиксирован на https://devconnector.springbrand.ai/mcp.
• Существующая конфигурация MCP сохраняется. Ручной запасной вариант dev объединяет только запись springbrand-dev; нативные операции жизненного цикла плагинов удаляют только свои собственные встроенные компоненты.
• Установщик не выполняет внешние сторонние скрипты.
• Никакие учетные данные или токены не помещаются в файлы навыков, содержимое репозитория, URL, журналы, ошибки или итоговые отчеты.

Обновление

Используйте нативный поток обновления Marketplace каждого Host для плагинов. Для ручного запасного варианта отправьте тот же промпт снова; INSTALL.md / INSTALL.dev.md обновляет существующие записи, а не добавляет дубликаты.

Миграция с устаревшего релиза плагина

Устаревший релиз плагина — уже установленная версия плагина SpringBrand, использующая одну запись MCP springbrand по адресу https://connector.springbrand.ai/mcp с устаревшим смешанным контрактом Gateway (имена инструментов без префиксов) — продолжает работать, пока production-релиз владельца не переключит слот /mcp на унифицированную конечную точку (Gateway ADR-0014; вывод из эксплуатации — Issue 12 Gateway, контролируется владельцем). Обновление до текущего однозаписного плагина с инструментами с доменными префиксами добровольно — автоматического прекращения поддержки нет.

Будущее: детерминированный установщик

Программный установщик (npx @springbrand/setup@latest) планируется как детерминированная альтернатива для сред, где установка на основе промптов ненадежна. Он не требуется для текущего процесса.