使用 TG Validator MCP 集成与 AI 客户端
将支持 MCP 的 AI 客户端连接至 TG Validator 实时检测，使用 Bearer 认证，共享余额与账户限额。
团队如何将 AI 客户端连接至 TG Validator MCP 端点以进行实时 Telegram 注册检测。
TG Validator MCP 集成允许支持 MCP 的 AI 客户端调用 https://tgvalidator.com/mcp 上的实时检测和余额查询工具。它使用您的现有 API 密钥通过 Authorization Bearer 请求头进行身份验证，并使用与 REST API 和仪表板相同的账户、余额和限额。该集成仅涵盖实时工具，异步批量任务仍需在仪表板或通过 REST API 执行。
Telegram MCP 集成提供的功能
MCP (Model Context Protocol) 是一种用于将 AI 应用程序连接至外部工具和数据源的开放标准（Model Context Protocol 简介）。服务器发布工具，AI 客户端则代表用户决定何时调用这些工具。
TG Validator 的官方 MCP 端点为 https://tgvalidator.com/mcp，相关文档请见 MCP 文档页面。该集成公开了实时检测和余额查询工具。它是现有账户的一个集成界面，而非第七种服务类型，也不是独立产品。返回的信号与实时 tg 服务描述的 Telegram 注册信号一致：即提交的 E.164 号码在检测时是否已注册 Telegram。
身份验证：MCP 使用 Bearer，REST 使用 X-API-Key
这两个入口点使用不同的请求头，混淆它们是最常见的设置错误。
| 入口点 | 请求头 | 凭据 |
|---|---|---|
| REST API | X-API-Key | 以 sk_ 为前缀的 API 密钥 |
| MCP 端点 | Authorization: Bearer | 同一 API 密钥 |
凭据完全相同，仅请求头有所变化。请在仪表板中创建或查看密钥，将其存储在 AI 客户端的密钥或环境变量配置中，切勿将真实密钥粘贴到提示词、共享配置文件或代码仓库中。如果密钥可能已泄露，请在仪表板中轮换密钥并更新所有使用该密钥的客户端。
大多数支持远程服务器的 MCP 客户端允许您添加 URL 和自定义请求头，因此设置通常只是一个简短的配置条目，而非编写代码。请查看您所用客户端的文档以获取确切语法，因为不同客户端对这些选项的命名方式各不相同。
相同账户、相同余额、相同限额
通过 MCP 进行的调用并非并行账户。它们使用拥有该密钥的账户的余额和计费，并遵循与 REST API 相同的并发和超时行为。公共 API 文档描述了针对用户的并发和超时控制，并未发布每分钟请求速率限制，因此请参考当前的 API 文档了解详情，而非自行假设数值。
这会产生三个实际后果：
- 每一项得出结论的已完成检测都会按适用的服务费率扣费，无论号码是否已注册，因此如果代理程序循环检测大量号码，每次都会消耗余额。
- AI 客户端进行的检测与您自己代码进行的检测共享相同的容量，因此繁忙的集成可能会影响交互式会话。
- 可以通过余额工具在同一会话中查询余额，这有助于团队在进行大规模运行前确认资金情况。
有关当前计划和余额规则，请参阅 定价页面。
代理工作流的良好用途与合理限额
MCP 适用于小型对话任务：分析师粘贴少量号码，要求助手进行检测，并在同一会话中查看结果。支持工程师可以在处理工单时验证单个联系人。开发人员可以在编写集成代码前测试结果处理逻辑。
请保持合理的数量和范围：
- 对于较大的列表，请使用仪表板或 REST API。MCP 不运行异步批量任务，批量任务是具有独立限额的单独文件上传。
- 要求助手按原样报告结果，包括无法判定结论的号码，而不是用猜测来填补空白。
- 将注册结果视为单一信号。
- 提前决定代理可以自动执行哪些操作。将记录路由至审核队列是合理的示例；发送消息则超出了此集成的功能范围。
保持简短的审核习惯很有帮助：记录检测了哪些号码、由哪个客户端检测以及检测目的，以便日后从账户的检测历史记录中审计支出和结果。
设置清单
- 确认账户有余额，且仪表板中有一个有效的 API 密钥。
- 在您的 MCP 兼容客户端中添加 https://tgvalidator.com/mcp 作为远程服务器。
- 使用客户端的密钥存储功能，将 Authorization 请求头配置为 Bearer 后跟密钥。
- 列出可用工具，并对您控制下的号码运行一次实时检测。
- 在仪表板的检测历史记录中核实支出。
- 记录哪些团队成员可以使用该密钥以及如何轮换密钥。
常见问题解答
MCP 集成是否使用与 API 不同的账户？
不。它使用现有的账户、API 密钥、余额、计费和限额，因此使用情况会与其他检测一同显示。
团队在 MCP 中应使用哪个请求头？
使用 Authorization，其值为 Bearer。REST API 使用 X-API-Key，并使用相同的以 sk_ 为前缀的密钥。
团队可以通过 MCP 运行批量文件任务吗？
不。MCP 仅涵盖实时检测和余额查询工具。批量任务需通过仪表板或批量任务 API 运行。
团队如何处理速率和并发问题？
请遵循当前 API 文档中的并发和超时控制，并设计客户端，以便在无法判定检测结果时进行等待或优雅地重试。
了解更多
选择符合您工作流下一步的产品信息。