如何通过 MCP 将 Ringostat 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Ringostat、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Ringostat + Cursor

Ringostat 来电追踪与虚拟 PBX：包含流量来源、通话时长、状态、员工和录音链接的通话记录，谁在线或正在通话，带部门和呼叫路由的员工列表，每日 SIP 在线报告以及 Smart Phone 状态。发起回拨在安装时处于关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

步骤 1 — 获取凭证

设置大约需要 2 分钟，需要 Ringostat 的项目管理员。

1. 在 Ringostat 中打开 Settings、Integrations、Ringostat API，把 Auth-key 复制到 RINGOSTAT_AUTH_KEY。它属于一个项目，通过 Auth-key 请求头发送。
2. 把 RINGOSTAT_PROJECT_ID 设为该项目的编号：即 Ringostat 网页应用地址栏中 project_id= 或 projectId= 后面的值，例如 39071。只有员工、SIP 报告和自定义状态工具会用到它。
3. 安装连接器；检查会运行 ringostat_list_online_sip。

读取的数据：某时段的通话记录，每通电话一行，返回你要求的列：日期、主叫和被叫号码、通话类型、状态（disposition）、通话时长、总时长和等待时间、员工姓名和部门、号码池和转接方案、目标来电和重复来电标记、UTM source、medium、campaign、content 和 term、落地页和来源页、未接原因、CSAT 评分、通话 ID 和录音链接；当前在线的 SIP 账户和当前正在通话的 SIP 账户；员工列表，包括 SIP 状态、全名、邮箱、分机号、staffId、部门和呼叫路由（主用和备用 SIP 账户或电话号码）；每位员工每天的在线和离线时长；以及 Smart Phone 的自定义状态，例如午餐或会议。

通话记录：ringostat_list_calls 接受格式为 YYYY-MM-DD HH:MM:SS 的 from 和 to；不传时返回最近 24 小时。响应是包含该时段所有通话的单个数组，不分页，因此在通话量大的项目中，AI 会把时段控制得较短（一天或一周），并只请求需要的 fields。通话时长为 billsec，单位为秒；call_type 为 in、out、callback、transitin 或 transitout；proper_flag 和 repeated_flag 标记目标来电和重复来电。按员工统计时，AI 会按 employee_fio 分组并对 billsec 求和。

筛选和排序：筛选条件是用逗号连接的 Ringostat 表达式，例如 call_type=in,billsec>=30，运算符为 =、<>、>、<、>=、<= 或 ~（base64 编码的正则表达式）。order 用于排序，例如 calldate desc；merge 按主叫号码按天（1）或在整个时段内（2）合并通话。

个人数据：电话号码和录音链接属于个人数据。recording 和 recording_wav 中的录音链接可保留一年。

安装时关闭：ringostat_start_callback 会发起一通真实电话，把项目号码与某个电话号码或员工的 SIP 登录名接通。它会立即拨号并消耗通话分钟数，因此需要管理员有意开启。即使开启后，AI 也会先向你展示两个号码并等待你确认。号码使用不带 + 的国际格式。

只读的 POST 调用：员工列表、SIP 报告和自定义状态在 Ringostat API 中是 POST 请求，但只做读取。

常见错误：401 或 403 表示 Auth-key 缺失或错误，或者密钥和项目 ID 属于不同的项目。员工、报告或状态工具返回 JSON-RPC 错误时，通常是 RINGOSTAT_PROJECT_ID 错误；"User does not exist" 表示员工筛选条件没有匹配到任何人。

该连接器不会修改 PBX 设置、员工、号码池或转接方案，返回的是录音链接，而不是音频本身。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Ringostat 的工具。

可用工具

示例提示

• “昨天我们有多少通来电，其中多少未接，平均通话时长是多少？”
• “按员工汇总上周的通话，列出通话数量和总通话时长。”
• “本月哪些 UTM 来源和广告活动带来了目标来电？”
• “现在谁在线，其中谁正在通话？”
• “上周每位员工每天在线了多长时间？”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot