Revinho

Revinho MCP 服务

Revinho 为 AI Agent 提供对 Revinho 工作区中商业智能数据的只读访问。它整合 Google Analytics 4、Stripe，以及可选的 Google Search Console，以解答发生了哪些变化、哪些事项重要、哪些因素带来收入、哪些方面表现不佳，以及下一步应重点关注什么。

此代码仓库是 Revinho 托管 MCP 服务的公开发现、连接和支持入口。生产服务由 Revinho 运营，不会从此代码仓库部署。

• MCP 端点：https://www.revinho.com/api/mcp
• 传输方式：Streamable HTTP
• 身份验证：限定工作区范围的 bearer token
• 文档：revinho.com/docs
• 注册表元数据：server.json

提供的功能

此服务提供六个专用工具：

工具	用途
get_overview	核心业绩、周期对比、趋势、获客背景、数据新鲜度和确定性信号
get_growth	渠道、来源、营销活动、国家、自然搜索查询和获客细分
get_funnels	已保存的 GA4 用户旅程和逐步漏斗表现
get_pages	页面流量、关键事件、转化、搜索需求、分类和相关影响
get_revenue	来自 Stripe 的收入、MRR、订阅、客户、退款、套餐和货币元数据
get_opportunities	按优先级排序的确定性机会，附带证据和归因来源

支持 MCP 提示词的客户端还可以调用 investigate_business。它会引导 Agent 开展范围明确、以证据为依据的调查，并在现有事实足以回答问题时停止。

所有工具均为只读、非破坏性、幂等且遵循封闭世界假设。

连接

1. 登录 Revinho，然后打开 Setup your agent。
2. 创建一个具名工作区令牌。令牌以 rv_live_ 开头，且只会显示一次。
3. 将托管端点和令牌添加到兼容 MCP 的客户端。

通用配置：

{
  "mcpServers": {
    "revinho": {
      "type": "streamable-http",
      "url": "https://www.revinho.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rv_live_REPLACE_WITH_YOUR_TOKEN"
      }
    }
  }
}

不同客户端的配置格式各不相同。若客户端支持，请使用其机密或环境变量机制。不要将令牌提交到代码仓库。

示例问题

• 过去 30 天内，业务发生了哪些变化？
• 应该优先关注哪个获客渠道？
• MRR 增长是否与流量或转化变化同时发生？
• 购买漏斗在哪一步流失的用户最多？
• 哪些页面能吸引需求，但商业表现不佳？
• 目前最有把握的机会是什么？

证据边界

使用 Revinho 的 Agent 应遵循以下产品规则：

• 收入以 Stripe 为准。
• 与获客或用户行为相关联的收入，须保留其 verified、modeled 或 associated 归因标签。
• 对非确定性的关联，只能描述为同时发生或相关联，绝不能称为因果关系。
• 数据新鲜度由提供方的新鲜度字段决定，而非响应生成时间。
• 不得将缺失或不完整的数据默认为零。
• 机会基于确定性规则和已存储的证据得出。

令牌安全

Revinho API 令牌为只读、限定工作区范围，以加密哈希形式存储，并且可以撤销。

• 为每个 Agent 或环境创建单独的令牌。
• 将令牌保存在密钥管理器或私有客户端配置中。
• 切勿将令牌放入 URL、提示词、截图、问题、日志或代码库中。
• 如果令牌可能已泄露，请立即撤销。

有关报告安全问题的信息，请参阅 SECURITY.md。

支持

• 产品与连接帮助：[email protected]
• 安全报告：[email protected]
• 文档：revinho.com/docs
• 代码库问题：对于公开且不敏感的文档或兼容性问题，请使用 GitHub Issues

许可证

本代码库中的文档和元数据采用 MIT License。Revinho 的托管服务、产品代码、名称和品牌素材不受此许可证授权。