vruum

Vruum MCP (@vruum/mcp)

AI 収益プラットフォームのVruumへ、公式 MCP 経由でアクセスできます。エージェントに収益獲得の全プロセスを任せましょう。見込み客のリサーチ、パイプラインの構築、メールや LinkedIn でのアウトリーチ、返信のトリアージ、成約までの案件管理、Stripe に裏付けられた収益の実績確認を、エンドポイントを大量に並べる代わりに35 個の複合ツールで実行できます。アウトリーチは目標を通じて行います。目標、対象者、そして対象者にアプローチする際のポリシーを設定します。

このパッケージはstdio ブリッジです。ツール群をローカルで提供し（調査には認証情報は不要）、トークンを使用して実行を https://api.vruum.ai/mcp にプロキシします。すべての呼び出しはサーバー側で認可されるため、ブリッジによって Vruum アカウントの権限を超える権限が付与されることはありません。

ヒント

リモート MCP に対応したクライアントをお使いですか？ 代わりに直接接続してください。 Claude Code、Claude Desktop、Cursor、Codex などでは、https://api.vruum.ai/mcp（OAuth 2.1）に直接接続してください。構成要素が減り、環境変数にトークンを設定する必要もありません。このブリッジは、stdio のみ対応したクライアントと、認証情報を使わないツールの調査向けです。vruum.ai/docs/mcpをご覧ください。

クイックスタート

Node 20 以降と Vruum アカウントが必要です。Web アプリの Settings → API tokens からパーソナルアクセストークン（vk_live_…）を作成してください。

{
  "mcpServers": {
    "vruum": {
      "command": "npx",
      "args": ["-y", "@vruum/mcp"],
      "env": { "VRUUM_MCP_TOKEN": "vk_live_…" }
    }
  }
}

{
  "mcpServers": {
    "vruum": {
      "command": "npx",
      "args": ["-y", "@vruum/mcp"],
      "env": { "VRUUM_MCP_TOKEN": "vk_live_…" }
    }
  }
}

[mcp_servers.vruum]
command = "npx"
args = ["-y", "@vruum/mcp"]
env = { VRUUM_MCP_TOKEN = "vk_live_…" }

npx @vruum/cli login --token vk_live_…

何も設定せずに動作を確認できます。

npx -y @modelcontextprotocol/inspector --cli npx -y @vruum/mcp --method tools/list

依頼できること

接続すると、エージェントに次のような依頼ができます。

お使いのハーネスは、レビュー画面を通じてアウトリーチ文面、返信、LinkedIn の投稿やコメントを作成します。また、manage_assistant （start_conversation、append_message）を通じて Vruum とチャットすることもできます。アプリのフローティングパネルと同じチャットで、レコードを参照し、取り消し可能な変更をレコードに適用できます。チャットではメッセージの下書きや送信は行いません。

ツール一覧

35 個の複合ツールがあります。読み取り操作では保存済みデータを確認し、書き込み操作ではデータを変更します。 書き込みの中には、プロバイダーの作業に費用が発生したり、外部への影響を伴ったりするものがあります。各ツールには、それぞれの認可と再試行の契約が記載されています。

manage_outreach は目標の作成、設定、開始、一時停止も行います。inspect_objective は目標の設定、対象者、予測、ソーシング計画を読み取ります。読み取りと書き込みを混在させるツールはありません。research_lookup は外部の照会（仕事用メールアドレス、LinkedIn プロフィール、企業ウェブサイト、採用ページ、LinkedIn の人物検索）を担い、プロバイダーのクレジットや LinkedIn の予算を消費する場合があります。get_operator_companies は、ログイン中のユーザーが操作できるワークスペースを一覧表示します。Vruum のスタッフだけに限定されるものではありません。

完全なスキーマ、説明、MCP の安全性に関する注釈は tools.json にあります。ライブサーバーの定義から生成されるもので、手作業では編集されません。

現在のパッケージには、保持済みメールに関する判断手順も manage_messages に含まれています。保存済みメールは、表示されている Action バージョン、提案のリビジョン、フィンガープリントを使用します。承認は配信確認ではありません。内容が変更された場合は、新たに作業する必要があります。

