跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Ringostat,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
Ringostat 来电追踪与虚拟 PBX:包含流量来源、通话时长、状态、员工和录音链接的通话记录,谁在线或正在通话,带部门和呼叫路由的员工列表,每日 SIP 在线报告以及 Smart Phone 状态。发起回拨在安装时处于关闭状态。
试试这样问
Ringostat 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Ringostat、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Ringostat + Microsoft Copilot
Ringostat 来电追踪与虚拟 PBX:包含流量来源、通话时长、状态、员工和录音链接的通话记录,谁在线或正在通话,带部门和呼叫路由的员工列表,每日 SIP 在线报告以及 Smart Phone 状态。发起回拨在安装时处于关闭状态。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID
步骤 1 — 获取凭证
设置大约需要 2 分钟,需要 Ringostat 的项目管理员。
- 在 Ringostat 中打开 Settings、Integrations、Ringostat API,把 Auth-key 复制到
RINGOSTAT_AUTH_KEY。它属于一个项目,通过Auth-key请求头发送。 - 把
RINGOSTAT_PROJECT_ID设为该项目的编号:即 Ringostat 网页应用地址栏中project_id=或projectId=后面的值,例如39071。只有员工、SIP 报告和自定义状态工具会用到它。 - 安装连接器;检查会运行
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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
Ringostat的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
ringostat_list_calls | Export the call log of the project for a period: one row per call with the fields you ask for, e.g. date, caller and called number, call… |
ringostat_list_online_sip | List the SIP accounts of the project that are online right now (logins as strings) |
ringostat_list_speaking_sip | List the SIP accounts of the project that are in a call right now (logins as strings) |
ringostat_list_employees | List the employees of the project with their SIP status (status true means online), full name (fio), e-mail, extension number, staffId… |
ringostat_get_sip_status_report | Get how long each employee's SIP account was online and offline per day in a date range (times as HH:MM:SS) |
ringostat_list_custom_statuses | List the custom employee statuses set up for Ringostat Smart Phone (id and title), e.g |
ringostat_start_callback | Start a real phone call that connects two numbers: Ringostat calls from a project number to the destination (a phone number or an… |
示例提示
- “昨天我们有多少通来电,其中多少未接,平均通话时长是多少?”
- “按员工汇总上周的通话,列出通话数量和总通话时长。”
- “本月哪些 UTM 来源和广告活动带来了目标来电?”
- “现在谁在线,其中谁正在通话?”
- “上周每位员工每天在线了多长时间?”
FAQ
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?