SideShift MCP for Cursor

Официальный плагин Cursor для размещённого сервера Model Context Protocol (MCP) от SideShift. Он позволяет Cursor работать с авторизованной вами компанией SideShift: находить создателей, управлять кампаниями и заявками, работать с контентом и контрактами, общаться со своей сетью контактов, просматривать аналитику и использовать остальные предоставленные вам возможности SideShift — без копирования API-ключа в Cursor.

Плагин — это небольшой, поддающийся аудиту коннектор и пакет рекомендаций. Авторитетным источником остаётся сервер, размещённый SideShift по адресу https://app.sideshift.app/api/mcp.

Установка

Когда объявление станет опубликованным, откройте в Cursor страницу Customize, найдите SideShift, выберите Install и укажите область действия — пользовательскую или проектную. Также можно ввести:

/add-plugin sideshift

Для тестирования до публикации скопируйте этот репозиторий в локальный каталог плагинов Cursor. Копия — самый надёжный вариант, поскольку текущие сборки Cursor отклоняют символические ссылки локальных плагинов, целевые объекты которых находятся за пределами этого каталога.

mkdir -p ~/.cursor/plugins/local/sideshift
rsync -a --exclude '.git/' ./ ~/.cursor/plugins/local/sideshift/

Затем выполните в Cursor команду Developer: Reload Window. Плагин должен появиться в Customize → Installed с одним MCP-сервером, одним навыком и одной командой.

Related MCP server: FluentCRM MCP Server

Безопасное подключение

Выполните /sideshift-connect или попросите Cursor:

Connect to SideShift and show me which company and scopes are active.

Первый вызов MCP запускает браузерный процесс OAuth 2.1 от SideShift. Войдите в систему, выберите нужную компанию, проверьте запрашиваемые scopes и подтвердите их. В зафиксированной конфигурации нет ни API-ключа, ни токена доступа, ни клиентского секрета, ни пользовательского заголовка авторизации, ни плейсхолдера переменной окружения.

После авторизации плагин вызывает whoami, чтобы вы могли проверить точную компанию и scopes перед началом работы. Доступ остаётся привязанным к тенанту и scopes на стороне SideShift; плагин не создаёт второй путь авторизации.

Примеры промптов

Show my active campaigns and summarize application volume for each.

Find creators who match this campaign brief, but do not contact anyone yet.

Draft a contract plan and show me the exact changes before creating anything.

Search SideShift's capability catalog for the best tool to reconcile these posts.

Обнаружение возможностей

SideShift предоставляет широкую и постоянно развивающуюся поверхность инструментов. Хосты Cursor не всегда могут поместить каждый инструмент в непосредственный контекст модели, поэтому встроенный навык использует собственный процесс обнаружения сервера, а не дублирует устаревший список инструментов:

1. Вызовите whoami, чтобы проверить активную компанию и scopes.

2. Вызовите find_capability с намерением пользователя, когда нужный инструмент ещё не виден.

3. Получите актуальную схему перед вызовом обнаруженной возможности.

4. Отсутствие scope трактуйте как запрос на повторную авторизацию, а никогда как разрешение использовать другую учётную запись или обходить сервер.

Полный актуальный справочник возможностей поддерживается в документации SideShift MCP.

Модель безопасности

• Операции чтения могут выполняться, когда они напрямую отвечают на запрос пользователя.

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

• Чувствительные действия — например, отправка сообщений или перевод денег — никогда не должны выводиться из соседнего запроса.

• Повторные попытки переиспользуют тот же переданный вызывающей стороной operation_id или ключ идемпотентности. Если результат неоднозначен, перед повтором проверьте состояние.

• Данные создателей и компаний должны оставаться в пределах компании, выбранной во время OAuth. Кросс-тенантные и неизвестные идентификаторы завершаются с отказом (fail closed).

• Результаты инструментов авторитетны. Агент не должен выдумывать отсутствующие записи, идентификаторы, разрешения или успешные исходы.

Эти клиентские инструкции дополняют серверные механизмы аутентификации, авторизации, подтверждения, sandbox и идемпотентности; они их не заменяют.

Содержимое репозитория

Разработка и проверка

Требуется Node.js 22 или новее. У плагина нет зависимостей ни времени выполнения, ни для разработки.

npm run check
npm run smoke

npm run check проверяет манифест, frontmatter компонентов, логотип, пути, конфигурацию MCP без секретов и обязательные раскрытия информации. npm run smoke выполняет только неаутентифицированные запросы на обнаружение возможностей и подтверждает, что опубликованная конечная точка возвращает ожидаемый OAuth-вызов и метаданные.

Никогда не коммитьте OAuth-токены, cookie, API-ключи, клиентские секреты, заполненные файлы окружения или данные пользователей/компаний. Для аутентифицированной проверки релиза используйте Dev Testing Don и держите критически важные инструменты вне релизного смоук-теста.

Поддержка и безопасность

• Ошибки плагина и запросы на функциональность: GitHub Issues

• Поддержка аккаунта и продукта: Контакты Side Shift

• Уязвимости безопасности: следуйте приватной процедуре уведомления в SECURITY.md

Не публикуйте учётные данные, персональные данные, данные о компаниях и сведения об уязвимостях в публичных issues.

Условия, конфиденциальность и лицензия

Использование размещаемого сервиса SideShift регулируется Условиями предоставления услуг SideShift и Политикой конфиденциальности. Специфичный поток данных в плагине описан в PRIVACY.md.

Этот репозиторий распространяется под лицензией Apache License 2.0.