Плагин агента Cohesivity

Cohesivity объединяет один канонический Agent Skill с локальным MCP-сервером начальной загрузки проекта и защищённым удалённым MCP-сервером управления Cohesivity. Корень репозитория — это чистый пакет Agent Plugins 1.0; сгенерированные нативные обёртки находятся в packages/, поэтому клиентские маркеры никогда не меняют способ обнаружения переносимого корня.

Локальная начальная загрузка и удалённый OAuth независимы

Независимый от зависимостей локальный MCP-сервер cohesivity-local stdio требует Node 18 или новее, но не требует учётной записи Cohesivity. Его основной инструмент create_tenant принимает абсолютный корень проекта, получает канонический quickstart и выполняет его в этом каталоге с флагом --no-plugin. Он возвращает только несекретные метаданные тенанта. Тот же сервер предоставляет фиксированные операции claim, status и provision для Cohesivity Management API. Его инструмент provision принимает либо один ресурс, либо список ресурсов, поэтому одиночное и массовое предоставление используют один инструмент. Эти операции внутренне читают учётные данные управления .cohesivity проекта, разрешают ответы только для проекта и никогда не раскрывают ни одно из значений coh_*. Нет ни универсальной команды оболочки, ни произвольного HTTP-прокси.

Клиенты без Node не запускают этот локальный компонент. Они сохраняют документированный запасной вариант quickstart из навыка:

curl -fsSL https://cohesivity.ai/quickstart.sh | bash

Этот пакет не заявляет и не генерирует поддержку нативных бинарных файлов. С согласия пользователя любой из путей начальной загрузки может создать бесплатный временный тенант, который истекает через 72 часа, если его не заявить.

Удалённое MCP-подключение управления по адресу https://cohesivity.ai/mcp/manage отличается: оно требует входа в Cohesivity, но может быть авторизовано до того, как учётная запись получит тенант. Грант, ограниченный учётной записью, может создать первый тенант и управлять текущими или будущими принадлежащими тенантами; необязательный тенант, выбранный во время согласия, является лишь значением по умолчанию, и право собственности проверяется снова при каждом вызове тенанта. Конечная точка возвращает OAuth-вызов совместимым MCP-клиентам. Ни один пакет не содержит bearer-токен, буквальный заголовок аутентификации, секрет клиента или другие учётные данные.

Related MCP server: Synlake MCP Server

Поддерживаемые поверхности пакетов

Каждый устанавливаемый корень плагина самодостаточен: он включает skills/cohesivity/SKILL.md, mcp/project-bootstrap.mjs, соответствующую двойную MCP-конфигурацию и лицензию. packages/codex/ — это каталог маркетплейса, чей самодостаточный плагин находится в plugins/cohesivity/. Пакеты OpenAI и Codex намеренно не имеют .app.json: этот репозиторий не владеет зарегистрированным идентификатором plugin_asdk_app..., и его выдумывание не создаст действительное подключение приложения ChatGPT.

Используйте корень репозитория с клиентами, реализующими Agent Plugins 1.0, включая OpenClaw и Hermes. Используйте каталог packages/<client>/ в качестве источника, когда нативному клиенту требуется собственный корневой маркер. Например, из клона:

claude plugin marketplace add ./packages/claude
gemini extensions install ./packages/gemini
agy plugin install ./packages/antigravity

Установка плагина OpenAI управляется маркетплейсом. packages/openai/ — это автономный корень нативного плагина, а packages/codex/ — полный локальный маркетплейс Codex, указывающий на свою вложенную копию. Оба предоставляют навык, локальные инструменты Node stdio и удалённый MCP-сервер, а не зарегистрированное приложение.

OAuth и переопределения владельца

Agent Plugins 1.0 намеренно не определяет переносимое поле OAuth. Его mcp.json объявляет защищённый URL с транспортом Streamable HTTP и локальный сервер с транспортом stdio, поэтому обнаружение OAuth, взаимодействие с браузером и хранение токенов принадлежат клиенту. Клиенты могут оставить удалённый сервер отключённым и продолжать использовать навык и локальный поток временной начальной загрузки.

OpenClaw требует переопределения владельца/оператора, чтобы включить встроенное подключение в своё хранилище учётных данных OAuth. Конфигурация MCP оператора имеет приоритет над записью пакета с тем же именем:

openclaw mcp set cohesivity '{"url":"https://cohesivity.ai/mcp/manage","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login cohesivity

