vibewatch-mcp

あらゆるMCPクライアントをVibewatchのコミュニティ感情データに接続します。

VibewatchのMCPサーバーは、組織のデータに対して7つの読み取り専用ツールを公開しています — 感情の概要、感情のトレンド、メッセージ検索、日次インサイト、週次レポート、市場コンテキスト、組織の詳細。このパッケージは、そのサーバーへの薄いstdioブリッジです。mcp-remoteをVibewatchサーバーURLと認証処理を組み込んでラップし、さらにBuzzエージェント向けのワンコマンドセットアップを提供します。

Buzzでの使用

2つのコマンド、1回のブラウザ承認:

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

connect-buzzはブラウザでVibewatchにサインインし（キーの発行やコピーは不要）、ヘッドレス再利用のためにサインインをキャッシュし、マシン上で見つかったすべてのエージェントハーネス（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、または~/.config/goose/config.yaml（Windows: %APPDATA%\Block\goose\config\config.yaml）からextensions.vibewatchエントリを削除します。アプリのアクセスはいつでも設定 → 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自身のブラウザ自動オープンはブリッジ下で無効になり、ブリッジがサインインページを自分で開きます — エージェントセッションがいくつ実行されていても、サインインごとにマシン全体で最大1つのタブです。これにはセッション中の再認証も含まれます（失効または期限切れのサインインで多数のライブセッションがある場合、セッションごとに1つではなく1つのタブが開きます）。サインインページが完了しない場合、ブリッジは別のページを開きません: 後続のスパウン（クライアントがサーバーを再起動する、他のエージェントセッション）は、さらにタブを開く代わりにvibewatch-mcp connect-buzzへのポインタを表示して終了します。connect-buzzでサインインするか（または開いているタブを完了して）解除します。24時間後、未回答のプロンプトは期限切れになり、新しいサインインページが1つだけ再度許可されます。Windowsでは、同時に起動されたエージェントセッションも連携し、1つだけがサインインページを開き、他はそれが完了するのを待ちます。

環境変数

追加のCLI引数（例: --debug）はmcp-remoteに渡されます。

ブリッジはキーをプロセス引数リストに置くことはありません — mcp-remoteに${VIBEWATCH_MCP_KEY}プレースホルダーを渡し、mcp-remoteが環境から値を読み取ります。1つの注意点: connect-buzz --keyはハーネスCLI（claude mcp add -e ...、codex mcp add --env ...）を駆動しますが、これらはenv値を引数としてのみ受け付けるため、キーはそれらの短命プロセスのargvに一時的に表示されます。それがマシン上で問題になる場合は、代わりにブラウザサインインを使用してください — キーは一切関与しません。

ツール

ライセンス

Apache-2.0