MCP: sua conta operada por um agente
Crie o token, conecte o seu cliente de IA e veja as 19 ferramentas que o agente pode usar.
This video and the complete written tutorial are in Portuguese. · 3:16 · Open video in another tab
The video shows an earlier platform version. The Portuguese text below reflects current rules; check your dashboard for your subscription’s features and conditions.
O MCP é o caminho para um agente de IA usar a sua conta NovoDID: em vez de navegar no painel, ele chama ferramentas — consultar números, ver vencimentos, configurar encaminhamento, pesquisar números à venda e até gerar um pagamento. O que ele pode fazer depende só das permissões do token que você criar.
Antes de começar
- O acesso é por token da API, no cabeçalho Authorization: Bearer. Aplicativos que só aceitam login por OAuth não conectam por esse caminho.
- O endereço do servidor é https://mcp.novodid.com/mcp, com transporte Streamable HTTP.
- Abrir esse endereço no navegador devolve erro 405: ele é um endpoint de protocolo, não uma página.
1. Crie o token
- No painel, abra Desenvolvedores e vá em Tokens.
- Dê um nome que lembre qual agente vai usar.
- Marque as permissões conforme o que o agente precisa, na lista abaixo.
- Clique em Criar token e guarde o valor: ele aparece uma única vez.
O que cada permissão libera:
- dids:read — consultar seus números.
- billing:read — vencimento, ciclo e pagamento.
- forwarding:read — ver o encaminhamento.
- forwarding:write, forwarding:phone e forwarding:delete — alterar e remover encaminhamento.
- sip:create e sip:credentials:read — criar o ramal do número e ler as credenciais.
- calls:read, sms:read e sms:send — chamadas e mensagens.
- catalog:read — pesquisar números à venda e consultar preços.
- orders:create e orders:read — gerar e acompanhar pedidos.
Comece só com leitura. Acrescente permissão quando o agente realmente precisar — é mais fácil ampliar depois do que descobrir que ele podia demais.
2. Conecte o seu cliente
Adicione um servidor MCP remoto com o endereço acima e o cabeçalho de autenticação. Os nomes dos campos mudam conforme o aplicativo; as duas informações são sempre as mesmas: URL e Authorization: Bearer com o seu token.
Num cliente de linha de comando, é uma linha só — no Claude Code, por exemplo, claude mcp add com --transport http, a URL e --header com o token.
Conectado, peça ao agente a lista de ferramentas. Só aparecem as permitidas pelo seu token: um token de leitura mostra bem menos que um token completo. Se faltar alguma, ajuste as permissões e reconecte o cliente.
3. As ferramentas
São 19, e cada uma exige a sua permissão:
Conta e números — get_account, list_dids, get_did.
Encaminhamento e ramal — list_forwardings, get_did_forwarding, set_did_phone_forwarding, set_did_ip_forwarding, set_did_sip_forwarding, create_did_sip_forwarding, delete_did_forwarding, get_did_sip_credentials.
Chamadas e SMS — list_calls, list_sms_messages, send_sms.
Compra — search_available_dids, quote_did_purchase, create_did_checkout, get_did_order, list_did_orders.
A permissão também controla os campos que voltam: sem billing:read, por exemplo, a resposta não traz vencimento nem pagamento. Um token restrito a certos números mantém essa restrição no MCP.
4. Na prática
Peça em português. O agente escolhe as ferramentas e mostra quais usou — é assim que você confere que ele leu a sua conta, em vez de inventar a resposta.
Exemplos de pedido:
- "Liste meus números e seus vencimentos. Não altere nada."
- "Pesquise números fixos do DDD 11 e mostre o preço mensal de um deles antes de gerar qualquer pagamento."
- "O fixo de Brasília está sem encaminhamento? Se estiver, aponte para o meu ramal."
Alterações e compras só acontecem depois da sua confirmação, e as regras da conta continuam valendo: limites, elegibilidade de SMS, saldo para o siga-me e cobrança por minuto.
Sobre compras pelo agente
- Cotar não gera cobrança. O pagamento só nasce quando você confirma.
- Cada pedido contém um número. Uma reserva pendente bloqueia outra compra do mesmo número por até 15 minutos desde a criação do pedido; outros números disponíveis podem ser comprados, respeitando os limites da conta. Uma preparação simultânea pode exigir uma espera breve.
- No Pix, o agente devolve o copia e cola; no cartão, um link para concluir o pagamento.
- Criar o checkout não ativa o número: acompanhe o pedido até o pagamento ser confirmado.
Se algo não funcionar
- Token recusado — confira o cabeçalho Authorization e se o token está ativo.
- Ferramenta não aparece — confira as permissões do token e reconecte o cliente.
- Acesso negado — confira as restrições do token, as condições da conta e a URL.
- Compra em conflito — consulte os pedidos pendentes antes de tentar de novo.
- Limite de chamadas — respeite o tempo de espera informado no erro.
- Erro 405 no navegador — o endereço é de protocolo; configure-o no cliente MCP.
Se precisar tirar o acesso do agente, revogue o token: ele perde o acesso na hora, sem afetar os outros tokens.