Hermes также хранит OAuth вне переносимых данных пакета. Его переносимый адаптер уточняет имя сервера, используя обнаруженную идентичность установки, поэтому сначала скопируйте точное имя сервера, которое сообщает Hermes. Конфигурация владельца заменяет всю запись пакета, а не отдельные поля; повторите URL, режим аутентификации и любые другие желаемые нативные поля в переопределении. Hermes рассматривает транспорт только с URL как Streamable HTTP; его нативное поле transport нужно только для выбора устаревшего sse:

mcp_servers:
  <qualified-server-name>:
    url: https://cohesivity.ai/mcp/manage
    auth: oauth

Затем выполните:

hermes mcp login <qualified-server-name>

Используйте то же сообщённое имя в обоих местах. Записи config.yaml владельца имеют приоритет над переносимыми записями, поэтому неполное переопределение может отбросить URL пакета или другие настройки вместо их дополнения.

Конфликт имени файла Antigravity

Agent Plugins и Antigravity оба требуют корневой файл с именем plugin.json, но схемы несовместимы. Agent Plugins требует свой $schema версии 1.0 и допускает переносимые метаданные; опубликованная строгая схема Antigravity допускает только name и description. Поэтому манифест Antigravity остаётся изолированным в packages/antigravity/plugin.json, а его удалённый MCP-файл использует обязательный ключ serverUrl Antigravity. Не копируйте этот манифест в корень репозитория.

Канонический навык, обёртки и артефакты установки

skills/cohesivity/SKILL.md привязан побайтово к cohesivity-org/cohesivity-skill@f97e0d2ac8a653b7d54d1bb6e70aee78a8887e60:

• версия метаданных навыка: 84fbece3c00b

• SHA-256: 3b0d9cda6167263cb35a4e3b54ed455113318a1b24cb5e341f26843456b0b589

Корневой навык является источником для каждой сгенерированной копии обёртки. Пересоберите и проверьте с помощью команд Node без зависимостей:

npm run build
npm run check
npm test

npm run build удаляет устаревшие корневые клиентские маркеры, перегенерирует каждую обёртку в фиксированном порядке, копирует канонический навык и локальные MCP-байты без изменений и пересобирает включённые в репозиторий архивы, используя существующую метку источника из манифеста. npm run check проверяет обёртки, архивы, хэши, размеры, списки файлов и дайджесты деревьев без записи и завершается ошибкой при любом устаревшем или неожиданном сгенерированном артефакте.

Версионированные входные данные установщика находятся в artifacts/v3.0.0/. Каждый клиентский архив использует отсортированные переносимые записи tar, фиксированные режимы/владельцев/временные метки и детерминированный поток gzip. install-manifest.v1.json записывает размер в байтах и SHA-256 каждого архива, а также размер/SHA-256 каждого содержащегося файла и канонический дайджест дерева. Установщики получают манифест и архив через неизменяемые URL коммитов raw.githubusercontent.com и проверяют размер и SHA-256 перед извлечением; GitHub Release не требуется.

Исходный коммит не может быть коммитом, который впервые вводит манифест, называющий сам себя. Поэтому публикация релиза использует двухэтапную метку:

1. Пересоберите обёртки и архивы, затем закоммитьте исходный код и детерминированные файлы *.tar.gz. Не публикуйте предварительный манифест на этом этапе.

2. Выполните SOURCE_COMMIT=<the-full-archive-commit> npm run artifacts. Убедитесь, что изменился только install-manifest.v1.json, затем закоммитьте этот помеченный манифест.

Первый коммит теперь является неизменяемым исходным источником для каждого URL архива в манифесте второго коммита. SOURCE_COMMIT должен быть полным строчным 40-символьным Git-коммитом; генерация не имеет временной метки или неявного резервного варианта HEAD, поэтому метка является намеренной и воспроизводимой.

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

Учётные данные проекта хранятся в .cohesivity, который должен оставаться в .gitignore. Ни coh_management_key, ни coh_application_key не должны попадать в код браузера, журналы, скриншоты, чат, манифесты плагинов или MCP-конфигурацию. Заявка тенанта, предоставление платных ресурсов, обновление плана и предоставление управляемого агента остаются явными шлюзами согласия. Локальный MCP обрабатывает учётные данные как данные, никогда не подключает файл, отклоняет символические ссылки на файлы учётных данных и использует только фиксированные именованные маршруты Management API.

Документация

• Предложения и текущие контракты API: https://cohesivity.ai/offerings/

• Индекс: https://cohesivity.ai/llms.txt

• Цены: https://cohesivity.ai/pricing

Лицензия

MIT. См. LICENSE.