跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Telnyx,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
摘要
让你的 AI 使用 Telnyx:查看余额和用量,列出和搜索电话号码,发送短信和彩信,拨打播报消息的电话,读取通话录音和详单记录,查询号码,通过 Verify 发送和校验一次性验证码,并查看你的 AI 助手。
试试这样问
Telnyx 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Telnyx、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Telnyx + Claude
让你的 AI 使用 Telnyx:查看余额和用量,列出和搜索电话号码,发送短信和彩信,拨打播报消息的电话,读取通话录音和详单记录,查询号码,通过 Verify 发送和校验一次性验证码,并查看你的 AI 助手。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TELNYX_API_KEY
步骤 1 — 获取凭证
- 登录 Mission Control Portal:
https://portal.telnyx.com。 - 打开 Account settings → Keys & Credentials → API Keys,点击 Create API Key。密钥以
KEY开头,Telnyx 只显示一次。 - 按 Telnyx 显示的原样把它粘贴到
TELNYX_API_KEY,不要加 Bearer 一词,然后安装连接器。密钥只会发送到 api.telnyx.com。 - 用
telnyx_get_balance检查设置:它是免费的,会显示余额、信用额度和币种。
谁能看到什么:密钥代表整个 Telnyx 账户,包括余额。请只把 MCP 服务器分享给可以用这个账户花钱的人。
会产生费用并触达真实的人,所以 AI 会先问你:Telnyx 对 telnyx_send_message(短信和彩信)、telnyx_dial_call(按分钟)、telnyx_speak_text(文字转语音)和 telnyx_send_verification(按次验证)收费。每次调用前,AI 都会给你看收件人、发送方和内容,并等你同意。telnyx_lookup_number 按次查询收费,因此 AI 在查询大量号码前会先告诉你。发送、拨打和购买需要账户有余额。
安装时默认关闭:telnyx_order_phone_numbers 会购买号码,每个号码有一次性费用和月费。管理员需要有意识地开启它;开启后,AI 会列出每个号码及其费用,在你确认后才购买。用 telnyx_search_available_numbers 搜索号码是免费的。
短信:号码只有分配到某个消息配置文件(messaging profile)后才能发短信(telnyx_list_messaging_profiles 会显示这些配置文件以及每个配置文件允许发送的国家)。新消息的初始状态是 queued;之后可用 telnyx_get_message 查看每个收件人的送达状态。附上媒体链接后,消息会作为彩信发送(美国和加拿大)。
拨打电话需要 Call Control 应用:在 Mission Control Portal 中创建一个,并把你用来拨出的号码分配给它。telnyx_list_call_control_applications 会给出 telnyx_dial_call 所需的 connection_id。AI 拨号后,会用 telnyx_get_call_status 检查对方是否接听,然后用 telnyx_speak_text 播报你的消息,再用 telnyx_hangup_call 挂断。拨号时设置时长上限可以控制费用。通话事件会发送到该应用的 Webhook URL,本连接器不接收这些事件。录音:telnyx_list_recordings 和 telnyx_get_recording(下载链接几分钟后失效)。
Verify:在门户的 Verify 中创建一次 Verify 配置文件;telnyx_list_verify_profiles 会列出它。telnyx_send_verification 通过短信、语音电话或 WhatsApp 发送验证码,telnyx_check_verification_code 校验对方输入的验证码。
用量和费用:telnyx_search_detail_records 列出单条消息和通话及其费用;telnyx_get_usage_report_options 和 telnyx_get_usage_report 提供最长 31 天内按产品汇总的用量。AI 助手只读:telnyx_list_ai_assistants 和 telnyx_get_ai_assistant。
号码格式:始终使用 E.164,即 +、国家代码和不含空格的号码(+8613812345678)。
常见错误:401 (10009):密钥错误、已删除或粘贴时带了前缀;请在门户中新建一个。403:账户暂时不能使用此功能(例如向某个国家发送,或在账户验证前购买号码),或者密钥缺少权限。404 (10005):此账户下没有该资源。422:参数无效,例如发送方没有消息配置文件、通话尚未接听,或号码不是 E.164 格式。429:请求过多;请稍候重试。
该连接器不涉及号码携转、号码配置和释放、SIP 中继、TeXML、电话会议、传真、WhatsApp 模板、10DLC 品牌和活动注册、创建或修改 AI 助手以及 Webhook。
步骤 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 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
Telnyx)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
示例提示
- “我们的 Telnyx 余额是多少?本月在消息上花了多少钱,按国家列出。”
- “从我们的柏林号码给 +4915112345678 发一条短信,告诉对方订单可以取货了。发送前先给我看发送方、收件人和内容。”
- “用我们的客服号码拨打 +4915112345678,告诉对方技术人员下午 3 点到,然后挂断。通话控制在一分钟以内。”
- “找三个能发短信的德国手机号码,列出每个号码的一次性费用和月费。”
- “昨天哪些消息没有送达?查一下详单记录,列出状态和费用。”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?