vibewatch-mcp

모든 MCP 클라이언트를 Vibewatch 커뮤니티 감성 데이터에 연결하세요.

Vibewatch의 MCP 서버는 조직 데이터에 대해 sentiment overview, sentiment trend, message search, daily insights, weekly reports, market context, org details 등 7개의 읽기 전용 도구를 제공합니다. 이 패키지는 해당 서버에 대한 경량 stdio 브리지입니다. Vibewatch 서버 URL과 인증 처리가 내장된 mcp-remote를 래핑하며, Buzz 에이전트를 위한 원커맨드 설정도 포함합니다.

Buzz와 함께 사용하기

두 개의 명령, 한 번의 브라우저 승인:

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

connect-buzz는 브라우저에서 Vibewatch에 로그인하고(키를 만들거나 복사할 필요 없음), 헤드리스 재사용을 위해 로그인을 캐시한 다음, 머신에서 찾은 모든 에이전트 하네스(Claude Code, Codex, Goose)에 브리지를 등록합니다. Buzz 에이전트를 다시 시작하면 커뮤니티 데이터에 대한 질문에 답할 수 있습니다.

Node 18+가 필요합니다. MCP 액세스는 조직별로 옵트인 방식입니다. 소유자 또는 관리자가 app.vibewatch.io → 설정 → API 액세스에서 활성화합니다.

알아두면 좋은 점:

• 등록은 사용자 범위입니다. 머신에서 구성된 하네스의 모든 세션이 Buzz에서 생성된 세션뿐만 아니라 Vibewatch를 쿼리할 수 있습니다. 데이터는 조직의 읽기 전용 커뮤니티 감성입니다.

• 조직을 전환하려면 vibewatch-mcp connect-buzz --reset을 실행하세요.

• vibewatch-mcp를 업그레이드한 후 connect-buzz를 한 번 더 실행하세요. 캐시된 로그인은 번들된 mcp-remote 버전에 연결되어 있습니다.

• 실행 취소하려면: claude mcp remove --scope user vibewatch, codex mcp remove vibewatch를 실행하거나 ~/.config/goose/config.yaml에서 extensions.vibewatch 항목을 삭제하세요(Windows: %APPDATA%\Block\goose\config\config.yaml). 설정 → API 액세스에서 언제든지 앱의 액세스를 취소할 수 있습니다.

Vibewatch-on-Buzz 전체 설치(채널로의 보고서 전달과 바로 사용 가능한 @vibewatch 페르소나)를 원한다면 app.vibewatch.io에서 설정 → 보고서 아래의 Buzz 타일을 열고 설정 안내를 따르세요.

Related MCP server: Feedback Synthesis MCP

헤드리스 / 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 및 호환 클라이언트). macOS의 GUI 앱은 최소 PATH로 시작하므로 which vibewatch-mcp의 절대 경로를 사용하세요:

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

VIBEWATCH_MCP_KEY가 설정되어 있지 않으면 브리지는 캐시된 브라우저 로그인을 사용합니다(만들려면 connect-buzz를 한 번 실행하세요. 또는 클라이언트의 첫 연결이 로그인 페이지를 직접 엽니다). 대신 키를 사용하려면 VIBEWATCH_MCP_KEY가 포함된 env 블록을 추가하세요.

브리지는 로그인 탭을 관리합니다. 브리지 아래에서는 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 ...)를 구동하는데, 이 CLI는 환경 변수 값을 인자로만 받으므로 키가 그 수명이 짧은 프로세스의 argv에 잠깐 노출됩니다. 이 점이 문제가 된다면 키가 전혀 필요 없는 브라우저 로그인을 대신 사용하세요.

도구

라이선스

Apache-2.0