vibewatch-mcp

Подключите любой MCP-клиент к вашим данным о настроениях сообщества Vibewatch.

MCP-сервер Vibewatch предоставляет семь инструментов только для чтения для работы с данными вашей организации — обзор настроений, тренд настроений, поиск сообщений, ежедневные инсайты, еженедельные отчёты, рыночный контекст и сведения об организации. Этот пакет — тонкий stdio-мост к этому серверу: он оборачивает mcp-remote со встроенными URL сервера Vibewatch и обработкой аутентификации, плюс настройка в одну команду для агентов Buzz.

Использование с Buzz

Две команды, одно подтверждение в браузере:

npm install -g vibewatch-mcp
vibewatch-mcp connect-buzz

connect-buzz выполняет вход в Vibewatch в браузере (не нужно создавать или копировать ключ), кэширует вход для повторного использования в headless-режиме, а затем регистрирует мост в каждой агентской среде, которую найдёт на вашей машине, — Claude Code, Codex и Goose. Перезапустите своих агентов Buzz, и они смогут отвечать на вопросы по данным вашего сообщества.

Требуется Node 18+. Доступ к MCP включается вручную для каждой организации — владелец или администратор включает его в app.vibewatch.io → Настройки → Доступ к API.

Полезно знать:

• Регистрация действует на уровне пользователя: любой сеанс настроенной среды на вашей машине может запрашивать Vibewatch, а не только те, что запущены из Buzz. Данные — это настроения сообщества вашей организации, доступные только для чтения.

• Чтобы переключить организацию, выполните vibewatch-mcp connect-buzz --reset.

• После обновления vibewatch-mcp запустите connect-buzz ещё раз — кэшированный вход привязан к версии встроенного mcp-remote.

• Чтобы отменить: claude mcp remove --scope user vibewatch, codex mcp remove vibewatch или удалите запись extensions.vibewatch из ~/.config/goose/config.yaml (Windows: %APPDATA%\Block\goose\config\config.yaml). Отозвать доступ приложения можно в любой момент в Настройки → Доступ к API.

Для полной установки Vibewatch-on-Buzz — доставка отчётов в канал плюс готовая персона @vibewatch — откройте плитку Buzz в разделе Настройки → Отчёты в app.vibewatch.io и следуйте инструкциям по настройке.

Related MCP server: Feedback Synthesis MCP

Headless / CI: используйте ключ

Там, где вход через браузер невозможен, ключ уровня организации работает везде, где запускается мост:

1. В app.vibewatch.io откройте Настройки → Доступ к API и создайте ключ. Ключи начинаются с vw_mcp_ и показываются только один раз — храните их как пароли.

2. Передайте его в connect-buzz (vibewatch-mcp connect-buzz --key vw_mcp_...) или укажите напрямую там, где запускается мост:

claude mcp add --scope user vibewatch -e VIBEWATCH_MCP_KEY=vw_mcp_... -- vibewatch-mcp

Ключи привязаны к организации и доступны только для чтения; отозвать их можно в любой момент на том же экране.

Использование с любым stdio MCP-клиентом

Универсальная конфигурация клиента (Claude Desktop и совместимые). GUI-приложения на macOS запускаются с минимальным PATH, поэтому используйте абсолютный путь из which vibewatch-mcp:

{
  "mcpServers": {
    "vibewatch": {
      "command": "/opt/homebrew/bin/vibewatch-mcp"
    }
  }
}

Если VIBEWATCH_MCP_KEY не задан, мост использует кэшированный вход через браузер (запустите connect-buzz один раз, чтобы создать его, — или первое подключение клиента само откроет страницу входа). Добавьте блок env с VIBEWATCH_MCP_KEY, чтобы вместо этого использовать ключ.

Мост управляет вкладками входа: собственное автоматическое открытие браузера в mcp-remote отключено при работе через мост, и мост сам открывает страницу входа — не более одной вкладки на машину на один вход, сколько бы сеансов агентов ни работало. Это покрывает и повторную аутентификацию в середине сеанса (отозванный или истёкший вход при множестве активных сеансов открывает одну вкладку, а не по одной на сеанс). Если страница входа так и не была завершена, мост не откроет другую: последующие запуски (клиент перезапускает сервер, другие сеансы агентов) завершаются с указанием на vibewatch-mcp connect-buzz вместо открытия новых вкладок. Выполните вход через connect-buzz (или завершите открытую вкладку), чтобы сбросить это состояние; через 24 часа неотвеченный запрос истекает, и снова разрешается одна новая страница входа. В Windows сеансы агентов, запущенные одновременно, также координируются, так что только один из них открывает страницу входа — остальные ждут её завершения.

Переменные окружения

Дополнительные аргументы CLI (например, --debug) передаются в mcp-remote.

Мост никогда не помещает ключ в список аргументов процесса — он передаёт mcp-remote заполнитель ${VIBEWATCH_MCP_KEY}, а mcp-remote читает значение из окружения. Один нюанс: connect-buzz --key управляет CLI агентских сред (claude mcp add -e ..., codex mcp add --env ...), которые принимают значения env только как аргументы, поэтому ключ ненадолго виден в argv этих недолговечных процессов. Если для вашей машины это важно, используйте вход через браузер — он вообще не требует ключа.

Инструменты

Лицензия

Apache-2.0