MCP: agente de consulta com permissões mínimas
Receitas para começar com permissões mínimas e exemplos que você pode baixar. Os arquivos não contêm credenciais e não executam compras ou envios de SMS. Configure seus próprios segredos no ambiente privado da integração.
Baixe o cliente Node.js somente leitura. Ele descobre as ferramentas permitidas e chama list_dids, sem comprar, alterar encaminhamento ou enviar SMS.
Preparar
- Use Node.js 24 ou superior e instale @modelcontextprotocol/[email protected] no diretório do exemplo.
- Crie um token com dids:read. Acrescente billing:read somente para vencimentos/pagamentos e forwarding:read somente para destinos.
- Configure NOVODID_API_TOKEN em um cofre ou arquivo privado de ambiente. Não salve o valor em repositório, URL ou prompt compartilhado.
- Execute o arquivo. O servidor é https://mcp.novodid.com/mcp, com Streamable HTTP e Authorization: Bearer.
- Para outro cliente, configure o mesmo endereço e cabeçalho. Clientes que só aceitam OAuth não conectam por esse caminho.
Instrução para seu agente
“Consulte meus números e os campos permitidos pelo token. Não altere nada, não gere pagamento e não envie SMS. Informe quais ferramentas usou. Se o acesso for recusado, explique o erro sem revelar credenciais.”
A lista de ferramentas depende dos escopos; tokens antigos não recebem permissões novas automaticamente. Reconecte depois de ajustar o token. Um erro 405 ao abrir o endpoint no navegador não é uma página fora do ar: configure-o no cliente MCP.
Se ampliar a automação
Separe leitura e escrita em tokens diferentes. Antes de comprar, apresente a cotação e obtenha consentimento explícito; use a mesma idempotencyKey e os mesmos dados após um resultado incerto. Cada pedido contém um número. Envio de SMS não tem contrato de idempotência e não deve ser repetido automaticamente. Siga-me consome saldo por minuto. As regras da conta e da posse continuam valendo. Veja o guia MCP e o diagnóstico.
Webhooks: recebedor seguro em Node.js
Receitas para começar com permissões mínimas e exemplos que você pode baixar. Os arquivos não contêm credenciais e não executam compras ou envios de SMS. Configure seus próprios segredos no ambiente privado da integração.
Perguntas frequentes e diagnóstico
Confira as situações mais comuns e encontre o próximo passo sem alterar sua conta.

