vibewatch-mcp

Conecta cualquier cliente MCP a los datos de sentimiento de tu comunidad de Vibewatch.

El servidor MCP de Vibewatch expone siete herramientas de solo lectura sobre los datos de tu organización: resumen de sentimiento, tendencia de sentimiento, búsqueda de mensajes, información diaria, informes semanales, contexto de mercado y detalles de la organización. Este paquete es un puente stdio ligero hacia ese servidor: envuelve mcp-remote con la URL del servidor de Vibewatch y el manejo de autenticación integrados, además de una configuración con un solo comando para agentes de Buzz.

Uso con Buzz

Dos comandos, una aprobación en el navegador:

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

connect-buzz te inicia sesión en Vibewatch en el navegador (sin necesidad de generar ni copiar una clave), guarda en caché el inicio de sesión para reutilizarlo en modo headless y, a continuación, registra el puente en cada plataforma de agentes que encuentre en tu máquina: Claude Code, Codex y Goose. Reinicia tus agentes de Buzz y podrán responder preguntas a partir de los datos de tu comunidad.

Requiere Node 18+. El acceso a MCP es opcional por organización: un propietario o administrador lo habilita en app.vibewatch.io → Configuración → Acceso a API.

Vale la pena saber:

• El registro es a nivel de usuario: cualquier sesión de una plataforma configurada en tu máquina puede consultar Vibewatch, no solo las iniciadas por Buzz. Los datos son sentimiento de la comunidad de solo lectura para tu organización.

• Para cambiar de organización, ejecuta vibewatch-mcp connect-buzz --reset.

• Después de actualizar vibewatch-mcp, ejecuta connect-buzz una vez más: el inicio de sesión en caché está vinculado a la versión de mcp-remote incluida.

• Para deshacerlo: claude mcp remove --scope user vibewatch, codex mcp remove vibewatch, o elimina la entrada extensions.vibewatch de ~/.config/goose/config.yaml (Windows: %APPDATA%\Block\goose\config\config.yaml). Revoca el acceso de la aplicación en cualquier momento desde Configuración → Acceso a API.

Para la instalación completa de Vibewatch en Buzz (entrega de informes a un canal más una persona @vibewatch ya preparada), abre la tarjeta de Buzz en Configuración → Informes en app.vibewatch.io y sigue el tutorial de configuración.

Related MCP server: Feedback Synthesis MCP

Headless / CI: usa una clave en su lugar

Cuando no es posible iniciar sesión en el navegador, una clave con alcance de organización funciona en cualquier lugar donde se ejecute el puente:

1. En app.vibewatch.io, abre Configuración → Acceso a API y genera una clave. Las claves empiezan por vw_mcp_ y se muestran una sola vez: guárdalas como contraseñas.

2. Pásasela a connect-buzz (vibewatch-mcp connect-buzz --key vw_mcp_...) o establécela directamente donde se ejecuta el puente:

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

Las claves tienen alcance de organización y son de solo lectura; revócalas en cualquier momento desde la misma pantalla.

Uso con cualquier cliente MCP stdio

Configuración genérica de cliente (Claude Desktop y compatibles). Las aplicaciones GUI en macOS se inician con un PATH mínimo, así que usa la ruta absoluta que devuelve which vibewatch-mcp:

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

Si no hay ninguna VIBEWATCH_MCP_KEY establecida, el puente usa el inicio de sesión del navegador en caché (ejecuta connect-buzz una vez para crearlo, o la primera conexión del cliente abre la página de inicio de sesión por sí misma). Añade un bloque env con VIBEWATCH_MCP_KEY para usar una clave en su lugar.

El puente gestiona las pestañas de inicio de sesión: la apertura automática del navegador propia de mcp-remote está desactivada bajo el puente, y el puente abre la página de inicio de sesión por sí mismo: como máximo una pestaña por máquina y por inicio de sesión, sin importar cuántas sesiones de agente estén en ejecución. Eso también cubre la reautenticación a mitad de sesión (un inicio de sesión revocado o caducado con muchas sesiones activas abre una sola pestaña, no una por sesión). Si una página de inicio de sesión nunca se completa, el puente no abrirá otra: los lanzamientos posteriores (un cliente que reinicia el servidor, otras sesiones de agente) terminan con una indicación a vibewatch-mcp connect-buzz en lugar de abrir más pestañas. Inicia sesión mediante connect-buzz (o completa la pestaña abierta) para desbloquearlo; después de 24 horas, una solicitud sin respuesta caduca y se permite de nuevo una página de inicio de sesión nueva. En Windows, las sesiones de agente lanzadas al mismo tiempo también se coordinan para que solo una de ellas abra la página de inicio de sesión; las demás esperan a que termine.

Variables de entorno

Los argumentos CLI adicionales (p. ej., --debug) se transmiten a mcp-remote.

El puente nunca pone la clave en una lista de argumentos de proceso: le entrega a mcp-remote un marcador de posición ${VIBEWATCH_MCP_KEY} y mcp-remote lee el valor del entorno. Un detalle a tener en cuenta: connect-buzz --key utiliza las CLI de las plataformas (claude mcp add -e ..., codex mcp add --env ...), que solo aceptan valores de entorno como argumentos, por lo que la clave es brevemente visible en el argv de esos procesos de corta duración. Si eso importa en tu máquina, usa en su lugar el inicio de sesión en el navegador: no implica ninguna clave.

Herramientas

Licencia

Apache-2.0