使用说明

Rybbit MCP服务器

[！注意] Rybbit现在发货官方MCP服务器 -Rybbit本身内置的托管远程端点，具有OAuth和作用域API-key支持。此套餐提供 全功能奇偶校验 有了它，再加上它没有的额外工具（复合摘要、周期比较、批处理事件摄取、约20个额外的读取端点），以及为没有远程MCP/Outh支持的客户端提供的本地stdio传输。看这与官方Rybbit MCP相比如何.

MCP（模型上下文协议）服务器 Rybbit分析 API它使MCP兼容的AI助手能够访问您的Rybbit Analytics数据和管理功能，允许您使用自然语言查询流量、会话、事件、用户、目标、漏斗、性能、错误等。问一些问题，比如“上周有多少人访问了，他们浏览了哪些页面？”并得到详细的答案。

安装

无需安装！使用 npx 直接跑步。

或全局安装：

npm install -g rybbit-mcp-server

配置

环境变量

变量	必填	默认	描述
`RYBBIT_API_KEY`	是	-	您的Rybbit API密钥
`RYBBIT_URL`	没有	`https://app.rybbit.io`	Rybbit API的基本URL（用于自托管实例）
`RYBBIT_CACHE_TTL`	没有	`60`	在内存中缓存GET响应的秒数(`0` 禁用；实时访问者计数从不缓存）
`RYBBIT_READ_ONLY`	否	关闭	设置为 `1` 或 `true` 以只读方式运行：所有18个编写工具（目标/漏斗/站点/团队创建更新删除、成员管理、用户标识/特征/删除、事件跟踪）都隐藏在工具列表中，如果被调用，则会被拒绝

获取API密钥

导航到“设置”→ Rybbit仪表板中的帐户
转到API密钥部分
使用自定义名称创建密钥
立即复制（不再显示）

这与官方Rybbit MCP相比如何

与官方MCP v0.3.0（Rybbit v2.7.02026年7月）相比。

能力	官方MCP	此套餐
分析阅读（概述、时间序列、细分、实时、留存、旅程、网络生命体征、错误）	✅	✅
会话、事件、用户（原始数据读取）	✅	✅
目标和漏斗（读取、分析、CRUD）	✅	✅
站点和组织（CRUD，成员）	✅	✅
原始只读ClickHouse SQL(`run_query` +架构）	✅	✅
用户身份/特征/GDPR删除	✅	✅
团队和成员站点访问管理	✅	✅
额外的读取工具（目标会话、漏斗步骤会话、性能时间序列和按维度、错误事件和时间序列、会话位置、用户会话计数、事件属性、出站链接）	❌	✅
事件摄取(`rybbit_track_event`)	❌	✅
批处理事件摄取(`rybbit_track_events`，每次通话1-50次）	❌	✅
综合文摘(`rybbit_get_site_summary`)	❌	✅
期间比较(`rybbit_compare_periods`)	❌	✅
响应缓存+速率限制感知	❌	✅
通过env标志的只读模式	❌	✅
本地stdio传输（不需要远程MCP/Outhor支持）	❌	✅
托管远程终结点（无需在本地运行）	✅	❌
OAuth授权流程	✅	❌

两者都使用相同的Rybbit API密钥进行身份验证，并命中相同的公共REST API，因此范围键(resource:action 权限）工作方式相同：读取需要匹配 :read 范围，写需要 :write （写意味着读），以及破坏性操作另外需要组织管理员/所有者角色。 rybbit_run_query 需求 sql:read; 服务器端事件接收标记为可信 ingest:write.官方服务器可以使用作用域API密钥近似只读操作；此包的RYBBIT_READ_ONLY标志适用于任何键，并与作用域键组合。

用法

使用克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "rybbit": {
      "command": "npx",
      "args": ["rybbit-mcp-server"],
      "env": {
        "RYBBIT_API_KEY": "your_api_key_here"
      }
    }
  }
}

对于自托管Rybbit实例，添加 RYBBIT_URL 环境变量：

{
  "mcpServers": {
    "rybbit": {
      "command": "npx",
      "args": ["rybbit-mcp-server"],
      "env": {
        "RYBBIT_API_KEY": "your_api_key_here",
        "RYBBIT_URL": "https://your-rybbit-instance.com"
      }
    }
  }
}

使用克劳德代码

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "rybbit": {
      "command": "npx",
      "args": ["rybbit-mcp-server"],
      "env": {
        "RYBBIT_API_KEY": "your_api_key_here",
        "RYBBIT_URL": "https://your-rybbit-instance.com"
      }
    }
  }
}

独立

npx rybbit-mcp-server

# Or if installed globally:
rybbit-mcp-server

示例问题

你问。..	使用的工具
“上周有多少人访问过，他们浏览了哪些页面？”	`rybbit_get_site_summary`
“显示本月每日流量趋势”	`rybbit_get_overview_timeseries`
“我的交通从哪里来？”	`rybbit_get_metric` （推荐人、国家、utm_source）
“谁是我最活跃的用户，他们做了什么？”	`rybbit_get_users` → `rybbit_get_user_sessions`
“追踪一位访客的旅程”	`rybbit_get_user_sessions` → `rybbit_get_session_details`
“现在网站上有多少人？”	`rybbit_get_live_visitors`
“网站健康吗？”	`rybbit_get_performance_overview` + `rybbit_get_error_names`
“我的注册渠道如何转换？”	`rybbit_get_funnels` → `rybbit_analyze_funnel`
“通过我的网站最常见的路径是什么？”	`rybbit_get_journeys`
“用户会回来吗？”	`rybbit_get_retention`

