Core/Dash MCP Server

将你的 AI agent 连接至真实 Core Web Vitals 数据。聊天中调试，代码中验证。无需仪表盘。

免费试用

Trusted by market leaders · Client results

为你的 AI agent 输送实时数据

问题在于：开发者打开 Claude 或 Cursor，描述一个 Core Web Vitals 问题并寻求帮助。AI 基于常识给出看似合理的回答。它在推测。它提供的是通用建议。它建议你“检查你的 LCP 元素”，但它根本不知道你的 LCP 元素到底是什么。

CoreDash MCP 服务器让任何兼容 MCP 的 AI agent 都能直接访问你的实时 RUM 数据。包含全部 5 个 Core Web Vitals 指标的完整拆分阶段，以及 25 个过滤维度（与支持仪表盘的是同一套数据）。

AI 不再靠猜测，它可以明确告诉你，移动端上的 LCP 是 3,102 毫秒，因为 div.hero-image > img 是一个 2.4 MB 且未优化的 JPEG 图片，并且没有设置 fetchpriority="high"。它能告诉你，上周四的部署导致了 18% 的 INP 退化，且问题仅局限于 button.add-to-cart。它还能向你展示，你在德国的 TTFB 是 1,400 毫秒，因为你没有命中法兰克福的 CDN 边缘节点。

工作原理

MCP（即 Model Context Protocol）是自描述的。当你的 AI 连接时，服务器会告诉它存在哪些指标、如何过滤以及每个参数的作用。你只需建立连接，agent 就会搞定剩下的事情。

底层原理：无状态 HTTPS POST、JSON-RPC 2.0、Bearer token 认证。每个请求相互独立。无会话，无 WebSockets。欲获取包含请求/响应示例的完整 API 参考，请参阅 CoreDash API 文档。

开始使用

已包含在你的套餐中。每个 CoreDash 账户都提供 MCP 访问权限。无需额外购买，无追加销售。如果你有项目，现在就可以生成 API 密钥。

第一步：生成 API 密钥

登录 CoreDash，打开你的项目，依次前往 AI Insights 和 Connect Your AI。为密钥命名（例如“Claude Desktop”、“Cursor”、“CI Pipeline”）并点击 Generate。请立即复制该密钥。它仅会显示一次。我们使用 SHA-256 算法对其进行哈希，并且只存储哈希值。

每个密钥都限定在单个项目范围内。你可以根据需要创建多个密钥，并能随时立即撤销。只有项目所有者可以管理密钥。

第二步：配置你的 MCP 客户端

Claude Desktop Claude Code Cursor JSON 配置

点击聊天栏中的 +，然后选择 Connectors → Manage Connectors → Add custom connector。粘贴该 URL。Claude 将通过 OAuth 进行身份验证：系统会把你重定向到 CoreDash，让你选择项目并确认授权。不需要 API 密钥。

请参阅 完整的 Claude 连接器指南 获取带有逐步截图的指引。

浏览器登录（推荐交互式使用）。 添加服务器，无需 header 和密钥：

claude mcp add --transport http coredash https://app.coredash.app/api/mcp

首次连接时，在交互式会话中运行 /mcp，选择 coredash，然后选择 Authenticate。你的浏览器将打开 CoreDash 登录与授权页面。登录、选择项目并确认。Claude Code 会存储一个可自动刷新的短期 OAuth token（1 小时有效期，30 天刷新期），你可以随时撤销。无需手动粘贴密钥。（claude mcp list 仅对服务器进行健康检查，在完成身份验证之前会报告工具获取失败，因此请先在真实的会话中完成身份验证。）

API 密钥。 对于无浏览器环境、自动化任务或 CI 运行，改为传入密钥：

claude mcp add --transport http coredash https://app.coredash.app/api/mcp --header "Authorization: Bearer cdk_YOUR_API_KEY"

依次前往 Settings → Tools & MCP → New MCP Server。将 URL 设置为 https://app.coredash.app/api/mcp 并添加 header：Authorization: Bearer cdk_YOUR_API_KEY。

适用于任何读取 JSON 配置文件的 MCP 客户端（Claude Desktop、Cursor、Windsurf、VS Code）：

{
  "mcpServers": {
    "coredash": {
      "url": "https://app.coredash.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cdk_YOUR_API_KEY"
      }
    }
  }
}

第三步：验证

向你的 AI 提问一个简单的问题，以确认连接是否正常：

“移动端上 /product 当前的 Core Web Vitals 是多少？”

如果它调用 get_metrics 并返回了真实的数据，就说明你已成功连接。

三个工具

该 MCP 服务器提供三个工具。

get_metrics 是快照工具。“移动端当前的 LCP 是多少？”适用于任何关于当前状态的提问。你可以按设备、国家、页面、浏览器进行过滤，也可以按任意维度进行分组来对比不同的细分群体。

get_timeseries 是趋势工具。“自周四以来 INP 变差了吗？”它返回随时间变化的数据点，并自动将趋势分类为改善、稳定或退化。AI 会为你解读趋势，省去你肉眼观察图表的麻烦。

get_histogram 是分布工具。“移动端上的 LCP 分布是什么样的？”它返回约 40 个数据桶，展示数据的完整形态。p75 为 2400 毫秒可能意味着大多数用户都在 2400 毫秒左右，也可能意味着 60% 的用户速度很快，而一部分慢速移动端流量拉低了整体表现（拉长了尾部）。直方图能明确告诉你属于哪种情况。

有关完整的参数参考、示例请求和响应格式，请参阅 API 文档。

真实案例：性能感知代码重构

以下是当 Cursor 连接了 MCP，并且你让它查找缓慢的 INP 交互并定位到实际代码问题时的表现：

agent 检查了实际的 INP 归因数据，找出哪些交互表现较差，查询了 LOAF 数据以定位导致该问题的脚本，并在修复前准确识别了问题所在。这就是通用的最佳实践建议，与针对实际缓慢之处进行修复之间的差距。

速率限制

MCP 请求与 CoreDash AI 功能共享每日额度。额度在 UTC 午夜重置。

套餐	每日请求数
试用版	30
基础版	100
标准版	500
专业版	1,000
企业版	50,000

安全性

原始密钥仅显示一次。我们只存储 SHA-256 哈希值。
每个密钥 均限定在单个项目范围内。防止横向移动。
密钥可以在仪表盘中 立即撤销。
每个密钥都会记录 last_used。闲置密钥很容易被发现。
MCP 服务器是 只读的。API 中没有写入路径。
过期的项目将 自动拒绝 所有 API 密钥。