Ir para o conteúdo
NovoDIDNovoDIDdocumentação
Integrações prontas

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

  1. Use Node.js 24 ou superior e instale @modelcontextprotocol/[email protected] no diretório do exemplo.
  2. Crie um token com dids:read. Acrescente billing:read somente para vencimentos/pagamentos e forwarding:read somente para destinos.
  3. Configure NOVODID_API_TOKEN em um cofre ou arquivo privado de ambiente. Não salve o valor em repositório, URL ou prompt compartilhado.
  4. Execute o arquivo. O servidor é https://mcp.novodid.com/mcp, com Streamable HTTP e Authorization: Bearer.
  5. 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.

Nesta página