这篇文档帮你把 Lovrabet 运行态 MCP 接到 Cursor、Claude Code 等 AI 工具里，配好密钥后，用自然语言就能查应用数据、执行已有业务能力。

TIP

运行态 MCP 面向业务数据与运行中的应用能力。若目标是建项目、分析数据库、生成页面与菜单，请走 Rabetbase 研发套件，而不是本 MCP。

准备工作

开始前请确认：

• 已有可访问的 Lovrabet 应用权限
• 已在 Lovrabet个人中心 拿到个人 AccessKey（下文用 <ACCESS_KEY> 代替，不要把真实密钥写进文档或发给他人）
• 使用的 AI 工具支持远程 MCP（推荐 Streamable HTTP）

选择服务地址

环境	MCP 地址
正式环境	https://runtime.lovrabet.com/api/mcp

默认使用正式环境地址。只有团队明确约定走日常环境时，才改用日常地址。

在 Cursor 中配置

打开 Cursor 的 MCP 配置文件：

• macOS / Linux：~/.cursor/mcp.json
• Windows：%APPDATA%/Cursor/mcp.json

加入如下配置，把 <ACCESS_KEY> 换成自己的密钥：

{
  "mcpServers": {
    "lovrabet-runtime": {
      "url": "https://runtime.lovrabet.com/api/mcp",
      "headers": {
        "X-Lovrabet-AccessKey": "<ACCESS_KEY>"
      }
    }
  }
}

如果 AccessKey 能访问多个应用，建议同时固定目标应用，避免每次对话范围过大导致AI的理解歧义

{
  "mcpServers": {
    "lovrabet-runtime": {
      "url": "https://runtime.lovrabet.com/api/mcp",
      "headers": {
        "X-Lovrabet-AccessKey": "<ACCESS_KEY>",
        "X-Lovrabet-App-Code": "<APP_CODE>"
      }
    }
  }
}

保存后重启 Cursor，或在 MCP 面板中重新启用 lovrabet-runtime。

其他 IDE / Agent 的配置入口不同，但核心相同：填写 MCP URL，并在请求头里带上 X-Lovrabet-AccessKey。分客户端的可照抄配置见 各 Agent 客户端配置运行态 MCP。

验证是否接通

在对话里依次发送下面几句。能返回真实账号与应用信息，而不是泛泛说明，即表示接通成功。

确认身份

帮我确认当前 Lovrabet 运行态 MCP 是否已认证，并告诉我当前登录用户是谁。

列出可访问应用

列出我当前 AccessKey 能访问的应用。

锁定当前应用（Header 里已固定应用时可跳过）

把当前会话切换到「<应用名称>」，之后的查询都在这个应用里执行。

试一次只读查询

在当前应用里找一下和「客户」相关的数据集，并列出前几条记录的摘要。

配置检查清单

• [ ] MCP 地址与当前环境一致

• [ ] Header 使用 X-Lovrabet-AccessKey，且密钥无误

• [ ] 多应用场景已固定 X-Lovrabet-App-Code，或已在对话里选定应用

• [ ] 修改配置后已重启 / 重新启用 MCP

• [ ] 验证对话已返回真实用户、应用或数据集，而不是空话

常见问题

提示未认证或认证失败

优先检查 Header 名称是否为 X-Lovrabet-AccessKey（注意大小写与连字符），以及密钥是否过期、被重置。不要在 URL 查询参数里携带密钥。

能连上，但查数据时报缺少应用

当前密钥可访问多个应用时，MCP 不会默认使用第一个应用。请在配置里增加 X-Lovrabet-App-Code，或先让助手列出应用再切换。

和旧的「开发态 Dataset MCP」有什么区别

旧的 Dataset MCP 侧重研发侧元数据与本地启动。运行态 MCP 是托管服务，用 AccessKey 直接访问运行中的业务数据与能力。新接入请优先使用本文的运行态 MCP。

接通后的常用操作、写入确认与注意事项，见 用运行态 MCP 查询与处理业务数据。