Telenow — AI Phone Calls & Voice Agents

Telenow MCP 服务

让 AI 助手拨打真实电话。

文档 · 工具参考 · 协议与 OAuth · 每分钟费用

Telenow 是一个远程 MCP 服务，让 Claude、ChatGPT、Cursor、Grok、Gemini CLI 和任何 MCP 客户端都能使用真实电话。使用你自己的 Telenow 号码拨打电话，获取通话结果、摘要和文字记录，构建语音 Agent，查询每分钟价格，并开展外呼活动。

此仓库仅包含文档和客户端配置。服务由 Telenow 托管，地址为 https://api.telenow.ai/mcp；无需安装或运行任何内容。

服务 URL	https://api.telenow.ai/mcp
传输方式	Streamable HTTP（无状态，JSON 响应）
身份验证	OAuth 2.1 登录（PKCE、动态客户端注册）或组织 API 密钥 Authorization: Bearer vai_live_…
协议版本	2026-07-28、2025-11-25、2025-06-18、2025-03-26
定价	从 Telenow 钱包按使用量付费，典型配置约为 $0.05/分钟

你可以这样提问

• “拨打 +1 415 555 0100，以我的名义预订周五晚上 8 点、4 人的餐桌。告诉我对方说了什么。”
• “昨天我的销售热线接到了哪些电话？总结需要跟进的事项。”
• “构建一个用西班牙语确认牙科预约的语音 Agent，并告诉我它每分钟的费用。”
• “拟定一项活动，在当地时间上午 10 点至下午 6 点拨打这 200 条潜在客户线索，无人接听时重试两次。先不要启动。”
• “昨天的续约活动进展如何？谁要求回电？”

安装

你需要拥有一个至少配置了一个电话号码的 Telenow 账户。连接时，Telenow 会要求你登录并选择助手可以使用的组织、号码和权限。

Claude（claude.ai、桌面端、移动端）

设置 → 连接器 → 添加自定义连接器 → URL https://api.telenow.ai/mcp → 连接并登录。

Claude Code

# OAuth sign-in
claude mcp add --transport http telenow https://api.telenow.ai/mcp

# or with an API key
claude mcp add --transport http telenow https://api.telenow.ai/mcp \
  --header "Authorization: Bearer vai_live_…"

ChatGPT

设置 → 应用和连接器 → 高级 → 启用开发者模式 → 创建连接器 → URL https://api.telenow.ai/mcp，身份验证选择 OAuth。对于 Business/Enterprise 工作区，管理员必须先允许使用自定义连接器。

Cursor

或者添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "telenow": { "url": "https://api.telenow.ai/mcp" }
  }
}

VS Code（GitHub Copilot）

// .vscode/mcp.json
{
  "servers": {
    "telenow": { "type": "http", "url": "https://api.telenow.ai/mcp" }
  }
}

Windsurf / Cline / 其他支持 OAuth 的客户端

添加一个远程（Streamable HTTP）服务，URL 为 https://api.telenow.ai/mcp。客户端会打开 Telenow 登录页面。

不支持 OAuth 的客户端

在请求头中传入组织 API 密钥：

{
  "mcpServers": {
    "telenow": {
      "url": "https://api.telenow.ai/mcp",
      "headers": { "Authorization": "Bearer vai_live_…" }
    }
  }
}

只读密钥仅提供只读工具；可写密钥拥有其所属组织中的完整权限。

Gemini CLI

gemini extensions install https://github.com/TelenowAI/Telenow-AI-MCP

Grok

grok.com/connectors → 新建连接器 → 自定义 → URL https://api.telenow.ai/mcp。

工具（17）

区域	工具	功能	类型
通话	list_numbers	列出助手可拨打电话的号码；第一个是默认来电显示号码	只读
	place_call	拨打一通真实电话，并立即返回 call_id	联系他人
	get_call	获取一通电话的状态、结果、摘要和转录	只读
	list_calls	列出最近的呼入和呼出电话，按时间从新到旧排序	只读
Agent	list_agents	列出组织的语音 Agent	只读
	get_agent	获取一个 Agent 的配置，密钥已隐藏	只读
	create_agent	根据名称和系统提示词创建单上下文 Agent	创建
	create_flow_agent	创建以图结构定义的多步骤 Agent	创建
	update_agent	更改此助手创建的 Agent	更改
	list_voices	列出带有音频样本的语音	只读
	estimate_cost	估算某个 Agent 或计划配置的每分钟费用（美元）	只读
活动	list_campaigns	列出使用此助手号码的活动	只读
	get_campaign	获取一个活动及每个人的结果	只读
	create_campaign	创建草稿活动；不会拨打任何电话	创建
	add_campaign_targets	添加最多 1,000 人	联系他人
	start_campaign	启动或恢复活动	联系他人
	pause_campaign	暂停活动；正在进行的通话会结束	更改

完整参数：https://telenow.ai/docs/mcp-tools

安全与权限

• 在联系真实人员之前，助手必须先征求同意。
• 助手只能使用你连接时选择的号码拨打电话。
• 助手无法查看或设置你的 API 密钥。
• 助手只能更改其创建的 Agent 和活动。
• 除非你勾选 允许 Agent 使用工具（agents:tools scope），否则 Agent 工具、webhook 和转接功能均保持关闭。
• OAuth 权限范围：calls:read、calls:write、agents:write、agents:tools、campaigns:write、offline_access。
• 速率限制：每个连接或 API 密钥每 15 分钟 3,000 个请求。

定价

通话按分钟从组织的钱包中扣费，并受你的支出限额约束。典型配置（Cartesia 语音、GPT-4o-mini、Deepgram Nova-3、Plivo）的费用约为 每分钟 $0.049；给 100 人各拨打一通 2 分钟的电话，费用约为 $10。使用 estimate_cost 工具获取准确报价。使用你自己的供应商密钥或运营商运行的部分不会由 Telenow 计费。请参阅 https://telenow.ai/docs/mcp-costs。

支持

• 文档：https://telenow.ai/docs
• 电子邮件：[email protected] · 联系方式：https://telenow.ai/contact
• 隐私：https://telenow.ai/privacy · 条款：https://telenow.ai/terms · 电话：+1 (605) 597-8532

许可证

此仓库中的文件采用 MIT 许可证。Telenow 服务为专有服务，受 Telenow 服务条款约束。