manage_assistant を使って Vruum とチャットできます。start_conversation は payload={request_id, message, context?} を受け取り、回答を最大 50 秒間待ちます。append_message は id=<chat UUID> と同じペイロードを受け取ります。結果には、チャット、ターンの状態、質問、回答、changes（チャットによって適用された各レコードの変更と、その Undo 状態）、cards が含まれます。50 秒を過ぎてもターンが実行中の場合は running を返します。後から inspect_assistant action=read id=<chat UUID> でチャットを読み取ってください。Undo で元に戻せない操作や、顧客に到達する操作、費用が発生する操作は、呼び出し内容をそのまま記載したカードとして返され、ターンは awaiting_approval を返します。manage_assistant action=decide_card id=<item UUID> payload={decision: approved|declined} は、ユーザー自身の回答がある場合に限り、該当するカードを決定します。approved の場合は、その呼び出しをユーザーの認証情報で一度だけ実行し、declined の場合は実行しません。ターンの完了を最大 50 秒間待ちます。manage_assistant action=undo id=<item UUID> は変更の正確な逆操作を実行しますが、レコードが編集済みの場合は拒否されます。action=rate id=<message UUID> は回答を評価します。不確かな応答の後に再試行する場合は、同じ request_id を使用してください。サーバーは各リクエストを一度だけ実行します。

設定

仕組み

your agent  ──stdio/JSON-RPC──▶  @vruum/mcp
                                     │
                    tools/list ──────┤  served locally from tools.json
                                     │  (no network, no credentials)
                                     │
                    tools/call ──────┴──HTTPS+Bearer──▶  api.vruum.ai/mcp
                                                          (authorized server-side)

掲載内容は、リリースに同梱される静的なスナップショットです。これにより、認証情報なしで内容を確認できます。そのため、新しく追加されたツールは次のリリースまで表示されませんが、呼び出しはプロキシ経由で実行されるため、引き続き正しく動作します。モノレポでは、tools.json がサーバー定義と食い違う変更があるとスナップショットテストが失敗するため、古い掲載内容のままリリースされることはありません。

安全性と認証情報

• サーバー側での認可。 ブリッジが権限を追加することはありません。トークンはVruumアカウントそのものであり、ロールとテナントの確認はサーバー側で行われます。
• 自動再試行はありません。 失敗したtools/callが再実行されることはありません。これらのツールの多くはアウトリーチを送信したり、料金を発生させたりします。また、結果が不明確な失敗は、サーバーですでに実行済みである可能性があります。無言で再試行すると二重送信につながるおそれがあります。接続は破棄され、その旨を示すエラーが返されるため、再実行しても安全かどうかはエージェントが判断します。
• トークンがマシンの外に出ることはありません。 例外は、api.vruum.aiへのBearerヘッダーとして送信される場合です。

警告

ブリッジは環境内の認証情報を使用します。 VRUUM_MCP_TOKENが設定されていない場合、~/.vruum/credentialsにフォールバックします。Vruum CLIにログインした状態で、MCP Inspector、クライアント、スクリプトのいずれかを通じてこのサーバーを実行すると、実際のアカウントと実際のデータに対して実行されます。書き込みツールは実際に書き込みを行います。

認証情報なしで試すには、プロセスに渡される明示的な環境を指定します。

env -i PATH="$PATH" HOME=/tmp/empty node dist/index.js

SDKのデフォルトに従うMCPクライアントは、起動するサーバーに許可リスト（HOME、PATH、SHELL、TERM、USER、LOGNAME）のみを転送することに注意してください。そのため、シェルで設定したVRUUM_CONFIG_DIRはブリッジに渡される前に削除されることがありますが、HOMEは維持されるため、認証情報ファイルが見つかってしまいます。認証情報はクライアント側のenvブロックで設定してください。

開発

このリポジトリは、リリース時に自動的に再同期されるVruumモノレポのビルド成果物です。tools.jsonはサーバー定義から生成され、モノレポのスナップショットテストは両者に差異があると失敗します。リリースの合間には、ホストされているサーバーがこのスナップショットより先に進んでいることがあります。

src/index.ts   the bridge — token resolution, static listings, proxied calls
tools.json     generated tool surface (do not edit by hand)
test/          black-box tests: spawn the built binary, speak raw JSON-RPC

npm install
npm test        # builds, then runs the black-box suite
npm run typecheck

テストでは、ビルド済みバイナリにstdin/stdout経由で入力し、SDKクライアントを介さずにワイヤーレベルで検証します。SDKを介したテストでは、サーバーがresultとerrorのどちらを返しても結果オブジェクトを問題なく返すため、プロトコル上の誤りが隠れてしまいます。テストでは、初期化ハンドシェイク、認証情報なしでの一覧表示、プロトコルエラーと実行エラーのセマンティクス、カーソルの拒否、ケイパビリティの宣言、stdoutのクリーンさを確認します。

IssueやPRを歓迎します。 メンテナーは受け入れた変更をモノレポに適用し、次回の同期時にこちらへ反映します。そのため、こちらでマージされた修正が、元のコミットではなく同期コミットの一部として反映される場合があります。tools.jsonの変更は、手作業ではなくジェネレーターから行う必要があります。

リンク

Vruum · MCPドキュメント · はじめに · CLIリファレンス

レジストリエントリー ai.vruum/mcp · ClaudeおよびCodexプラグイン vruum-gtm/skills

ライセンス

MIT