关于 Kanadr hosted PBX
Kanadr 提供 OpenAPI 规范和连接示例，用于管理电信运营商使用的白标托管 PBX。门户 API 涵盖客户、电话服务、呼叫流程、日志和诊断操作。
主要功能
- 01提供英文和法文 OpenAPI 规范
- 02管理客户、号码和中继
- 03配置呼叫流程和设备
- 04查看通话日志、计费和诊断信息
- 05提供现成的 MCP 客户端配置
适用场景
- 01排查中继故障和注册问题
- 02列出经销商客户及其分机
- 03将 AI 助手连接到 Kanadr 门户
MCP 相关
每个 Kanadr 门户都通过 streamable HTTP MCP 服务将 API 操作作为工具公开。仓库包含客户端配置；变更需用户确认，并记入审计日志。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://{portal}/api/v1/mcpclaude mcp add --transport http com-kanadr-pbx https://{portal}/api/v1/mcp{"mcpServers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}在 Cursor 中打开{"servers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-kanadr-pbx":{"type":"http","url":"https://{portal}/api/v1/mcp"}}}{"mcpServers":{"com-kanadr-pbx":{"serverUrl":"https://{portal}/api/v1/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Kanadr API 和 MCP 示例
此代码库包含 Kanadr API 的 OpenAPI 规范，以及可直接使用的配置，用于通过 MCP 服务将 AI 助手连接到 Kanadr 门户。
Kanadr 是面向电信运营商的白标托管 PBX。门户中的所有操作都通过此 API 完成：客户、号码、中继、呼叫流程、设备、通话记录、计费、Webhook 和诊断。该规范列出了 200 多个路径，并提供英文和法文文档。
目录
| 路径 | 内容 |
|---|---|
openapi/openapi.en.json | OpenAPI 规范，英文描述 |
openapi/openapi.json | 同一规范，法文描述 |
mcp/ | MCP 客户端配置：Claude Code、Codex、Mistral Vibe、OpenAI Responses API、通用 JSON |
examples/ | 使用 curl 发送的纯 HTTP 请求 |
可浏览的参考文档位于 docs.kanadr.com/api/en。此外，还提供了所有操作的纯列表。
身份验证
- API 密钥：在门户的 API 下创建密钥，然后选择 API keys。将密钥作为
Authorization: Bearer cx_…发送。密钥的权限与分配给它的角色完全相同，因此建议先使用只读角色。 - OAuth：claude.ai、ChatGPT 和 Le Chat 等网页版助手改用 OAuth。添加服务地址时无需密钥，登录门户并批准访问即可。
每个 Kanadr 门户都有自己的地址。在示例中，将 portal.example 替换为你的门户地址。
MCP 服务
每个门户都会在 https://portal.example/api/v1/mcp 提供一个 MCP 服务（可流式传输的 HTTP）。每个 API 操作都是一个同名工具，例如 listerClients 或 reglerRenvois。发送 Accept-Language: en 可获取英文工具描述。monCompte 工具会返回已连接的账户及其组织。进行任何更改前，助手都会要求用户确认。每次写入都会以用户或密钥的名称记录在审计日志中。
使用 Claude Code 快速开始：
claude mcp add --transport http phone https://portal.example/api/v1/mcp
然后在 Claude Code 中运行 /mcp 并选择 Authenticate。其他客户端配置位于 mcp/。完整指南请参阅 MCP 文档。
请求示例：
- “哪些中继出现故障？从什么时候开始的？”
- “列出经销商 Example 的客户及其分机数量。”
- “客户 Example 的分机 100 为什么无法注册？”
许可证
mcp/ 和 examples/ 中的配置文件和示例采用 MIT 许可证。OpenAPI 规范描述的是 Kanadr 这一商业产品。发布该规范是为了方便你基于它构建集成。
联系方式
Kanadr 是法国 Archel SAS 的品牌。若要申请演示实例，请访问 kanadr.com/en/contact。你也可以发送邮件至 [email protected]。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。