Usando a integração MCP do TG Validator com clientes de IA
Conecte um cliente de IA compatível com MCP a verificações em tempo real do TG Validator com autenticação Bearer, saldo compartilhado e os mesmos limites.
Como as equipes podem conectar clientes de IA ao endpoint MCP do TG Validator para verificações de registro no Telegram em tempo real.
A integração MCP do TG Validator permite que um cliente de IA compatível com MCP chame ferramentas de verificação em tempo real e de saldo em https://tgvalidator.com/mcp. Ela é autenticada com um cabeçalho Authorization Bearer usando sua chave de API existente e utiliza a mesma conta, saldo e limites da API REST e do painel de controle. Ela abrange apenas ferramentas em tempo real, portanto, tarefas em lote assíncronas permanecem no painel de controle ou na API REST.
O que a integração MCP do Telegram oferece
MCP, o Model Context Protocol, é um padrão aberto para conectar aplicações de IA a ferramentas e fontes de dados externas (Introdução ao Model Context Protocol). Um servidor publica ferramentas, e o cliente de IA decide quando chamá-las em nome do usuário.
O endpoint MCP oficial do TG Validator é https://tgvalidator.com/mcp, com documentação na página de documentação do MCP. A integração expõe ferramentas de verificação em tempo real e de saldo. É uma superfície de integração para a conta existente, não um sétimo tipo de serviço nem um produto separado. O sinal de registro no Telegram descrito para o serviço de Telegram em tempo real é o que é retornado: se um número E.164 enviado está registrado no Telegram no momento da verificação.
Autenticação: Bearer para MCP, X-API-Key para REST
Os dois pontos de entrada usam cabeçalhos diferentes, e confundi-los é o erro de configuração mais comum.
| Ponto de entrada | Cabeçalho | Credencial |
|---|---|---|
| API REST | X-API-Key | Sua chave de API com prefixo sk_ |
| Endpoint MCP | Authorization: Bearer | A mesma chave de API |
A credencial é idêntica; apenas o cabeçalho muda. Crie ou visualize a chave no painel de controle, armazene-a na configuração de segredos ou de ambiente do seu cliente de IA e nunca cole uma chave real em um prompt, em um arquivo de configuração compartilhado ou em um repositório. Se uma chave puder ter sido exposta, altere-a no painel de controle e atualize cada cliente que a utiliza.
A maioria dos clientes MCP que suportam servidores remotos permite que você adicione uma URL e um cabeçalho personalizado, portanto, a configuração geralmente é uma entrada curta de configuração em vez de código. Verifique a documentação do seu próprio cliente para a sintaxe exata, já que cada cliente nomeia essas opções de forma diferente.
Mesma conta, mesmo saldo, mesmos limites
As chamadas feitas através do MCP não são uma conta paralela. Elas usam o saldo e o faturamento da conta que possui a chave e seguem o mesmo comportamento de concorrência e tempo limite da API REST. A documentação pública da API descreve os controles de concorrência e tempo limite por usuário e não publica um limite de taxa de solicitação por minuto, portanto, consulte a documentação atual da API para obter os detalhes em vez de presumir um número.
Três consequências práticas seguem:
- Cada verificação concluída que chega a uma decisão é cobrada na taxa de serviço aplicável, independentemente de o número estar registrado ou não, portanto, um agente que percorre muitos números consome saldo a cada vez.
- As verificações feitas por um cliente de IA e pelo seu próprio código compartilham a mesma capacidade, portanto, uma integração ocupada pode afetar uma sessão interativa.
- Perguntas sobre o saldo podem ser respondidas a partir da mesma sessão através da ferramenta de saldo, o que ajuda uma equipe a confirmar os fundos antes de uma execução maior.
Para obter as regras atuais de planos e saldo, consulte a página de preços.
Bons usos e limites sensatos para fluxos de trabalho de agentes
O MCP se adapta a tarefas pequenas e conversacionais: um analista cola alguns números, pede ao assistente para verificá-los e revisa as respostas no mesmo tópico. Um engenheiro de suporte pode verificar um único contato enquanto faz a triagem de um ticket. Um desenvolvedor pode testar o tratamento de resultados antes de escrever o código de integração.
Mantenha o volume e o escopo realistas:
- Use o painel de controle ou a API REST para listas maiores. O MCP não executa tarefas em lote assíncronas, que são uploads de arquivos separados com seus próprios limites.
- Peça ao assistente para relatar os resultados conforme retornados, incluindo números onde nenhuma decisão pôde ser tomada, em vez de preencher lacunas com suposições.
- Trate um resultado de registro como um sinal.
- Decida com antecedência quais ações um agente pode tomar automaticamente. Encaminhar um registro para uma fila de revisão é um exemplo razoável; enviar mensagens está fora do que esta integração faz.
Um hábito de revisão rápida ajuda: registre quais números foram verificados, por qual cliente e para qual finalidade, para que os gastos e resultados possam ser auditados posteriormente a partir do histórico de verificações da conta.
Lista de verificação de configuração
- Confirme se a conta possui saldo e uma chave de API ativa no painel de controle.
- Adicione https://tgvalidator.com/mcp como um servidor remoto no seu cliente compatível com MCP.
- Configure o cabeçalho Authorization como Bearer seguido pela chave, usando o armazenamento de segredos do cliente.
- Liste as ferramentas disponíveis e execute uma verificação em tempo real em um número que você controla.
- Verifique o gasto no histórico de verificações do painel de controle.
- Documente quais membros da equipe podem usar a chave e como ela é rotacionada.
Perguntas frequentes
A integração MCP usa uma conta diferente da API?
Não. Ela usa a conta existente, chave de API, saldo, faturamento e limites, portanto, o uso aparece junto com outras verificações.
Qual cabeçalho as equipes devem usar para o MCP?
Authorization com um valor Bearer. A API REST usa X-API-Key com a mesma chave com prefixo sk_.
As equipes podem executar tarefas de arquivo em lote através do MCP?
Não. O MCP abrange ferramentas de verificação em tempo real e de saldo. As tarefas em lote são executadas através do painel de controle ou da API de tarefas em lote.
Como as equipes podem lidar com questões de taxa e concorrência?
Siga os controles de concorrência e tempo limite na documentação atual da API e projete os clientes para aguardar ou tentar novamente de forma elegante quando uma verificação não puder ser decidida.
Saiba mais
Escolha as informações do produto que se ajustam ao próximo passo no seu fluxo de trabalho.