workvivo-mcp

workvivo-mcp

Claude 向けの読み取り専用Workvivo MCP サーバーです。会社のアクティビティフィード、ニュース記事、コメント付きの投稿やシャウトアウト、イベント、社員ディレクトリ、スペース、通知、全文検索に対応しています。

このプロジェクトは AI（Claude Code）が開発・保守しています。ご自身の判断でご利用ください。

仕組み

Workvivo は会社のシングルサインオンの背後にあり、公開 API の利用には管理者が発行したトークンが必要です。そのため、このサーバーは独自のリクエストを送信しません。すべてのリクエストは、ContextMint Bridge 拡張機能によって fetchproxy ブリッジ（127.0.0.1:37149）経由で中継され、すでにサインイン済みの Workvivo ブラウザータブ内で実行されます。各リクエストは、セッションと権限を使って、そのタブ内で同一オリジンの fetch として実行されます。サーバーは読み取り専用です。投稿、いいね、コメント、出欠の回答、既読への変更は行いません。

セットアップ

1. ContextMint Bridge 拡張機能をインストールし、そのブラウザーで Workvivo サイト（例：https://acme.workvivo.us）にサインインします。

2. MCP クライアントにサーバーを追加します。

   {
     "mcpServers": {
       "workvivo": {
         "command": "npx",
         "args": ["-y", "workvivo-mcp"],
         "env": { "WORKVIVO_HOST": "acme.workvivo.us" }
       }
     }
   }
   

3. workvivo_healthcheck を呼び出します。初回の実行ではペアリングコードが返されます。ContextMint Bridge のポップアップで承認してください（初回のみ。信頼設定は保持されます）。

