Lovrabet 帮助中心

简体中文

English

简体中文

English

主题

这篇文档是 接入 Lovrabet 运行态 MCP 的补充。统一约定不变：服务地址用 https://runtime.lovrabet.com/api/mcp，请求头必须带 X-Lovrabet-AccessKey: <ACCESS_KEY>。下面按常见 Agent / IDE 给出可照抄的配置方式。

TIP

AccessKey 在 Lovrabet 个人中心 获取。不要把真实密钥写进可分享的配置或发给他人。多应用场景可额外加 X-Lovrabet-App-Code: <APP_CODE>。

配置前先看清三件事 ​

  1. 传输方式：运行态 MCP 是托管的 Streamable HTTP，不是本地 npx 进程。
  2. 鉴权方式：用自定义 Header X-Lovrabet-AccessKey，不是 Cookie，也不是把密钥塞进 URL。
  3. 配完要验证：在对话里问「当前 Lovrabet 运行态 MCP 是否已认证」，能返回真实用户信息才算成功。

Cursor ​

配置文件：

  • 全局：~/.cursor/mcp.json
  • 仅当前项目：项目根目录 .cursor/mcp.json
json
{
  "mcpServers": {
    "lovrabet-runtime": {
      "url": "https://runtime.lovrabet.com/api/mcp",
      "headers": {
        "X-Lovrabet-AccessKey": "<ACCESS_KEY>"
      }
    }
  }
}

也可在 Cursor Settings → Tools & MCP → New MCP Server 中粘贴同样内容。密钥可用 ${env:LOVRABET_ACCESS_KEY} 引用环境变量，避免明文落盘。

参考：[Cursor MCP 文档]

Claude Code ​

推荐用命令直接加 HTTP 服务（会写入 Claude Code 的 MCP 配置）：

bash
claude mcp add --transport http lovrabet-runtime https://runtime.lovrabet.com/api/mcp \
  --header "X-Lovrabet-AccessKey: <ACCESS_KEY>"

需要固定应用时再加一行 Header：

bash
claude mcp add --transport http lovrabet-runtime https://runtime.lovrabet.com/api/mcp \
  --header "X-Lovrabet-AccessKey: <ACCESS_KEY>" \
  --header "X-Lovrabet-App-Code: <APP_CODE>"

也可手写 JSON。注意：Claude Code 必须写 "type": "http"（或 streamable-http），只写 url 会被当成本地 stdio 而跳过。

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

配置位置常见为项目 .mcp.json 或用户级 Claude 配置；以当前版本 claude mcp list / 文档为准。配完后可用 /mcp 查看连接状态。

参考：[Claude Code MCP]

Codex ​

Codex（CLI / IDE 扩展 / ChatGPT 桌面端同源）用 TOML，不是 JSON。编辑 ~/.codex/config.toml（或可信项目下的 .codex/config.toml）：

toml
[mcp_servers.lovrabet-runtime]
url = "https://runtime.lovrabet.com/api/mcp"

[mcp_servers.lovrabet-runtime.http_headers]
"X-Lovrabet-AccessKey" = "<ACCESS_KEY>"

更稳妥的做法是把密钥放在环境变量，再用 env_http_headers：

toml
[mcp_servers.lovrabet-runtime]
url = "https://runtime.lovrabet.com/api/mcp"

[mcp_servers.lovrabet-runtime.env_http_headers]
"X-Lovrabet-AccessKey" = "LOVRABET_ACCESS_KEY"

然后在 shell 中导出：

bash
export LOVRABET_ACCESS_KEY="<ACCESS_KEY>"

也可用 CLI 添加远程服务后再补 Header；自定义 Header 以 http_headers / env_http_headers 为准。会话里用 /mcp 检查是否在线。

参考：[Codex MCP]

Trae ​

打开 Trae → Settings → MCP（或 Agents / AI 管理里的 MCP），选择手动配置。当前 Agent 实际读取的是全局配置，优先用界面写入，或编辑：

  • macOS：~/Library/Application Support/Trae/User/mcp.json
  • Windows：%APPDATA%\Trae\User\mcp.json
  • Linux：~/.config/Trae/User/mcp.json
json
{
  "mcpServers": {
    "lovrabet-runtime": {
      "url": "https://runtime.lovrabet.com/api/mcp",
      "headers": {
        "X-Lovrabet-AccessKey": "<ACCESS_KEY>"
      }
    }
  }
}