可用工具

概述和指标

rybbit_get_overview -获取高级分析（会话、页面浏览量、用户、跳出率）
rybbit_get_overview_timeseries -获取时间序列分析数据
rybbit_get_metric -按参数（浏览器、国家等）获取尺寸细分
rybbit_get_live_visitors -获取当前活跃访客的计数

会话

rybbit_get_sessions -获取会话的分页列表
rybbit_get_session_details -获取活动的详细会话信息
rybbit_get_session_locations -获取用于地图可视化的会话位置

事件

rybbit_get_events -获取事件的分页列表（支持since Timestamp/before Timestamp游标）
rybbit_get_event_names -获取具有计数的唯一事件名称
rybbit_get_event_properties -获取特定事件的属性
rybbit_get_outbound_links -获取出站链接点击

用户

rybbit_get_users -获取分页用户列表
rybbit_get_user_sessions -获取特定用户的会话
rybbit_get_user_session_count -获取用户的每日会话计数
rybbit_get_user_info -获取详细的用户资料

SQL（原始数据）

rybbit_run_query -对您的事件运行只读ClickHouse SQL（仅限SELECT，最多1000行，10秒上限）
rybbit_get_query_schema -获取事件表列模式以编写查询

用户（管理）

rybbit_identify_user -将匿名访问者链接到用户ID并合并特征
rybbit_update_user_traits -替换用户的个人资料特征（批发替换）
rybbit_delete_user -永久删除用户及其所有数据（GDPR，不可逆）

目标

rybbit_get_goals -通过转化指标实现目标
rybbit_get_goal_sessions -获取完成目标的会话
rybbit_create_goal -创建新目标（基于路径或事件）
rybbit_update_goal -更新目标配置
rybbit_delete_goal -删除目标

漏斗

rybbit_get_funnels -获得保存的漏斗
rybbit_analyze_funnel -分析逐步转换
rybbit_get_funnel_step_sessions -以漏斗步骤获取会话
rybbit_create_funnel -创建新漏斗
rybbit_delete_funnel -删除漏斗

性能（核心网络关键）

rybbit_get_performance_overview -获取LCP、CLS、INP、FCP、TTFB指标
rybbit_get_performance_timeseries -了解随时间变化的性能趋势
rybbit_get_performance_by_dimension -按路径名、国家等获取性能。

错误跟踪

rybbit_get_error_names -获取计数的唯一错误
rybbit_get_error_events -使用堆栈跟踪获取错误事件
rybbit_get_error_timeseries -获取随时间变化的错误趋势

保留和旅程

rybbit_get_retention -获取基于队列的留存分析
rybbit_get_journeys -获取常用用户导航路径

组织和网站

rybbit_get_organizations -获取您的组织
rybbit_get_organization_members -获取组织成员
rybbit_add_organization_member -向组织添加成员
rybbit_create_site -创建新网站
rybbit_get_site -获取网站详细信息
rybbit_update_site -更新站点配置
rybbit_delete_site -删除网站
rybbit_get_excluded_ips -获取排除在跟踪之外的IP
rybbit_get_excluded_countries -将国家代码排除在跟踪之外
rybbit_get_private_link_config -获取私有链接共享配置（仅限组织管理员）

团队

rybbit_get_teams -列出有成员和现场任务的团队
rybbit_create_team -创建一个包含可选成员和站点的团队
rybbit_update_team -更新团队（成员/站点列表被批量替换）
rybbit_delete_team -删除团队
rybbit_update_member_site_access -将成员限制在特定站点

事件追踪

rybbit_track_event -发送跟踪事件（页面浏览量、自定义、性能、错误、出站）

复合和批量

rybbit_get_site_summary -一球摘要：概述+首页/参考者/国家/设备/事件+现场计数（约7个API请求）
rybbit_compare_periods -将概述指标与具有增量的相等长度的前一周期进行比较
rybbit_track_events -在一次通话中发送1-50个跟踪事件，每个事件都有结果

公共参数

时间参数

大多数分析工具都接受时间参数：

startDate / endDate -YYYY-MM-DD格式的日期范围
timeZone -IANA时区（例如，“美洲/纽约”）
pastMinutesStart / pastMinutesEnd -相对时间范围（分钟）

过滤器

使用JSON数组格式过滤数据：

[
  {
    "parameter": "country",
    "type": "equals",
    "value": ["US"]
  }
]

过滤器类型： equals, not_equals, contains, not_contains, regex, not_regex, greater_than, less_than

可用参数： browser, operating_system, device_type, country, region, city, pathname, page_title, hostname, querystring, referrer, utm_source, utm_medium, utm_campaign, user_id, event_name

速率限制

Rybbit API的速率限制为每个API密钥每10分钟500个请求。

许可证

麻省理工学院