変数	必須
WORKVIVO_HOST	はい	組織の Workvivo ホスト。例：acme.workvivo.us
WORKVIVO_WS_PORT	いいえ	fetchproxy WebSocket ポートの上書き（デフォルトは 37149）。
WORKVIVO_DEBUG	いいえ	1 に設定すると、詳細なリクエスト情報を stderr に記録します。
WORKVIVO_DOWNLOAD_DIR	いいえ	リンクされたドキュメントの保存先（デフォルトは ~/Downloads/workvivo-mcp）。
WORKVIVO_MAX_DOWNLOAD_MB	いいえ	このサイズを超えるドキュメントはダウンロードせずにスキップします（デフォルトは 50）。
WORKVIVO_SKIP_FILE_TYPES	いいえ	ダウンロードしない拡張子または MIME タイプをカンマ区切りで指定します。例：mp4,.mov,video/*（デフォルトは video/*,audio/*。none を指定すると何もスキップしません）。

ツール

ツール	読み取る内容
workvivo_healthcheck	ブリッジ、拡張機能のペアリング、Workvivo へのサインインをエンドツーエンドで確認
workvivo_get_feed	ホームフィード、スペースのフィード、または人物の投稿
workvivo_list_news / workvivo_get_article	ニュース記事。本文をテキスト形式、または body_format: "markdown" を指定して Markdown 形式で取得する単一の記事
workvivo_get_post / workvivo_list_shoutouts	投稿またはシャウトアウト、最近のシャウトアウト
workvivo_get_comments	投稿、記事、イベント、シャウトアウトへのコメントと投稿者名
workvivo_get_question	Q&A の質問と回答、投票、ベストアンサー
workvivo_list_events / workvivo_get_event	今後のイベント（UTC 時刻、出欠状況）、単一のイベント
workvivo_search_people / workvivo_get_person	社員ディレクトリ、プロフィール（役職、マネージャー、自己紹介）
workvivo_get_me / workvivo_get_my_team	自分自身、自分のチーム
workvivo_list_pages / workvivo_get_page	スペース（またはグローバルコレクション）のページ階層、リンク先のページとドキュメントの一覧を含む単一ページの Markdown
workvivo_get_document	リンクされたドキュメント（PDF、Word、テキスト、HTML）を Markdown 形式で取得 — ブラウザーがセッション経由でダウンロードします
workvivo_digest_space	スペース全体を 1 つの Markdown ドキュメントにまとめて取得：すべてのページ、リンク先ドキュメントの一覧、ライブラリ、イベント、最近の投稿（任意でドキュメントのテキストも含む）
workvivo_list_spaces / workvivo_get_space	自分のスペース、すべてのスペース、トレンドのスペース、または名前で検索したスペース、単一のスペース
workvivo_list_notifications	通知と未読件数
workvivo_search	記事、投稿、イベント、人物、スペース、ドキュメントを対象とした全文検索
workvivo_api_get	その他の読み取り専用 /api/ パス（アクション形式のパスは拒否されます）
読み取りツールは、デフォルトで簡潔な投影データを返します。Workvivo のレコードを送信時のまま取得するには、view: "full" を指定します。ミーティングのパスコードやリアルタイムトークンなど、認証情報に該当するフィールドは、すべてのビューで編集されます。workvivo_list_notifications と
workvivo_list_events では、view: "brief" も指定できます。信頼できないデータのエンベロープ内に、アイテムごとに1行（`title — <UTC time	no date> — 、最大120文字）を返し、空または不完全なページには -- で始まる注記行を付けます。また、これらのツールには、読み取り可能なホスト向けのコンテキストグループヒント（_meta.mint、グループ work）が含まれます。workvivo_search` は、クエリを Workvivo の検索履歴に追加する点にご注意ください。

ドキュメント（workvivo_get_document、および include_documents を指定した workvivo_digest_space）：Workvivo のドキュメントリンクは、テナントのファイルホスト上にある有効期間の短い署名付き URL にリダイレクトされます。ブリッジは、ブラウザーがリンクをたどる際にその URL を取得するため、ファイルがブラウザーによってダウンロードされることはありません。その後、サーバーはリクエストを送信する前に、ファイルの種類（ファイル名から判定）を WORKVIVO_SKIP_FILE_TYPES と照合し、本文を読み取る前にファイルのサイズを WORKVIVO_MAX_DOWNLOAD_MB と照合します。条件を満たすファイルは、既存のファイルを上書きせずに WORKVIVO_DOWNLOAD_DIR に保存されます。URL を取得できない場合は、代わりにブラウザーがファイルをダウンロードします。その場合も同じルールが適用され、ファイルは WORKVIVO_DOWNLOAD_DIR に移動されます。これには、capture_redirect および download の権限を含むペアリングが必要です。以前のバージョンでペアリングした場合は、ContextMint Bridge のポップアップで workvivo-mcp を削除し、新しいペアコードを承認してください。

ホスト型サーバー（mcp-host）では、サーバーからファイルホストに接続できず、ブラウザーとディスクを共有していないため、代わりにブラウザーがファイルを取得し、そのバイト列をブリッジ経由で返します。これには ContextMint Bridge 1.8.0 以降が必要です。それより古いバージョンでは、更新を促すメッセージとともに拒否されます。ファイルの宣言された種類とサイズに対して、内容を使用する前に同じ種類とサイズのルールが適用されます。ただし、サイズ上限は WORKVIVO_MAX_DOWNLOAD_MB と16 MB（1回のブリッジ応答で転送できる最大サイズ）のうち、低い方になります。これを超えるファイルは、サイズと上限を示してスキップされたものとして一覧表示されます。サーバーには何も保存されません。workvivo_get_document は、テキストと、そのファイル自体をダウンロードするための有効期間の短い link を返します。

エンドポイントとその注意点については、docs/WORKVIVO-API.md に記載されています。

アップグレード

次のリリース

ホスト型サーバーで、ドキュメントの読み取り（workvivo_get_document、および include_documents を指定した workvivo_digest_space）ができるようになりました。ブラウザーがファイルを取得し、ブリッジ経由で返します。まず ContextMint Bridge を 1.8.0 以降に更新してください。それより古いバージョンでは、更新を促すメッセージとともに読み取りが失敗し、ダイジェストでは各ドキュメントがその理由とともに未取得として表示されます。

既存のペアリングは引き続き機能するため、再承認する必要はありません。ファイルホスト（attachments.<your Workvivo domain>）は、ペアリングで承認済みのドメインにすでに含まれているため、宣言されたドメインに変更はありません。（拡張機能はペアリングのドメインを集合として比較するため、変更されていた場合は、新しいペアコードの承認を求められていました。）ローカルインストールに変更はありません。

サーバーを使わない場合：workvivo-fpx スキル

skills/workvivo-fpx を使うと、シェルからも同じ読み取りアクセスができます。これは fpx CLI と、ソース可能なヘルパー（scripts/wv.sh）を使用し、各エンドポイント用の jq レシピがあらかじめ用意されています。

開発

npm install
npm run build   # tsc --noEmit + esbuild bundle → dist/bundle.js
npm test        # typecheck + vitest (all mocked; no network)

ライセンス

MIT