vruum

Vruum MCP（@vruum/mcp）

通过官方 MCP 接入 Vruum，这是一款 AI 营收平台。通过 35 个复合工具，让你的 Agent 负责整个营收流程，而不必应付大量端点：研究潜在客户、构建销售管道、开展电子邮件和 LinkedIn 外联、筛选回复、管理交易直至成交，并读取以 Stripe 为准的营收数据。外联在目标中运行：包括目标、目标对象，以及触达策略。

这个软件包是一个 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

你可以提出的请求

连接后，可以向 Agent 提出以下常见请求：

你的工作台会通过相应的审核界面撰写外联文案、回复、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> 和相同的 payload。结果会列出聊天、当前轮次的状态、问题、答复、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 绝不会重放。这些工具中有许多会发送推广内容或花费资金，而不明确的失败可能意味着服务端已经执行了操作——静默重试可能导致重复发送。连接会被丢弃，错误信息会明确说明这一点，由你的 Agent 决定重新运行是否安全。
• 你的令牌绝不会离开你的机器，唯一例外是作为 Bearer 标头发送到 api.vruum.ai。

警告

桥接程序会使用环境中已有的凭据。 如果未设置 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）转发给启动的服务——因此，在 shell 中设置的 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，SDK 都会照常返回结果对象。测试涵盖初始化握手、无凭据工具列表、协议错误与执行错误的语义、游标拒绝、能力声明以及 stdout 输出规范。

欢迎提交问题和 PR。 维护者会在单体代码库中应用被接受的更改，并在下次同步时将其带回——因此，此处合并的修复可能会作为同步提交的一部分出现，而不是出现在你的原始提交中。对 tools.json 的更改必须由生成器生成，不得手动修改。

链接

Vruum · MCP 文档 · 入门指南 · CLI 参考

注册表条目 ai.vruum/mcp · Claude 和 Codex 插件 vruum-gtm/skills

许可证

MIT