Uso de la integración MCP de TG Validator con clientes de IA
Conecte un cliente de IA compatible con MCP a las verificaciones en tiempo real de TG Validator mediante autenticación Bearer, saldo compartido y límites de cuenta.
Cómo pueden los equipos conectar clientes de IA al endpoint MCP de TG Validator para realizar verificaciones de registro en Telegram en tiempo real.
La integración MCP de TG Validator permite que un cliente de IA compatible con MCP llame a herramientas de verificación en tiempo real y de consulta de saldo en https://tgvalidator.com/mcp. Se autentica con un encabezado Authorization: Bearer utilizando su clave de API existente y utiliza la misma cuenta, saldo y límites que la API REST y el panel de control. Solo cubre herramientas en tiempo real, por lo que las tareas masivas asíncronas permanecen en el panel de control o en la API REST.
Qué ofrece la integración MCP de Telegram
MCP, el Model Context Protocol, es un estándar abierto para conectar aplicaciones de IA a herramientas externas y fuentes de datos (Introducción al Model Context Protocol). Un servidor publica herramientas y el cliente de IA decide cuándo llamarlas en nombre del usuario.
El endpoint oficial de MCP de TG Validator es https://tgvalidator.com/mcp, con documentación en la página de documentos de MCP. La integración expone herramientas de verificación en tiempo real y de saldo. Es una superficie de integración para la cuenta existente, no un séptimo tipo de servicio ni un producto independiente. Lo que se devuelve es la misma señal de registro en Telegram descrita para el servicio de Telegram en tiempo real: si un número E.164 enviado está registrado en Telegram en el momento de la verificación.
Autenticación: Bearer para MCP, X-API-Key para REST
Los dos puntos de entrada utilizan encabezados diferentes, y confundirlos es el error de configuración más común.
| Punto de entrada | Encabezado | Credencial |
|---|---|---|
| API REST | X-API-Key | Su clave de API con prefijo sk_ |
| Endpoint MCP | Authorization: Bearer | La misma clave de API |
La credencial es idéntica; solo cambia el encabezado. Cree o vea la clave en el panel de control, guárdela en la configuración de secretos o de entorno de su cliente de IA y nunca pegue una clave real en un prompt, un archivo de configuración compartido o un repositorio. Si una clave puede haber quedado expuesta, rótela en el panel de control y actualice cada cliente que la utilice.
La mayoría de los clientes MCP que admiten servidores remotos le permiten agregar una URL y un encabezado personalizado, por lo que la configuración suele ser una breve entrada de configuración en lugar de código. Consulte la documentación de su propio cliente para conocer la sintaxis exacta, ya que cada cliente nombra estas opciones de manera diferente.
Misma cuenta, mismo saldo, mismos límites
Las llamadas realizadas a través de MCP no corresponden a una cuenta paralela. Utilizan el saldo y la facturación de la cuenta propietaria de la clave, y siguen el mismo comportamiento de concurrencia y tiempo de espera que la API REST. La documentación pública de la API describe los controles de concurrencia y tiempo de espera por usuario y no publica un límite de tasa de solicitudes por minuto, por lo que debe consultar la documentación actual de la API para obtener los detalles en lugar de asumir una cifra.
Se derivan tres consecuencias prácticas:
- Cada verificación completada que llega a una decisión se cobra a la tarifa de servicio aplicable, independientemente de si el número está registrado o no, por lo que un agente que recorre muchos números consume saldo cada vez.
- Las verificaciones realizadas por un cliente de IA y por su propio código comparten la misma capacidad, por lo que una integración con mucha carga puede afectar a una sesión interactiva.
- Las consultas de saldo pueden responderse desde la misma sesión a través de la herramienta de saldo, lo que ayuda a un equipo a confirmar los fondos antes de una ejecución mayor.
Para conocer las reglas actuales de planes y saldos, consulte la página de precios.
Buenos usos y límites sensatos para flujos de trabajo de agentes
MCP se adapta a tareas pequeñas y conversacionales: un analista pega un puñado de números, pide al asistente que los verifique y revisa las respuestas en el mismo hilo. Un ingeniero de soporte puede verificar un solo contacto mientras clasifica un ticket. Un desarrollador puede probar el manejo de resultados antes de escribir código de integración.
Mantenga el volumen y el alcance realistas:
- Utilice el panel de control o la API REST para listas más grandes. MCP no ejecuta tareas masivas asíncronas, las cuales son cargas de archivos separadas con sus propios límites.
- Pida al asistente que informe los resultados tal como se devuelven, incluidos los números donde no se pudo tomar una decisión, en lugar de completar los vacíos con suposiciones.
- Trate un resultado de registro como una señal única.
- Decida de antemano qué acciones puede tomar un agente automáticamente. Enviar un registro a una cola de revisión es un ejemplo razonable; enviar mensajes está fuera de lo que hace esta integración.
Un hábito de revisión breve ayuda: registre qué números se verificaron, qué cliente los verificó y con qué propósito, para que el gasto y los resultados puedan auditarse más tarde desde el historial de verificaciones de la cuenta.
Lista de verificación de configuración
- Confirme que la cuenta tiene saldo y una clave de API activa en el panel de control.
- Agregue https://tgvalidator.com/mcp como servidor remoto en su cliente compatible con MCP.
- Configure el encabezado Authorization como Bearer seguido de la clave, utilizando el almacenamiento de secretos del cliente.
- Enumere las herramientas disponibles y ejecute una verificación en tiempo real en un número que usted controle.
- Verifique el gasto en el historial de verificaciones del panel de control.
- Documente qué miembros del equipo pueden usar la clave y cómo se rota.
Preguntas frecuentes
¿La integración MCP utiliza una cuenta diferente a la de la API?
No. Utiliza la cuenta, la clave de API, el saldo, la facturación y los límites existentes, por lo que el uso aparece junto con otras verificaciones.
¿Qué encabezado deben usar los equipos para MCP?
Authorization con un valor Bearer. La API REST utiliza X-API-Key con la misma clave con prefijo sk_.
¿Pueden los equipos ejecutar tareas de archivos masivos a través de MCP?
No. MCP cubre herramientas de verificación en tiempo real y de saldo. Las tareas masivas se ejecutan a través del panel de control o la API de tareas masivas.
¿Cómo pueden los equipos manejar las preguntas sobre tasa y concurrencia?
Siga los controles de concurrencia y tiempo de espera en la documentación actual de la API y diseñe los clientes para que esperen o vuelvan a intentar la operación de forma elegante cuando no se pueda decidir una verificación.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.