若界面支持选择 SSE / HTTP，选择远程 URL 类型并填入上述地址与 Header。保存后完全重启 Trae。项目级 .trae/mcp.json 在部分版本对 Agent 不可用，对接运行态 MCP 时请以全局配置为准。

Qoder ​

打开 Qoder Settings（macOS：⌘⇧,；Windows：Ctrl+Shift+,）→ MCP → My Servers → + Add。

方式一：粘贴 JSON（若界面提供 Paste JSON / 编辑配置）：

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

说明：Qoder 对远程服务常用 SSE 表单项；官方说明 Streamable HTTP 可按 SSE 同样填 URL，由客户端自动识别。若界面有独立的 Streamable HTTP / Headers 字段，优先在界面填写同一 URL 与 X-Lovrabet-AccessKey。

保存后确认列表出现链接图标，再在 Agent 模式对话验证。若工具调用前有确认提示，按提示允许即可。

参考：[Qoder MCP]

若使用 Qoder CLI，也可用类似：

bash
qodercli mcp add -t http -s user lovrabet-runtime --url https://runtime.lovrabet.com/api/mcp

Header 是否支持以当前 CLI 版本帮助为准；不支持时改回 IDE 界面配置。

Craft Agents ​

Craft Agents 把 MCP 当成 Source。可先对 Agent 说「添加 Lovrabet 运行态 MCP」，也可手动准备 source 配置。

运行态 MCP 使用自定义 Header，而不是 OAuth。可参考：

json
{
  "type": "mcp",
  "name": "Lovrabet Runtime",
  "tagline": "Lovrabet 运行态业务数据与能力",
  "mcp": {
    "transport": "http",
    "url": "https://runtime.lovrabet.com/api/mcp",
    "headers": {
      "X-Lovrabet-AccessKey": "<ACCESS_KEY>"
    },
    "authType": "none"
  }
}

若产品界面只提供 Bearer / OAuth，而无法填写自定义 Header：Bearer 会落到 Authorization，与 Lovrabet 要求不一致，当前版本请优先选支持自定义 Header 的接入方式，或向 Craft 侧确认如何映射 X-Lovrabet-AccessKey。

连接后可用 /tools -v 查看工具；变更后可用 /source reload <source-name> 刷新。

参考：[Craft Agents 连接 MCP]

Windsurf（Cascade） ​

配置文件通常为 ~/.codeium/windsurf/mcp_config.json。远程服务字段常用 serverUrl（也有版本接受 url）：

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

从 Cursor 拷配置时，把 url 改成 serverUrl，否则可能静默不生效。Teams / Enterprise 环境若禁用远程 MCP，需管理员先打开权限。改完后重启 Cascade。

参考：[Windsurf Cascade MCP]

对照表 ​

客户端配置位置 / 入口远程字段要点
Cursor~/.cursor/mcp.json 或 .cursor/mcp.jsonurl + headers
Claude Codeclaude mcp add --transport http 或 JSON必须有 type: http + headers
Codex~/.codex/config.tomlurl + http_headers / env_http_headers
TraeSettings → MCP；全局 mcp.jsonurl + headers；优先全局
QoderSettings → MCP → Add远程 URL；Header 在界面或 JSON
Craft AgentsSource / 对话添加transport: http + 自定义 headers
Windsurf~/.codeium/windsurf/mcp_config.json优先 serverUrl + headers

配完后的统一验证 ​

plaintext
帮我确认当前 Lovrabet 运行态 MCP 是否已认证，并告诉我当前登录用户是谁。列出我能访问的应用。

能返回真实用户与应用列表，即表示该客户端已接通。接下来可继续按 用运行态 MCP 查询与处理业务数据 做查询与操作。

常见问题 ​

客户端连上了，但一直未认证 ​

检查 Header 名是否为 X-Lovrabet-AccessKey（不要写成 Authorization Bearer，也不要写成旧的 Access-Key）。Claude Code 还要确认已声明 type: http。

从 Cursor 复制到其他客户端不工作 ​

字段名不通用：Windsurf 常用 serverUrl，Claude Code 要 type，Codex 要 TOML 的 http_headers。按本文对应章节改，不要整段硬贴。

本机代理 / 公司网络拦截 HTTPS ​

先在终端访问 https://runtime.lovrabet.com/api/mcp/health。若浏览器或 curl 都不可达，先解决网络，再排查客户端配置。

基于飞书知识库同步生成，内容以飞书源文档为准

Lovrabet · 启智云图