适合谁
- 已使用 Telnyx 平台且需要在 IDE 内直接操作 Telnyx 资源的开发者
- 构建语音代理、短信自动化或电信相关 AI 应用的团队
T
54FMRS · D
Telnyx MCP 是 Telnyx 官方维护的代理/入口，用于将 IDE 中的 AI 编码助手连接到其远程电信 API MCP 服务器，核心价值在于让代理无需预训练知识或脆弱的文档检索即可调用 Telnyx 服务；主要风险集中在 API 密钥安全与账户操作权限上，源材料未提供具体工具清单。
Telnyx MCP 是由 Telnyx 官方维护的 MCP 代理，将编码助手（如 Cursor、Claude Code、Gemini CLI）连接到 Telnyx 的远程 MCP 服务器（https://api.telnyx.com/v2/mcp），从而调用 Telnyx 的电信类 API 工具。该仓库同时提供 npm 包 @telnyx/mcp（通过 stdio 方式在本地运行并代理到远程服务），以及可直接以 HTTP 方式连接的远程托管 MCP 端点。仓库来源材料未列出具体工具名称或数量，只说明其用于'AI 驱动的电信工具'，覆盖短信、语音、号码管理、AI 助手、WebRTC 等 Telnyx 产品线。使用时需要提供 TELNYX_API_KEY 进行身份验证。
工具能力
暂未整理工具清单。
安装接入
方式一（本地 stdio 代理）：在支持 MCP 的客户端配置中添加命令 npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY，或设置环境变量 TELNYX_API_KEY 后运行该 npm 包；方式二（直接连接远程服务）：在客户端的 MCP 配置文件（如 Cursor 的 .cursor/mcp.json）中添加类型为 http 的服务器条目，指向 https://api.telnyx.com/v2/mcp。
claude_desktop_config.json
{
"mcpServers": {
"telnyx": {
"command": "npx",
"args": [
"-y",
"@telnyx/mcp",
"--api-key=YOUR_TELNYX_API_KEY"
]
}
}
}
选型与风险
不适合谁
- 不使用 Telnyx 服务、无 Telnyx API 密钥的用户
- 需要明确、逐一列出的工具清单才能评估集成风险的场景（源材料未提供具体工具名单）
所需权限
- 需要提供 Telnyx API 密钥（TELNYX_API_KEY），该密钥被标记为敏感信息
- 该密钥可授权对 Telnyx 账户执行操作（如短信发送、号码购买等电信资源管理），需妥善保管
风险与副作用
- API 密钥一旦泄露，可能被用于在 Telnyx 账户上产生真实费用或滥用电信资源（如群发短信）
- 远程 MCP 服务器（api.telnyx.com）为托管服务，其可用性和行为变更依赖 Telnyx 官方维护，不受本地控制
- 源材料明确说明该仓库仍在积极开发中，接口和功能可能发生变化
常见排障
- 确认已正确设置 TELNYX_API_KEY 环境变量或在启动命令中传入 --api-key 参数
- 若使用 Cursor 的 http 连接方式，检查 .cursor/mcp.json 中的 url 字段是否为 https://api.telnyx.com/v2/mcp
- 确认 Node.js 环境可用以运行 npx 命令（本地 stdio 代理方式）
- 如遇账户权限或计费相关问题，检查 Telnyx 账户状态及 API 密钥权限范围
使用场景
让编码助手直接调用 Telnyx 的短信、语音、号码等电信 API
在开发中管理 Telnyx 账户资源（如购买号码、配置消息资料）
为语音代理、IoT 或 WebRTC 项目提供 AI 驱动的电信工具接入
支持客户端
Cursor完整支持
Claude Code部分支持
Gemini CLI部分支持