O Postman é útil para validar um servidor MCP antes de liberar o uso em agentes de IA. Ele permite criar requisições MCP, carregar capacidades e testar ferramentas com autenticação.

Ideal para desenvolvedores, suporte técnico e parceiros que precisam validar se URL, OAuth, token e ferramentas estão funcionando antes de configurar outro cliente.

Antes de conectar

  • A conta precisa estar habilitada para o MCP Server da Nvoip.
  • Clientes finais precisam do Plano Pro. Revendedores precisam estar nos Tiers IV, V ou VI.
  • Usuários secundários precisam da permissão MCP Server habilitada pelo administrador.
  • O acesso usa OAuth ou bearer token gerado pelo painel/API da Nvoip.
  • As respostas respeitam escopo da conta, permissões e limites de uso.

Dados de conexão da Nvoip

Servidor MCPhttps://mcp.nvoip.com.br/mcp
AutenticaçãoAuthorization: Bearer <access_token>
Metadados OAuthhttps://api.nvoip.com.br/v2/.well-known/oauth-authorization-server
Recurso protegidohttps://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp

Abrir collection no Postman

Use o botão abaixo para criar um fork público da collection oficial do MCP Server da Nvoip no seu workspace do Postman. Preencha o token de acesso como variável secreta antes de executar chamadas.

Passo a passo para Postman

  1. Abra o workspace da Nvoip no Postman ou crie uma requisição MCP em seu workspace.
  2. Escolha o transporte HTTP ou Streamable HTTP.
  3. Informe a URL https://mcp.nvoip.com.br/mcp.
  4. Na aba Authorization, selecione Bearer Token e informe o access token gerado no painel Nvoip.
  5. Clique em Load Capabilities para listar ferramentas, recursos e métodos disponíveis.
  6. Execute uma chamada simples, como get_my_profile, e valide o retorno.

Perguntas que você pode fazer

  • Carregar ferramentas disponíveis no servidor.
  • Executar get_my_profile para validar o escopo.
  • Testar get_mcp_access_policy para conferir plano e limites.
  • Simular uma chamada get_customer_summary com a conta autenticada.

Erros comuns

  • Erro de autenticação: gere um novo token e confira se o header começa com Bearer.
  • Ferramentas não aparecem: salve a configuração e reinicie a conversa ou o cliente MCP.
  • Acesso negado: confirme plano, permissão do usuário e escopo da conta.
  • Dados diferentes do esperado: confira período consultado, canal analisado e limites aplicáveis.

Atenção: No Postman, salve tokens como variáveis secretas de ambiente. Não publique environments com access token, refresh token, napikey ou usertoken preenchidos.

Não cole access token, refresh token, napikey ou usertoken em prompts, conversas públicas ou documentos compartilhados. Use esses dados apenas nos campos seguros de autenticação do cliente MCP.

Links úteis