Códigos SMS para agentes de IA: leia códigos de verificação pelo MCP

Conecte o seu agente

O login é OAuth 2.1 com registro dinâmico de cliente: aponte o cliente para a URL, uma janela do navegador se abre, você confirma com um código enviado ao seu e-mail (ou ao celular da sua conta) e toca em Permitir. Não há client ID nem segredo para colar.

claude mcp add --transport http busysms https://busysms.net/mcp

codex mcp add busysms --url https://busysms.net/mcp

[mcp_servers.busysms]
url = "https://busysms.net/mcp"

No app do Claude, abra Customize → Connectors → + Add → Add custom connector, dê o nome BusySMS e cole https://busysms.net/mcp. Outros clientes MCP, inclusive o Grok, adicionam como servidor HTTP remoto com a mesma URL. Um cliente que não suporta OAuth pode enviar uma chave de API bsk_live_ como token Bearer.

Um fluxo típico de agente

1. 1

   Inicie o login

   O agente preenche o formulário de login ou chama o serviço, e o serviço manda um código por SMS para o seu número.

2. 2

   Espere o código

   Ele chama wait_for_code na hora, passando phone ou sender quando você tem vários números.

3. 3

   Use o código

   Ele digita o código e segue em frente. Se nada chegar, ele não recebe nada e pode tentar de novo ou perguntar a você, em vez de chutar.

Um prompt simples assim funciona com qualquer agente conectado:

Sign in to staging.example.com as +44 7700 900123.
When the site asks for the SMS code, call BusySMS wait_for_code
with phone 447700900123, enter the code, and tell me when you are in.

Vários números, números compartilhados, e quando os códigos não chegam

Com mais de um número na sua conta, ou com um número que um colega compartilhou com você, “o próximo código” é ambíguo. Passe phone com o número que recebe, para não receber um código de outro login em outro número, ou sender com parte do nome do remetente. Números compartilhados funcionam como os seus: depois que você aceita um compartilhamento, as ferramentas de código incluem os códigos novos dele.

Se os códigos não estão chegando de jeito nenhum, peça ao agente para rodar diagnose_my_gateway: ele compara o que está cadastrado, verificado e online e sugere o próximo passo. test_my_gateway vai além e prova o caminho inteiro de ponta a ponta. Deixe o agente perguntar a você antes, porque ele envia um SMS real para o seu número.

Segurança embutida nas ferramentas

• Só os seus celulares. Cada ferramenta fica restrita à sua conta e aos números compartilhados com você. Um agente não consegue ler as mensagens de mais ninguém.
• Nenhum segredo na conversa. create_api_key cria uma chave REST, mas nunca a retorna: você recebe um link de uso único, válido por 15 minutos, que você mesmo abre. O texto de um SMS pode trazer instruções escritas por um estranho, então uma chave de longa duração nunca deve entrar no contexto do agente.
• Mudanças exigem uma sessão logada. Ferramentas que mudam coisas, como testar o seu gateway, compartilhar um número ou revogar uma chave, não podem ser usadas com uma chave de API.
• Mensagens só para você. send_sms_to_me e send_email_to_me não têm argumento de destinatário; elas só chegam ao número e ao endereço da sua própria conta.

O que o agente precisa do seu lado

• Um celular com o chip: Android com o app BusySMS, ou um iPhone com uma automação do Atalhos.
• O número verificado no BusySMS.
• Um teste ou uma assinatura ativos. Sem isso, as ferramentas que leem códigos retornam um erro de cobrança, enquanto list_devices continua funcionando para o agente poder explicar o motivo.

Ainda não tem conta?

As ferramentas públicas respondem a perguntas sobre o produto sem login (preços, passos de configuração, requisitos do aparelho, solução de problemas), então um assistente consegue explicar com precisão o que o BusySMS faz antes de você criar a conta. Ler códigos exige uma conta: $5 por número verificado ao mês depois de 7 dias grátis.

Dúvidas

Perguntas frequentes