Como testar o MCP Server da Nvoip no Postman
OAuth compartilhado e descoberta
O servidor MCP usa https://mcp.nvoip.com.br/mcp e anuncia https://api.nvoip.com.br/auth como servidor OAuth. Use a descoberta do cliente, PKCE e consentimento; no Claude, informe somente a URL, deixe Client ID/Secret vazios e clique em Connect. A audiência e os escopos do MCP são próprios: o token MCP não é um token genérico da API v3. Para integrar a API por backend, consulte o guia v3. Respeite a expiração informada em expires_in.
Este artigo mostra como usar o Postman para validar o MCP Server da Nvoip antes de configurar uma IA ou outro cliente MCP.
Importante: o MCP Server está disponível para clientes no Plano Pro e para revendedores Tier IV, V e VI. Usuários secundários precisam ter a permissão MCP Server habilitada no painel.
1. Quando usar com Postman
Use para verificar URL, autenticação, capacidades e chamadas de ferramenta com mais controle técnico.
2. Antes de começar
| Requisito | Detalhe |
|---|---|
| Plano | Conta no Plano Pro ou revendedor Tier IV, V ou VI. |
| Permissão | Usuário principal Pro pode acessar. Usuários secundários precisam da permissão MCP Server. |
| Cliente MCP | Postman ou ambiente compatível com servidor MCP remoto. |
| Token | Access token OAuth gerado/renovado no painel da Nvoip. |
3. Dados de conexão
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcp.nvoip.com.br/mcp |
| Header de autorização | Authorization: Bearer <access_token> |
| Variável de ambiente, quando aplicável | NVOIP_MCP_BEARER_TOKEN |
| Metadados OAuth | https://api.nvoip.com.br/auth/.well-known/oauth-authorization-server |
| Recurso protegido | https://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp |
4. Passo a passo
- Abra o workspace da Nvoip no Postman ou crie uma requisição MCP no seu workspace.
- Escolha o transporte HTTP/Streamable HTTP quando disponível.
- Informe a URL do MCP Server da Nvoip.
- Na autorização, selecione Bearer Token e informe o access token gerado no painel.
- Carregue as capacidades do servidor para listar ferramentas e métodos disponíveis.
- Execute uma chamada simples, como consultar o perfil MCP da conta autenticada.
5. Perguntas de exemplo
- Carregar ferramentas disponíveis no servidor.
- Executar a ferramenta de perfil MCP para validar o escopo.
- Testar política de acesso e limites da conta.
- Simular um resumo de atendimento da conta autenticada.
6. Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Erro de autenticação | Token expirado, header sem Bearer, espaço extra ou token copiado incorretamente. |
| Ferramentas não aparecem | Salve a configuração e reinicie a conversa ou o cliente MCP. |
| Acesso negado | Plano, permissão do usuário e escopo da conta autenticada. |
| Dados incompletos | Período consultado, canal analisado, histórico disponível 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.
7. Boas práticas de segurança
- Não cole access token, refresh token, napikey ou usertoken em prompts, conversas públicas ou documentos compartilhados.
- Use o token somente no campo seguro de autenticação do cliente MCP.
- Revogue ou substitua o token se ele for exposto.
- Revise periodicamente quais usuários têm permissão para usar o MCP Server.